Extended Serial Monitor 1.1

Table of content
1. What is Extended Serial Monitor?
2. How to register?
3. How to install it?
4. How to uninstall it?
5. How to use it?
6. Where to find the latest version?
7. How to contact us?

1. What is Extended Serial Monitor?
You want to use a Serial Monitor better than the one included in Mac OS or in your MCU (Arduino, Teensy, Raspberry, Beaglebone, ...) development environment? You want to be able to send and receive messages? You want to log debug messages or any kind of text? You want to follow the value of variables? You want to plot variables, functions, curves? You even want to draw geometrical shapes?
Then Extended Serial Monitor is what you need!

Extended Serial Monitor allows you to extend the capacities of your Arduino or Raspberry default Serial Monitor.
- You can send and receive messages to and from your MCU (Arduino, Teensy, Raspberry, Beaglebone, ...).
- You can log debug messages or any kind of text.
- You can monitor variables values.
- You can plot functions or draw any kind of pictures.
- It doesn't need any installation which makes it very easy to use.
- It is available in English (and soon in other languages).
Read the whole documentation for more details...

Version 1.1:
- A pop-up menu to select a detected serial port has been added.
- Erasing of all the windows when opening the serial port has been added.
- The "How to intall it?" paragraph of the documentation has been updated to explain how to install and launch the Application in particular under Mac OS 10.13 High Sierra:
Under Mac OS 10.13 High Sierra, if you're launching the Application for the first time, Mac OS' GateKeeper (which you can configure in the "System Preferences") will refuse to launch it because you've not downloaded it from the Mac App Store (but from our website). In this case, instead of double-clicking on it, all you have to do is to right-click on the Application's icon, and then select the "Open" menu. A message will appear in which you'll be able to confirm that you want to launch the Application (even if it was not downloaded from the Mac App Store from an Identified Developper).

Version 1.0:
- The first release.

2. How to register?
As long as you use it unregistered this Application works normally, but it has a time limit and annoying windows (Registration window, Popup windows, ...).
To register it you just have to purchase a registration code on our website.
We accept Australian Dollar, Brazilian Real, Canadian Dollar, Czech Koruna, Danish Krone, Euro, Hong Kong Dollar, Hungarian Forint, Israeli New Sheqel, Japanese Yen, Malaysian Ringgit, Mexican Peso, Polish Zloty, Pound Sterling, Russian Ruble, Singapore Dollar, Swedish Krona, Swiss Franc, Taiwan New Dollar, Thai Baht, Turkish Lira, US Dollar and many other currencies...
To see our prices or to have a look at our many other Applications, just go to our website now.
This will help and encourage us to continue developing useful and friendly software for your pleasure and service.
Remember that when you register for a particular Application, your registration code remains valid for all the following minor releases.
Remember to read the Conditions of Use, Publication and Distribution before installing and using our Applications.

3. How to install it?
No particular installation is required. Once you've downloaded the ".dmg" package from our website, it should uncompress automatically (in your "Downloads" folder or on your Desktop). If it does not, then you can double-click on it to uncompress it.
Then you just have to move the created folder into your "Applications" folder (or any other location) and double-click on the Application to launch it.

Installation of the "ExtendedSerialMonitor" Library in the Arduino development environment:
To install the Library in the Arduino development environment, you just have to copy/paste the "ExtendedSerialMonitor" folder (contained in the "Arduino Library" folder) into your "Documents/Arduino" folder (where your other self-imported libraries are).
Then, relaunch the Arduino Application, and the "ExtendedSerialMonitor" Library should appear (with its examples) in the "File/Sketchbook/Libraries" menu, in the "File/Examples" menu, and in the "Sketch/Include Library" menu.

Particular case of Mac OS 10.13 High Sierra:

Under Mac OS 10.13 High Sierra, if you're launching the Application for the first time, Mac OS' GateKeeper (which you can configure in the "System Preferences") will refuse to launch it because you've not downloaded it from the Mac App Store (but from our website). In this case, instead of double-clicking on it, all you have to do is to right-click on the Application's icon, and then select the "Open" menu. A message will appear in which you'll be able to confirm that you want to launch the Application (even if it was not downloaded from the Mac App Store from an Identified Developper).

NB: We're not distributing our Applications through the Mac App Store, because Apple's fees policy on the Mac App Store is not financially respectful of developers and small and medium companies, and consequently, at the end, of customers.

4. How to uninstall it?
There should be no reason to do this. ;-)
However, if you really want, then you just have to throw the Application into the trash, and that's all.

5. How to use it?
The "Name" edit field:
It allows you to enter the name of the serial port.

The "Speed" edit field:
It allows you to enter the speed (in bauds) of the serial port.

The "Open" button:
It allows you to open the serial port (for sending and receiving data).

The "Close" button:
It allows you to close the serial port.

The "Send" button:
It allows you to send a message.

The "ExtendedSerialMonitor" Library in the Arduino development environment:
Once you've installed the Library, you can include it in your Sketch with the "#include <ExtendedSerialMonitor.h>" instruction.
Here is the content of this Header file which lists the functions available in the Library, which are quite self-explanatory:

//----------------------------------//
// ExtendedSerialMonitor.h          //
// Library to send and receive data //
// via the serial link to and from  //
// AlphaOmega Software's            //
// Extended Serial Monitor          //
// (www.alphaomega-software.com)    //
//----------------------------------//

#ifndef ExtendedSerialMonitor_h
#define ExtendedSerialMonitor_h

#include "Arduino.h"

void ESMBeginConnection(unsigned long speed);
void ESMEndConnection();
String ESMReadMessage();
void ESMPrintText(String text);
void ESMPrintVariable(String variable, String value);
void ESMDrawPoint(int x, int y, byte red, byte green, byte blue);
void ESMDrawLine(int x1, int y1, int x2, int y2, byte red, byte green, byte blue);
void ESMDrawRectangle(int x1, int y1, int x2, int y2, byte red, byte green, byte blue);
void ESMDrawBlock(int x1, int y1, int x2, int y2, byte red, byte green, byte blue);
void ESMDrawCircle(int x, int y, int radius, byte red, byte green, byte blue);
void ESMDrawDisk(int x, int y, int radius, byte red, byte green, byte blue);
void ESMDrawString(int x, int y, String text, byte red, byte green, byte blue);

#endif

And remember that the Library is provided with some examples of how to use it.

6. Where to find the latest version?
To find the latest version of this Application and many other software "AlphaOmega Software" has written, you just have to visit our website.

7. How to contact us?
You can go to our website to send us an email.


AlphaOmega Software
www.alphaomega-software.com