Go to Cloud (G2C) Click

Go to Cloud (G2C) click is a gateway Click board™ which provides a simple and reliable connection to the Click Cloud platform, a cloud-based rapid prototyping environment, hosted by MikroElektronika. Go to Cloud (G2C) click offers an unprecedented simplicity for adding Click Cloud connectivity to any embedded application, by utilizing the simple UART interface: it can be configured and managed using a minimal set of well-documented AT commands. With the simplicity in mind, Go to Cloud (G2C) click represents an ideal solution for accessing user-friendly and intuitive Click Cloud, a simple yet powerful rapid prototyping cloud solution.

Learn all about the Click Cloud solution by visiting the official web page. All the necessary documentation to get you started, including the Go to Cloud (G2C) click User Manual, the AT Command Manual, and the Click Cloud Guide can be found in the documentation below, in the download section.

HOW DOES IT WORK?

Go to Cloud (G2C) click is a Click board™ which allows connection to the feature-rich Click Cloud platform, over the WiFi network. Go to Cloud (G2C) click is envisioned so that users can easily add cloud connectivity and develop their own cloud-based applications, using only a set of simple AT commands, without having to delve into the complexity of web, hardware, and communications related development. Thanks to this simplified approach, everyone can benefit using the Click Cloud solution with Go to Cloud (G2C) click, since this Click board™ has all the necessary protocol and communication settings already implemented within its firmware. This saves a lot of time that would be otherwise wasted on the firmware development, and to adapting it to work with some third-party solution. Not to mention that such an effort would also require embedded and web programming proficiency, along with several other engineering skills. G2C click, on the other hand, works in unity with Click Cloud solution, right out of the box.

Go to Cloud (G2C) click performs several tasks on its side, which are required to connect to the Click Cloud platform. To establish the connection, an access to a WiFi network with Internet connectivity is required. For a reliable WiFi network connection, the Click board™ utilizes the ESP WROOM-02 WiFi module, a well-established integrated WiFi solution.

The Click board™ uses a powerful MCU to manage the connection parameters, initialize the ESP-WROOM-02 WiFi module, and establish the connection with the Click Cloud platform. This allows to set up the connection in just a few simple steps, issuing a set of short AT commands, such as the SSID, password, device_ID, and so on. The complete documentation with in-depth explanation of each AT command and its response can be found in the AT Command Manual.

Besides the AT commands that are used to set up basic connection parameters, there are also AT commands that allow storing of the connection parameters, including the connection password, network SSID, device_ID, and other relevant connection data. These parameters can be stored in the non-volatile memory of the Go to Cloud (G2C) click. It is possible to restore them by a single macro command, resulting in a very simplified connection procedure.

The functionality of the Go to Cloud (G2C) click will be constantly improved in the future. Therefore, Go to Cloud (G2C) click supports an upgrade of its firmware over the onboard USB connector. The firmware update process is very simple, using the familiar "HID Bootloader" software tool from MikroElektronika.

Go to Cloud (G2C) click is equipped with four LED indicators. They are used to indicate the presence of a power supply, the WiFi network connection, the USB connection, and the connection with the Click Cloud solution. These LEDs provide visual feedback about the status of the Go to Cloud (G2C) click. This Click board™ requires both 3.3V and 5V power rails for proper operation.

CLICK CLOUD SOLUTION

Click Cloud solution is very simple to use, and it relies on a very comprehensive and intuitive web-based Graphical User Interface (WEB GUI). It allows the rapid development of cloud-based applications, offering a set of well-documented functionalities, specially tailored to offer the best experience when used with the Click board™ line of products. However, It can be used with other MikroElektronika products, as well.

Click Cloud hosted by MikroElektronika provides a clean, intuitive, and logical concept, abstracting the Click board™ as a "device" with its "device manifest" that contains a set of pre-configured or custom-created sensors, actuators, and other devices, typically found on various Click boards™. This concept allows very simplified management with nice and clean data representation. An interactive online help within the WEB GUI offers a detailed explanation of each feature of the Click Cloud solution. Besides using the WEB GUI, there is also the possibility to access the Click Cloud over mobile apps, based on IOS and Android OS platforms.

You can discover more about the features offered by Click Cloud solution, at the official Click Cloud page.

SPECIFICATIONS

PINOUT DIAGRAM

This table shows how the pinout on the Go to Cloud (G2C) click  corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns).

Notes	Pin					Pin	Notes
General Purpose #0	GP0	1	AN	PWM	16	GP1	General Purpose #1
Hardware Reset	RST	2	RST	INT	15	RTS	Request to Send
UART Clear to Send	CTS	3	CS	RX	14	TX	UART Transmit
	NC	4	SCK	TX	13	RX	UART Receive
	NC	5	MISO	SCL	12	NC
	NC	6	MOSI	SDA	11	NC
Power supply	3.3V	7	3.3V	5V	10	5V	Power supply
Ground	GND	8	GND	GND	9	GND	Ground

ONBOARD SETTINGS AND INDICATORS

SOFTWARE SUPPORT

We provide a library for the Go to Cloud (G2C) click on our LibStock page, as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Library Description

The library carries generic command parser adopted for AT command based modules. The library contains an example for basic initialization of the actuator and sensor demo example.

Key functions:

• void g2c_cmdSingle( char *pCmd ) - Sends provided command to the module
• void g2c_coreInit( T_g2c_handler defaultHdl, uint32_t defaultWdog ) - Core Initialization
• void g2c_modulePower( bool powerState ) - Turn ON or OFF the module.
• void g2c_process() - AT Engine State Machine

Examples description

The application is composed of the three sections :

• System Initialization - Initializes all necessary GPIO pins, UART used for the communication with G2C click.
• Application Initialization - Initializes driver, power on module. Commands are sent to prepare the module for communication with the g2c.
• Application Task - running in parallel core state machine and checks for the URC message from Click G2C.

Note: Example demonstrates the measurement of inductance change depending on the linear motion of the metal object. Induction of the linear metal position depends on the type of metal and the configuration.

void applicationTask()
{    char demoBuffer[ 50 ];    // CORE STATE MACHINE    g2c_process();
// SENSOR - Remove if not used   if( taskTime > 1500 )   {    taskTime = 0;            g2c_packCmd( &_AT_DSET[0], &g2c_sensorRef[0], &demoBuffer[0]);    g2c_cmdSingle( &_AT_PUB[0] );   }
// ACTUATOR - Remove if not used   if(state == 1 && oldstate == 0)   {   // User code if the swithc is set to 1    oldstate = 1;   }
   if(state == 0 && oldstate == 1)   {   // User code if the swithc is set to 0    oldstate = 0;   }
}

The full application code, and ready to use projects can be found on our LibStock page.

Other mikroE Libraries used in the example:

• UART
• String
• Conversion

Additional notes and information

Depending on the development board you are using, you may need USB UART click, USB UART 2 click or RS232 click 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

This 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.

For more information about mikroSDK, visit the official page.

DOWNLOADS

mikroBUS™ Standard specification 
ESP-WROOM-02 datasheet
LibStock: mikroSDK 
G2C Click Libstock 
G2C Click 2D and 3D files
G2C Click AT command
G2C Click Schematic
G2C Click User Manual
Click board catalog
Firmware Latest Version