Mikroelektronika d.o.o.
Thingstream Click Board
Thingstream Click Board
Couldn't load pickup availability
The Thingstream Click Board™ is an IoT gateway Click Board™ with the Thingstream client SDK preinstalled. This enables the device to connect to the Thingstream global MQTT network and connectivity tools straight out of the box. Global connectivity is achieved by connecting to the strongest GSM network available across over 600 networks worldwide. This Click Board™ makes it easy to bring Thingstream connectivity to embedded computers and MCUs by simply utilising the UART interface; this can be configured and managed using a minimal set of well-documented AT commands.
The Thingstream Click Board™ is supported by a mikroSDK compliant library, which includes functions that simplify software development. This Click Board™ comes as a fully tested product, ready to be used on a system equipped with the mikroBUS™ socket.
The Thingstream Click Board™ enables low-cost, low-power IoT connectivity and simple software integration with the Thingstream MQTT broker and cloud-based data management platform. It is designed to be connected to existing production or prototype baseboards with a mikroBUS socket. In addition, This Click board™ also comes with a start-up package comprising free Thingstream account activation, an embedded Thingstream SIM and three months of free global cellular connectivity. The device is activated by a redemption unique to the embedded SIM.
Each Thingstream Click Board™ comes with three months of full access to the Thingstream global MQTT network and connectivity software tools and Data Flow Manager with up to 500 MQTT messages per month from the moment of activation.
How Does The Thingstream Click Board™ Work?
The Thingstream Click Board™ is equipped with the SIM868, an 802.11b/g/n quad-band GPS/GLONASS/GSM location tracking and mobile communication module from SIMCom. This allows the device to connect to the Thingstream global MQTT network over GSM. Thingstream Click enables rapid development of intelligent IoT applications and simplified connectivity with cloud platforms using just a tiny set of AT commands and a flow-chart style application builder (Data Flow Manager), removing the complexities of web, hardware, and communications-related development. This Click board™ is preconfigured with all of the necessary protocols and communications settings to connect with the Thingstream global MQTT network and Data Flow Manager. This is implemented via the Thingstream client SDK, which can be used for the development of the firmware located on the onboard STM32F407 MCU. Results can be achieved quickly without a deep understanding of software engineering and web programming.
To find out more about AT commands and how to Click board™ see the following guides:
- AT Command Set manual
- Quick User Guide
Thingstream Click is equipped with various LED indicators. Separate LEDs are used to indicate the presence of a power supply, the network status and pulse per second indication (1PPS).
This Click board™ also contains a universal RGB LED for other feedback relating to the status of the Thingstream Click. This Click board™ requires 5V power rail for proper operation.
Besides the onboard USB connector, all of the mikroBUS™ pins on this Click Board™ are routed to the appropriate pins of the onboard STM32F407 MCU. That way, it is ensured that users will have plenty of space for future upgrades and development. This enables a broad range of custom applications, including support for I2C and SPI communication interfaces.
All available interfaces can be made available to the mikroBUS header. By default, the board only supports UART communication using AT commands. Other interfaces like SPI, I2C, PWM and Analog can be supported by firmware updates. If you require this functionality, please contact the Thingstream team.
This Click board™ uses 3.3V logic level only. To be able to use it with MCUs that use 5V logic level on their communication lines, a proper level-translation circuit should be used.
THINGSTREAM CONNECTIVITY PLATFORM
The Thingstream connectivity platform provides out-of-the-box, global IoT connectivity. As the only provider of truly global, low-power IoT connectivity, Thingstream's platform enables devices to simply connect to the strongest GSM network available, almost anywhere in the world and communicate using MQTT Messaging. Thingstream provides coverage for over 190 countries across 600+ networks worldwide, providing access to its single largest IoT network.
Thingstream's connectivity platform enables two-way intelligent communication between device and IoT application and with proven scalability, the platform is ideal for delivering mass IoT deployments. It doesn't use TCP-IP and therefore, with no IP (Internet) dependency, things are inherently more secure and connectivity is delivered via a proven high availability, high performance global messaging platform.
Find out more about the Thingstream global MQTT network.
SPECIFICATIONS
| Type | Cloud Routers,GPS/GNSS |
| Applications | A global connectivity solution for easy development of powerful MQTT-based intelligent IoT applications |
| On-board modules | SIM868, 802.11b/g/n quad-band GPS/GLONASS/GSM location tracking and mobile communication module STM32F407VGT6 – ARM® Cortex®-M4 based Microcontroller from STMicroelectronics |
| Key Features | Enables easy and fast connectivity between device and cloud applications, low power mode, simple serial interface for communication, GSM connection with coverage for over 190 countries, across 600+ networks worldwide |
| Interface | GPIO,I2C,SPI,UART,USB |
| Compatibility | mikroBUS |
| Click board size | L (57.15 x 25.4 mm) |
| Input Voltage | 5V |
PINOUT DIAGRAM
This table shows how the pinout of the Thingstream Click Board™corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns).
| Notes | Pin |  |
Pin | Notes | |||
|---|---|---|---|---|---|---|---|
| Analog Enabled GPIO | AN | 1 | AN | PWM | 16 | PWM | PWM Enabled GPIO |
| Reset | RST | 2 | RST | INT | 15 | INT | Interrupt Enabled GPIO |
| SPI Chip Enable | CS | 3 | CS | RX | 14 | TX | UART Transmit |
| Serial Clock | SC | 4 | SCK | TX | 13 | RX | UART Receive |
| Serial Data Out | SDO | 5 | MISO | SCL | 12 | SCL | I2C Clock |
| Serial Data In | SDI | 6 | MOSI | SDA | 11 | SDA | I2C Data |
| NC | 7 | 3.3V | 5V | 10 | 5V | Power Supply | |
| Ground | GND | 8 | GND | GND | 9 | GND | Ground |
ONBOARD SETTINGS AND INDICATORS
| Label | Name | Default | Description |
|---|---|---|---|
| LD1 | PWR | - | Power LED Indicator |
| LD2 | NET | - | Network status LED Indicator |
| LD3 | 1PPS | - | Pulse per second LED Indicator |
| LD4 | RGB | - | Universal RGB Indicator |
| J1, J2 | - | 3.3V | Active antenna power supply voltage selection |
Software Support
We provide a library for the Thingstream Click Board™ on our LibStock page and a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.
Library Description
Library provides functions for powering up device, sending commands and controlling devices, and functions for parsing data read from GPS module.
Key Functions
void thingstream_cmd_single ( char *p_cmd )- Fucntion for sending commands to devicechar *thingstream_gps_parser (char *data_in, char *cmd, uint8_t data_pos)- Function for parsing GPS datavoid thingstream_module_power ( uint8_t power_state )- Function for powering up module
Example Description
The application is composed of three sections :
- System Initialization - Initializes necessary GPIO pin, UART used for the communication with GSM module and UART used for infromation logging
- Application Initialization - Initializes driver, power on module and sends few command for the default module configuration.
- Application Task - Waits till GPS module turns on then reads data from buffer parses is and logs it.
void application_task ( ) { char *p_data; char rsp_com[ 50 ] = {0}; if ( gps_rsp_ready == 0 ) { mikrobus_logWrite( " - Waiting to GPS to start... ", _LOG_LINE ); thingstream_cmd_single( &THINGSTREAM_GPS_INFO[ 0 ] ); p_data = thingstream_gps_parser( &demo_buf[ 0 ], &demo_cmd[ 0 ], 1 ); strcpy( &rsp_com[ 0 ], p_data ); while ( rsp_com[ 0 ] != '1' ) { thingstream_cmd_single( &THINGSTREAM_GPS_INFO[ 0 ] ); p_data = thingstream_gps_parser( &demo_buf[ 0 ], &demo_cmd[ 0 ], 1 ); strcpy( &rsp_com[ 0 ], p_data ); Delay_ms( 1000 ); } mikrobus_logWrite( " - GPS - ", _LOG_LINE ); gps_rsp_ready = 1; int_flag = 0; } else { thingstream_cmd_single( &THINGSTREAM_GPS_INFO[ 0 ] ); while ( int_flag != 1 ); int_flag = 0; } mikrobus_logWrite( " ---------------------------------------- ", _LOG_LINE); p_data = thingstream_gps_parser( &demo_buf[ 0 ], &demo_cmd[ 0 ], 3 ); if ( p_data == 0 ) { mikrobus_logWrite( " Latitude : No data available!", _LOG_LINE); } else { strcpy( &rsp_com[ 0 ], p_data ); mikrobus_logWrite( " Latitude : ", _LOG_TEXT ); mikrobus_logWrite( rsp_com, _LOG_LINE ); } Delay_ms( 500 ); p_data = thingstream_gps_parser( &demo_buf[ 0 ], &demo_cmd[ 0 ], 4 ); if ( p_data == 0 ) { mikrobus_logWrite( " Longitude : No data available!", _LOG_LINE); } else { strcpy( &rsp_com[ 0 ], p_data ); mikrobus_logWrite( " Longitude : ", _LOG_TEXT ); mikrobus_logWrite( rsp_com, _LOG_LINE ); } Delay_ms( 500 ); p_data = thingstream_gps_parser( &demo_buf[ 0 ], &demo_cmd[ 0 ], 5 ); if ( p_data == 0 ) { mikrobus_logWrite( " Altitude : No data available!", _LOG_LINE); } else { strcpy( &rsp_com[ 0 ], p_data ); mikrobus_logWrite( " Altitude : ", _LOG_TEXT ); mikrobus_logWrite( rsp_com, _LOG_LINE ); } mikrobus_logWrite( " ---------------------------------------- ", _LOG_LINE); mikrobus_logWrite( " ", _LOG_LINE); Delay_ms( 5000 ); }Additional Functions :
All additional functions such as timer initialization and default handler.
The complete application code, and ready to use projects can be found on our LibStock page.
Other mikroE Libraries used in the example:
- UART
- Conversions
- C_String
Additional Notes and Information
Depending on the development board you are using, you may need USB UART Click Board™, USB UART 2 Click Board™ or RS232 Click Board™ to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.
MIKROSDK
The Thingstream Click Board™ is supported with mikroSDK - MikroElektronika Software Development Kit. To ensure proper operation of mikroSDK compliant Click board™ demo applications, mikroSDK should be downloaded from the LibStock and installed for the compiler you are using.
Thingstream Click Board
Frequently Asked Questions
Have a Question?
Be the first to ask a question about this.