Loading...
Wiki 2017-12-07T17:57:47+00:00

Getting Started

This section explains how to connect your Fluo boards to the computer and upload your first sketch.

The FLUO WI-FI is programmed using the Arduino IDE Fluo Edition, it is a classic Arduino IDE plus support for Fluo Technology Boards and Fluo exclusive Libraries, that allows to program the board through to Over The Air upgrade sketch (or in the old friendly way using USB cable).

The common use of the Fluo WiFi is to program the ATmega644p and use the  FluoTube to communicate to ESP32, but we provide the same possibility to program and upgrade the ESP32 with the same IDE.

Before you can move on, you must have installed the Arduino IDE Fluo Ed. on your PC, as explained in Wiki Section.

Connect your Fluo WI-FI board with an micro USB cable; sometimes this cable is a common cable that you use for smartphone and common modern USB devices.

The USB connection with the PC is necessary to program the board and not just to power it up. The Fluo WI-FI automatically draw power from either the USB or an external power supply. Connect the board to your computer using the USB cable. The green power LED (labelled ON) should go on.

Open your first sketch

Open the LED blink example sketch: File > Examples >01.Basics > Blink.

Select your board type and port

You’ll need to select the entry in the Tools > Board menu that corresponds to your Fluo Technology Board.

Select the serial device of the board from the Tools > Port menu.

For Windows: this is likely to be COM3 or higher.

For Linux: this is likely to be /dev/ACM0 or higher (ACM0 and ACM1 are usually reserved for hardware serial ports).

For Mac: this is likely to be /dev/cu.usbmodemFAXXXXX .
In general, you can see always the name (FLUO WI-FI(AVR)) because it link with USB product and vendor ID.

To find out, you can disconnect your board and re-open the menu; the entry that appears should be the Fluo Technology Board. Reconnect the board and select that serial port.

Select Channel -> USB mode
USB mode channel is default channel to program the board. Exist another mode but only recovery mode via WiFi.

Upload the program via cable

Now, simply click the “Upload” button in the environment. Wait a few seconds – you should see the RX and TX leds on the board flashing. If the upload is successful, the message “Done uploading.” will appear in the status bar.

A few seconds after the upload finishes, you should see the pin 13 – LED on the board start to blink (in orange). If it does, congratulations! You’ve gotten Fluo WI-FI board up-and-running.

#If you have problems, please see the Troubleshooting Section.

Arduino IDE FLUO Edition

The Open Source Arduino Software (IDE) makes it easy to write code and upload it to your FLUO. The IDE is compatible with Windows, macOS, and Linux. The programming environment is written in Java and it’s based on Processing and other other Open Source software. In this special edition we added support for FLUO Technology Boards. Considering the particular nature of our boards, at the moment we are not  able to use the classic Arduino Board Manager, therefore we provide you with the classic Arduino IDE distributed by Arduino with added support for FLUO boards.

Downloads

Make sure you download the right IDE for your operating system:

Terms of Use

BY DOWNLOADING THIS SOFTWARE YOU AGREE TO THE FOLLOWING TERMS AND CONDITIONS: THE ARDUINO IDE FLUO EDITION SOFTWARE IS PROVIDED TO YOU “AS IS” AND WE MAKE NO EXPRESS OR IMPLIED WARRANTIES WHATSOEVER WITH RESPECT TO ITS FUNCTIONALITY, OPERABILITY, OR USE, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR INFRINGEMENT. WE EXPRESSLY DISCLAIM ANY LIABILITY WHATSOEVER FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR SPECIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST REVENUES, LOST PROFITS, LOSSES RESULTING FROM BUSINESS INTERRUPTION OR LOSS OF DATA,REGARDLESS OF THE FORM OF ACTION OR LEGAL THEORY UNDER WHICH THE LIABILITY MAY BE ASSERTED, EVEN IF ADVISED OF THE POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
THIS SOFTWARE IT IS DISTRIBUTED BY ARDUINO UNDER A GNU GPL v2 LICENSE: https://github.com/arduino/Arduino/blob/master/license.txt
ADDITIONAL INFORMATION AND SOURCE CODE CAN BE FOUND HERE: https://github.com/arduino/Arduino

Install the Arduino Desktop IDE
To get step-by-step instructions select one of the following link accordingly to your operating system.

Windows
Mac OS X
Linux

Choose your board in the list here on the right to learn how to get started with it and how to use it on the Desktop IDE.

MAC OS

Get the latest version from the download section. The file is in Zip format; if you use Safari it will be automatically expanded. If you use a different browser you may need to extract it manually.

Extract It and copy the ArduinoFluoEd application into the Applications folder (or elsewhere on your computer).

WINDOWS

Then download the Bonjour Print Services for Windows v2.0.2 https://support.apple.com/kb/DL999?locale=en_US

Install Bonjour Print Services for Windows v2.0.2

Get the latest version from the download section.Unzip the file (with winRAR / WinZip)
Go into the directory and launch ArduinoFluoEd.exe

If you have previous Windows 10 version, you need to install Driver for Fluo Boards, you can follow this common guide: link

You use FluoWiFi.inf file for new driver, it is located on directory /Driver (into Arduino IDE Fluo Ed path).

LINUX

This guide is valid for Debian derivate distro.
Open your Terminal and launch these commands:
1. Install Vim editor :

$ sudo apt-get install vim

2. Create the file 90-extraacl.rules file in the /etc/udev/rules.d folder :

$ sudo vim /etc/udev/rules.d/90-extraacl.rules

3. And paste into it the following lines :

KERNEL=”ttyUSB[0-9]*”, TAG+=”udev-acl”, TAG+=”uaccess”, OWNER=””
KERNEL=”ttyACM[0-9]*”, TAG+=”udev-acl”, TAG+=”uaccess”, OWNER=””

