WawiLib: the New Tool to Read and Write Arduino Variables.

WawiLib (Watch Window Library) is a concept that will make you much more effective in developing and testing Arduino software. It consists of a program you run on your PC and 3 Arduino libraries.

The upper part of WawiLib-PC contains a table where you enter the name of the variable you want to investigate or change. The column "Actual value" displays the actual value. You can enter a new target value for the variable in the column "Write value". "Write all" triggers the write job to your board. (WawiLib can also be configured so that the "Enter key" in the "Write value field" triggers a write operation to your board.)

WawiLib works with USB, Serial, Softserial, Ethernet-UDP, Ethernet-TCP, WiFi-UDP, WiFi-TCP and with many Arduino boards (Uno, Mega2560, DUE, MKR1000, MKR1010, ESP8266, and many more, for more info: wwww.SylvesterSolutions.com.)

WawiLib supports all types of variables char, int, double etc. Arrays of these variables are also supported. Values can be represented as INT, UINT, HEX, CHAR, DOUBLE, FLOAT and STRING. The movie shows an impression of a few possibilities. The objective of this Instructable is how to get you going with the tool on your PC.

• PC with Arduino IDE installed.
• Arduino board (Arduino Uno in this example).
• A programming cable to connect your PC with your Arduino board.

• Visit https://sylvestersolutions.com/wawilib-download/
• Press "Free Download".
• Press the button "Download 32 bit" or "Download 64 bit" depending on your version of Windows-10.

(WawiLib was developed under Windows 7 & 10 and fully tested under 10, if you doubt about compatibility of other versions of Windows: download the free version and try it!)

• If your PC shows "Windows protected your PC": press "more info" & "run anyway". (*)
• The following screens appear:
  
  • "Welcome to the WawiLib PC Setup Wizzard": press "Next"
  • "Select installations folder": select "Next"
  • "Confirm Installation": select "Next"
  • "License Agreement": select I Agree (if you agree) and press "Next"
  • "User Account control": select "I Agree". (*)
  • "Installation complete": select "Close"

(*) Note: SylvesterSolutions has a code signing certificate to sign software digitally issued by globalsign. Therefore it is a bit strange that Windows shows a warning "Windows protected your PC". We are investigating the source of this message.

• Start WawiLib.
• Go to the menu "Settings\Preference and License...".
• Select the tab "Arduino Lib Location": There you will see the location of the zipped WawiLib libraries.

• Fill in the location of the libraries identified in the previous step.
• Select WawiSerialUsb.zip as the library to be installed.

Note: To re-install the library, you need to manually remove the previous version, see "Getting started using the Arduino Usb programming port" on sylvestersolutions.com for more details.

In the Arduino IDE:

• Open "File\Examples\WawiSerialUsb\WawiBlinkUsb".
• Compile and download the sketch.

Note: For boards where the LED I/O is not located at IO13 or where Serial communication is different from UNO and MEGA, there are similar examples available in the list.

• Start WawiLib-PC.
• Open the menu "Settings\Communication interfaces...".
• Check all serial ports. (or if you know the right one, the one used by your board)
• Select the settings as indicated in the picture above.
• Press ADD.
• Press Start Scan.
• Right click on the list with settings and execute "Remove inactive" to remove invalid communication links.
• Close the window.

• Press "Setup()" in the main toolbar of WawiLib.
• Enable "Display .print() messages" by clicking the right mouse button from within the output window.

• Add the variable delayOn in the "Variable name" column.
• WawiLib should show the actual values of the delayOn, delayOff and blinkCounter.

Note: there is a part of the sketch that shows how to capture .print() messages in the Setup() section of your sketch. Therefore the sketch waits (timeout = 30 seconds) in Setup() for Wawilib to connect.

After connecting, the Sketch shows a countdown messages during 15 seconds.

After the countdown, the sketch starts executing the Loop() function.

You can delete the following lines if you do not want to capture .print() in setup or if you dislike the delay:

 WawiSrv.awaitPcConnect(30 * 1000);  <br>    for (int i = 15; i > 0; i--)
    {
        WawiSrv.print("WawiSrv.Print() demo in setup(), counting down: ");
        WawiSrv.println(i);
        WawiSrv.delay(1000);
    }

• Fill a new target value for delayOn, in the "Write value" column.
• Press "Write All" to write the new value in delayOn.

Note: To enable "AutoWrite" = "Enter key" after write in "Write variable column" triggers write.

• go to "Settings\preference and license..."
• select "Layout" tab.
• check "Enter" key in "Write value" field triggers write of single variable.

For more info: WawiLib detailed documentation.

Note: the free version of WawiLib is limited to 1 variable at the same time,

Additional functions and capabilities are unlocked by:

• Go to "Settings/Preferences and license".
• Press "Create request code".
• Press "Copy request code".

go to https://sylvestersolutions.com/wawilib-download/

• Press "Buy license" ...
• Fill in the fields on the form and enter the license request code.
• If all goes well you will receive a license within 48 hours. (If not, you get a full refund + a license for free)

Note: if you purchase a license before 31/02/2021 and if you publish your project on Instructables.com with a clear and visible reference to the use of WawiLib, you will get a full refund of your license! (Send proof to the mail channels you find on www.sylvestersolutions.com.)

Good luck and have fun....