If you already have a host processor and you want radio connectivity, you can use an essential module and a library to communicate with AirVantage. It provides all the great device management and application management features supported by your host, it’s really simple to use and it does the job for simple data exchange.
Follow this tutorial to connect your Essential module with AirVantage.
The following essential modules are supported:
and not supported:
Any issues ?
If you encounter any issue to set up your device, don’t hesitate to use the developer forum to benefit from the developer community experience.
These modules don’t include any Application Framework. You need to integrate a connector in your host application to enable the connection with AirVantage.
What is a system? A system represents:
- A module which supplies the connectivity
- A SIM card which give the network access (if any)
- Some applications running in the hardware (any host like micro controller or processor)
Editin the action bar (menu More). You can alternatively access the required SIM card details then click on
Edit. An edition page opens.
Create a new Gatewaybutton in the Gateway line
To get these two information, open a serial port terminal (like Tera Term, …) and send the following AT commands:
For the IMEI:
Note: For HL6 and HL78, use AT+CGSN at command instead.
For the Serial Number:
Click on the
Search an application button in the Applications line
To get the firmware version (and more), open a serial port terminal (like Tera Term, …) and send the following AT commands:
To start a session with AirVantage, open a serial port terminal (like Tera Term, …) and send the following AT commands:
If you get any ERROR, check the AT Commands guide for your module.
Although it’s optional, it’s useful to synchronize your device with AirVantage at least once to check if configuration is correct.
Have a look here to learn how to synchronize your system and how to use the Device Management Features.
In this step, we are going to send data using MQTT API for devices. A huge choice of libraries for a large set of hardware and languages is available on the web. Choose the one best suited to your hardware.
You can use REST API for devices as well. As soon as you have an IP stack and the capability to do HTTP calls, you can use our HTTP API for devices. It doesn’t give you all the fancy device management and application management features but it’s really simple to use and it does the job for simple data exchange. Read the following article to learn how to use the REST API for devices to easily enable the communication with AirVantage from your embedded application.
You’re ready to implement your embedded application on:
Finally test your application by using this tutorial .
Once your system communicates correctly and data values are stored in AirVantage, you may want to automate analysis by using rules and display it in a dashboard. Have a look at this tutorial to learn how to define a rule and design your operational dashboard.
Once your system communicates correctly with AirVantage and data values can be browsed and displayed, you may want to use them in your specific application. Have a look to our AirVantage API to learn how to use this API to build powerful applications.
This sample (used in the above steps) publishes emulated Temperature and Humidity to AirVantage, and receives “TurnOn” command from AirVantage.
You may adapt this code to fit your needs.
This app automatically converts CVS data to MQTT messages prior publishing to server. It also automatically converts incoming MQTT messages (pertaining to a subscribed Topic) to CSV data. This app could be reused as a quick integration option (no need to deal with MQTT code) with your existing sensor/actuator based application.