this will allow the generic system user the use of the serial ports on the OS. Just replace
with your Linux username and then you’re done.

4. Grant yourself the permissions to the tty and dialout groups with:
$ sudo usermod -a -G tty
$ sudo usermod -a -G dialout

5. If installed, remove from your system the ModemManager program. If
you’re running a Debian-based linux distro, the typical command to run from shell is :
$ sudo apt-get remove modemmanager

6. Reload the udev rules with:
$ sudo udevadm control –reload-rules
$ sudo udevadm trigger
Now you should be able to properly build and upload a sketch to your board. If not working,
please reboot your system to complete the setup.

7. If you don’t have Java JDK, you must install this with this command:
$ apt-get install default-jdk

8. If you don’t have PySerial that it is a python module you must install pip
installer for python with this command:
$ apt-get install python-pip

9. Then you can install pySerial module for python:
$ pip install pySerial

Get the latest version from the download page.
You can choose between the 32, 64 and ARM versions. It is very important that you choose the right version for your Linux distro.

Please save it on your computer.
The file is compressed and you have to extract it in a suitable folder, remembering that it will be executed from there.

Now, you can execute ArduinoFluoEd directly from directory decompressed.

FLUO Pinout

WiFi Smartconfig

It allows you to configure the Wi-Fi of your FLUO Board effortlessly. Simply add these few lines of code.

All examples on Arduino IDE Fluo Ed. support this function, if you use different board you can use the same code without compile error but the function is not available.

Here is a complete example explaining all of the features featured by the FluoTube for WiFi connection:

 

 

Here it is code explanation:
#include
To include the FluoTube libraries, this is at the base of your Fluo WI-FI functionality
void setupWiFi()
In a very intuitive way, you can configure the WiFi connection through the macros that you see below.
SET_Hostname(“FluoWiFi”); // set hostname your of board
SET_WiFi(“ssid”, “password”); // put all WiFi Station, Fluo select the best, you can add different entry if you have more Wifi
Access Point available.
SET_APEnable(); // Enable Fluo WI-FI AP mode + Station (to connect to your private WiFi network)
ET_APDisable(); //You This if you want disable Fluo WI-FI AP mode (only Station mode)
FluoTube();
It must be insert inside the Setup(), to initialize the FluoTube library.
FluoTube(dbgON); // in this way the Fluotube use Serial() to print the debug messages
FluoTube(dbgOFF); // in this way the Fluotube use Serial() can’t print the debug messages, use this if you want use Serial() pins for others purposes.

If your board is connected with WiFi network you can see LINK LED on.
If your board is access to Internet you can see CLOUD LED on.

FluoOTA

The user can program the board through Arduino IDE Fluo Ed. and load the new sketch wirelessly thanks to FluoOTA.

With this technology, the user, once they have configured the WiFi connection, will charge their IoT application via wireless technology.
The firmware update for ESP32 side that handles connectivity works with the same mechanism.

There are two mode that you can choice, normal and recovery.
Normal mode -> Serial / STA-OTA
Recovery mode -> AP-OTA

Normal mode

Open the LED blink example sketch: File > Examples >01.Basics > Blink.

You’ll need to select the entry in the Tools > Board menu that corresponds to your Fluo Technology Board.

Use WiFi SmartConfig to connect your board with your WiFi network if you want access to IoT and allow to OTA Upgrade.

If your board is connected with WiFi network you can see LINK LED on.

Select the remote device of the board from the Tools > Port menu. This is likely to be at .

In case you should not see the entry on the menu, you can reset your
board (with RESET BUTTON) and re-open the menu or restart Arduino IDE
Fluo Ed.;

the entry that appears should be like as:

Remember to select the right upgrade mode: Port Mode > Serial/STA-OTA;
this is default mode.

Now, simply click the “Upload” button in the environment. Wait a few seconds, if the upload is successful, the message “Done uploading.” will appear in the status bar.

A few seconds after the upload finishes, you should see the pin 13 – LED on the board start to blink (in orange). If it does, congratulations! You’ve gotten Fluo WI-FI board up-and-running.

If you have problems, please see the Troubleshooting Section.

Recovery mode

First step is enable AP-OTA mode, press for more 5 sec the AP-RST button (close to power jack), wait that STATUS led blink fast before release the button.
If the procedure is successful then you will see LINK Led blinking.

Now you can connect your PC/Mac network adapter to the new Access Point you will see among the available networks, like this:

FluoWiFi_XXXXXX

Open the LED blink example sketch: File > Examples >01.Basics > Blink.

You’ll need to select the entry in the Tools > Board menu that corresponds to your Fluo Technology Board.

Now, you select the right upgrade mode: Port Mode > AP-OTA; this is recovery mode to program the board.

Now, simply click the “Upload” button in the environment. Wait a few seconds, if the upload is successful, the message “Done uploading.” will appear in the status bar.

A few seconds after the upload finishes, you should see the pin 13 – LED on the board start to blink (in orange). If it does, congratulations! You’ve gotten Fluo WI-FI board up-and-running.
If you have problems, please see the Troubleshooting Section.

Now, you select the right upgrade mode: Port Mode > AP-OTA; this is recovery mode .

FluoTUBE

Overview

The FluoTube enables communication between microcontroller AVR and ESP32. This technology allows to simple and intuitive way to access into the world of the Internet of Things through a Wireless connectivity, and it provides the access to the Arduino ecosystem with a particular focus on IoT and easy to use.

The WiFi and Bluetooth low energy interfaces, SD card and all protocol stack to enable the IoT are provided by ESP32. The FluoTube allows you to work with these interfaces, as well as exposed as simple and easy to use API, you find more info on Language Reference for FluoTube Section.

Started