Go Down

Topic: Messenger library (Read 62270 times) previous topic - next topic


Messenger is a new library for Arduino. It is a "toolkit" that facilitates the processing of ASCII messages. Messenger processes characters until it receives a carriage return (CR). It then considers the message complete and available. The message is split into many elements as defined by a separator. The default separator is the space character, but can be any character other than NULL, LF or CR.

Messenger is the new SimpleMessageSystem. SimpleMessageSystem was nice, but not simple enough, so I wanted to switch to Firmata, but when I found out Firmata took at least half of my atmega168's memory, I went back to the drawing board and designed Messenger.

Please note that Messenger only provides methods for incoming messages. The internal Serial.print() functions work just fine for outgoing messages.

You can find Messenger here.
Thomas Ouellet Fredericks


Hey, thanks!

Can't wait to take it out for spin...


This will be very useful!  I would love to use this with my new ethernet shield to parse caller ID messages and perhaps scrape web pages but, unfortunately, it doesn't support strings yet.

I would take this on myself but efficient string handling requires more C expertise than I have!

Any hope that string support will be added to the messenger library anytime soon?


The problem with strings is that they use up a big chunk of memory (1 byte per letter).

I could probably add  string support. Something like:
compareString(String) that would return a true or false.
If the result is false, it stays in the buffer, if the result is true, it would pass to the next element of the message.

p.s.: I am not sure I posted the link before, but Messenger can be found here: http://www.arduino.cc/playground/Code/Messenger
Thomas Ouellet Fredericks


Yes, strings are memory hogs and are not easily handled in the Arduino environment.  But something like Messenger could sure open a lot of interfacing possibilities!

I'd love to see support that allowed me to pick a string out of a sequence by position perhaps like:

returns the element at the index as a string (defined by the message separator).

Thanks for all you work on this so far!



Is it possible to use this library also on Serial1, Serial2 etc. available on the Arduino Mega? (This would be great)

Thank you


Is it possible to use this library also on Serial1, Serial2 etc.

Yes. You simply feed byte process(int serialData) with the serial data of the port you wish to parse. Please note that will also need one instance of the Messenger class for every port.
Thomas Ouellet Fredericks


Thank you for indicating what needs to be done - I will answer back if this worked for me


I see what you mean - this was really not a too clever question of mine...

Thank you for providing this very useful library!



Could you develop the advantage of your solution compared with the bitlash one ?
Bitlash runs on 168 and allows one to dial with serial term as easily as :

i=3; while i<=8: pinMode(i,1); digitalWrite(i,1); i++

It allows the macro too.



Could you develop the advantage of your solution compared with the bitlash one ?

Well it is not a shoving match against messenger and bitlash that's for sure! If you read the start of the thread, you will see I was looking for a [glow]light weight[/glow] communication solution. Bitlash is not lightweight (takes up almost all the memory on a tamega168) and is not a simple communication protocol but a complete shell. Messenger is lightweight and very simple to implement.

Thomas Ouellet Fredericks


Two string handling functions have been added to Messenger. Check them out here:
Thomas Ouellet Fredericks



Excellent library I must say. Thanks for it. I am having some troubles trying to use Serial1 on the Arduino Mega. I basically took the example that is provided and changed Serial to Serial1. Can anyone take a look at my code below and help me please?

Code: [Select]
#include <Messenger.h>
// Instantiate Messenger object with the default separator (the space character)
Messenger message = Messenger();

// Create the callback function
void messageReady() {
   int pin = 10;
      // Loop through all the available elements of the message
      while ( message.available() ) {
     // Set the pin as determined by the message
        digitalWrite( pin, message.readInt() );

void setup() {
 // Initiate Serial Communication
 // Attach the callback function to the Messenger

void loop() {
 // The following line is the most effective way of using Serial and Messenger's callback
 while ( Serial1.available() )  message.process(Serial1.read () );


I can only help you if you describe what are the troubles you are experiencing.
Thomas Ouellet Fredericks

Go Up