Lcs: /* Libraries importation */

2017-04-05T13:37:53Z

‎Libraries importation

Lcs: Created page with "Category:Smart IoT Sensor ==First Steps== The Smart IoT Sensor is shipped with the pre-loaded Blink program. - Connect to Smart IoT Sensor to the PC with a micro USB ca..."

2017-01-15T22:38:59Z

Created page with "Category:Smart IoT Sensor ==First Steps== The Smart IoT Sensor is shipped with the pre-loaded Blink program. - Connect to Smart IoT Sensor to the PC with a micro USB ca..."

New page

[[Category:Smart IoT Sensor]]

==First Steps==

The Smart IoT Sensor is shipped with the pre-loaded Blink program.

- Connect to Smart IoT Sensor to the PC with a micro USB cable. The Led blinks periodically.

To try examples and develop your own application, the IDE and toolchain must be installed. The following section describes the steps to install the Arduino IDE and dependencies to work with the Smart IoT Sensor.

==IDE and toolchain installation==
===Arduino IDE installation===

Get the latest version [https://www.arduino.cc/en/Guide/HomePage Arduino IDE] and follow the needed steps to install on your computer.
Once installed you can execute the IDE and follow next steps.

[[File:Arduino_Software.png|500px|link=]]

''On Windows, you can choose between downloading the Installer (.exe) or the Zip package. We suggest to choose the first one because it installs directly everything needed to use the Arduino IDE, including the drivers. With the Zip package, the drivers must be installed manually.''

Still, the support for the Atmel SAMD MCU on the board must be added. See the following section.

===Atmel SAMD Support Installation===
On the Arduino IDE, the SAMD MCU is not supported by default. In order compile and upload for the Smart IoT Sensor, the package for the Arduino/Genuino Zero (which use the SAMD MCU) must be downloaded. This is very easy folling these steps:

From the Arduino IDE, install the latest SAMD boards support:

* Open the '''Board Manager''' window from the ''Tools>Board: "Arduino/Genuine Uno">Board Manager...'':

[[file:Arduino_Board-Manager.png|500px|link=]]

* Enter '''SAMD''' in the search field, select '''Arduino SAMD Boards (32-bits ARM Cortex-MO+)''' and click on '''Install''' with the latest version:

[[File:Arduino_Board-Manager_SAMD.png|500px|link=]]

The Board Manager will download the package (around 50MB) and install it.

* You are now able to choose the '''Arduino/Genuino Zero (Native USB Port)''':

[[File:Arduino_Board-Select.png|500px|link=]]

''In the board list, you can notice that both "Native USB Port" and "Programming Port" are selectable. the Native USB Port must be choosen to download the binaries with the USB cable. The Programming Port is also available on the Smart IoT Sensor but a debugger must be used to download the binaries (the procedure is explained at the end of this guide).''

Now, you are able to compile programs and download them into the SAMD MCU of the board. The last step is to install the libraries of the modules and sensors included int the Smart IoT Sensor. With them, it will be easy to create complete applications in just a few hours.

===Libraries importation===

There is two ways to download the libraries: manual download with direct link or with the ''Sketch>Include Library>Manage Libraries...'' menu in the Arduino IDE. Both methods are described if available.

* For the embedded GPS (SIMCom SIM33ELA module):
** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''MicroNMEA''' by ''Steve Marple'' and install the lastest version.
** Direct Downloard: Download the [https://github.com/stevemarple/MicroNMEA/archive/master.zip MicroNMEA lib] and follow the instructions at the end of this list to install it.

* For the LoRa Communication (Nemeus MM002 module):
**Direct Downloard: Download the [https://gitlab.com/akr/arduino-nemeus-lib/repository/archive.zip?ref=master Nemeus lib] and follow the instructions at the end of this list to install it.

* For the accelerometer (Analog Devices ADXL345 sensor)
** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit ADXL345''' by ''Adafruit'' and install the lastest version.
**Direct Downloard: Download the [https://github.com/adafruit/Adafruit_ADXL345/archive/master.zip ADXL345 lib] and follow the instructions at the end of this list to install it.

* For the temperature sensor (Bosh BMP280 sensor)
** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit BMP280 Library''' by ''Adafruit'' and install the lastest version.
**Direct Downloard: Download the [https://github.com/adafruit/Adafruit_BMP280_Library/archive/master.zip BMP280 lib] and follow the instructions at the end of this list to install it.

* The "generic" sensor wrap-up:
** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit Unified Sensor''' by ''Adafruit'' and install the lastest version.
** Direct Downloard: Download the [https://github.com/adafruit/Adafruit_Sensor/archive/master.zip unified sensor lib] and follow the instructions at the end of this list to install it.

''If you have used the Arduino IDE to install all the libraries, you can skip this part. The following instructions are for installing the libraries downloaded from direct link.''

*Do not unzip the downloaded libraries, leave them as is. In the Arduino IDE, navigate to ''Sketch>Include Library''. At the top of the drop-down list, select the option to '''Add .ZIP Library'''.

[[File:Arduino_Add-Lib.png|500px|link=]]

* You will be prompted to select the library you would like to add. Navigate to the downloaded libraries .zip files location and select them. The name of the library must only contain alphanumeric characters (ASCII only, without space. Cannot start with a number).

* Restart the Arduino IDE.

* In the the ''Sketch>Import Library'' menu, you can now see the new libraries at the bottom of the drop-down menu. You can use them in your sketchs. Zip files will be copied into the libraries folder in your Arduino sketches directory under ''Arduino/libraries''.

With the installation of the Nemeus library for the LoRa module, several examples are exposed in the ''File>Examples>Nemeus'' menu. You can try them on the board.

==Connect the board==

The USB connection with the PC is necessary to program the board.
* Connect the board to your computer using a micro USB cable.

''If you have connected a battery, the charging circuit should set the red LED on until battery is fully charged, indicated with the green LED.''

== Upload your first sketch ==

* Once you have opened an application example or made your own, you can select the '''Arduino/Genuino Zero (Native USB port)''' int he ''Tools>Board'' menu.

* The Smart IoT sensor should have been recognized by the OS.a serial/COM port must have been onpened. In the Arduino IDE, you can now select the Smart IoT Sensor in the ''Tools>Port' drop-down list'', it'll be indicated as an '''Arduino/Genuino Zero board'''.

* If you have a successful upload, you'll get a bunch of red text that tells you that the device was found
and it was programmed, verified & reset

==Manual recovery==
If you uploaded a bad sketch that crashes, you may be unable to re-flash your board. In that case, no more COM/Serial port appears in the Arduino IDE.
To recover from this, double click the reset button to force bootloader mode. You should get back into the bootloader and see the new COM/Serial.

Once it is in bootloader mode, you can select the newly created COM/Serial port and re-try uploading.

@@ Line 51: / Line 51: @@
 * For the embedded GPS (SIMCom SIM33ELA module):
 ** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''MicroNMEA''' by ''Steve Marple'' and install the lastest version.
-** Direct Downloard: Download the [https://github.com/stevemarple/MicroNMEA/archive/master.zip MicroNMEA lib] and follow the instructions at the end of this list to install it.
+** Direct Download: Download the [https://github.com/stevemarple/MicroNMEA/archive/master.zip MicroNMEA lib] and follow the instructions at the end of this list to install it.
 * For the LoRa Communication (Nemeus MM002 module):
-**Direct Downloard: Download the [https://gitlab.com/akr/arduino-nemeus-lib/repository/archive.zip?ref=master Nemeus lib] and follow the instructions at the end of this list to install it.
+**Direct Download: Download the [https://github.com/nemeus/arduino-nemeus-lib Nemeus lib] and follow the instructions at the end of this list to install it.
 * For the accelerometer (Analog Devices ADXL345 sensor)
 ** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit ADXL345''' by ''Adafruit'' and install the lastest version.
-**Direct Downloard: Download the [https://github.com/adafruit/Adafruit_ADXL345/archive/master.zip ADXL345 lib] and follow the instructions at the end of this list to install it.
+**Direct Download: Download the [https://github.com/adafruit/Adafruit_ADXL345/archive/master.zip ADXL345 lib] and follow the instructions at the end of this list to install it.
 * For the temperature sensor (Bosh BMP280 sensor)
 ** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit BMP280 Library''' by ''Adafruit'' and install the lastest version.
-**Direct Downloard: Download the [https://github.com/adafruit/Adafruit_BMP280_Library/archive/master.zip BMP280 lib] and follow the instructions at the end of this list to install it.
+**Direct Download: Download the [https://github.com/adafruit/Adafruit_BMP280_Library/archive/master.zip BMP280 lib] and follow the instructions at the end of this list to install it.
 * The "generic" sensor wrap-up:
 ** Arduino IDE: ''Sketch>Include Library>Manage Libraries...'' and search for '''Adafruit Unified Sensor''' by ''Adafruit'' and install the lastest version.
-** Direct Downloard: Download the [https://github.com/adafruit/Adafruit_Sensor/archive/master.zip unified sensor lib] and follow the instructions at the end of this list to install it.
+** Direct Download: Download the [https://github.com/adafruit/Adafruit_Sensor/archive/master.zip unified sensor lib] and follow the instructions at the end of this list to install it.

Smart IoT Sensor - Getting Started - Revision history

Lcs: /* Libraries importation */

Lcs: Created page with "Category:Smart IoT Sensor ==First Steps== The Smart IoT Sensor is shipped with the pre-loaded Blink program. - Connect to Smart IoT Sensor to the PC with a micro USB ca..."