MKR GSM 1400

Components

Components to complete this tutorial are the following:

MKR GSM 1400
Antenna
SIM card
Micro USB to USB cable

Both the antenna and SIM card must be attached to the board.

Requirements

Your chosen SIM card must have access to the internet

Setup Your Environment

Install the Arduino IDE (Integrated development environment). This is where You can download it for Mac OS X, Windows and Linux here.

Detailed instructions can be found below:

New to the Arduino IDE?

If you are completely unfamiliar with the Arduino IDE, watch this video <a href="https://www.youtube.com/watch?v=nbD_V4QtNvY" target="_blank">here</a> to give you a better understanding of how it works.

In the Arduino IDE:

Go to menu: Tools > Board > Boards Manager
Search for Arduino SAMD. When found, click Install

Install the required libraries

To complete the tutorial, additional libraries of functionality are required, these can be installed through the Arduino IDE in the following way:

In the Arduino IDE:

Go to Sketch > Include Libraries > Manage Libraries

In the search bar, search for the below libraries. When found, click on the library and a button will appear in the bottom right of the box that will allow you to install the library.

MKRGSM
ArduinoHttpClient
ArduinoJson

Select board and port

In the Arduino IDE:

Select your MKR GSM 1400 board type by going to Tools > Board
Select the port that displays MKR GSM 1400 If no name is displayed, you can find the port with the following steps:

Linux and Mac OS X

Download and install the FTDI drivers from here. Select the appropriate version for your operating system and architecture.
Open a terminal window and run the command ls /dev/tty*
Look for a device with the name that begins with /dev/tty e.g. /dev/tty.usbmodemPy343431 on MAC or /dev/ttyUSB0/dev/ttyACM0 on Linux.

Warning

For Linux, you may need to run the two commands below. Once you've completed that, reboot your computer. This will add permissions that will allow you to upload a sketch to the board.

sudo usermod -a -G tty ${USER} sudo usermod -a -G dialout ${USER}

Windows

Download and install the FTDI drivers from here. Select the appropriate version for your operating system and architecture.
Open the Windows start menu and search for Device Manager
The COM port for the Pycom device will be listed as USB Serial Device or something similar
Keep note of the COM port (e.g. COM4)

Create a new Sketch

Click on File > New to create a new Sketch
Copy and paste the publishEvent.ino or publishLocation.ino from the example code below

#include <ArduinoHttpClient.h> #include <MKRGSM.h> #include <ArduinoJson.h> // PIN Number const char PINNUMBER[] = ""; //blank if no pin // APN data: check settings on mobile for sim provider or contact carrier for network settings const char GPRS_APN[] = ""; const char GPRS_LOGIN[] = ""; const char GPRS_PASSWORD[] = ""; // get this from the wia dashboard. it should start with `d_sk` const char* device_secret_key = "your-device-seccret-key"; GSMClient client; GPRS gprs; GSM gsmAccess; // Wia API parameters char server[] = "api.wia.io"; char path[] = "/v1/events"; int port = 80; StaticJsonDocument<200> jsonBuffer; HttpClient httpClient = HttpClient(client, server, port); JsonObject& root = jsonBuffer.to<JsonObject>(); String response; int statusCode = 0; String dataStr; void setup() { // initialize serial communications and wait for port to open: Serial.begin(9600); while (!Serial) { ; // wait for serial port to connect. Needed for native USB port only } Serial.println("Starting GSM connection to Wia!."); // connection state boolean connected = false; // After starting the modem with GSM.begin() // attach the shield to the GPRS network with the APN, login and password while (!connected) { if ((gsmAccess.begin(PINNUMBER) == GSM_READY) && (gprs.attachGPRS(GPRS_APN, GPRS_LOGIN, GPRS_PASSWORD) == GPRS_READY)) { connected = true; } else { Serial.println("Not connected"); delay(1000); } } Serial.println("connecting..."); // if you get a connection, report back via serial: if (client.connect(server, port)) { Serial.println("connected"); } else { // if you didn't get a connection to the server: Serial.println("connection failed"); } } void loop() { root["name"] = "hello-wia"; root["data"] = ""; // if you get a connection, report back via serial: if (client.connect(server, port)) { postToWia(root); } else { // if you didn't get a connection to the server: Serial.println("connection failed"); } // read the status code and body of the response statusCode = httpClient.responseStatusCode(); response = httpClient.responseBody(); Serial.print("Status code: "); Serial.println(statusCode); Serial.print("Response: "); Serial.println(response); delay(3000); // Wait for 3 seconds to post again } void postToWia(JsonObject& data) { dataStr = ""; serializeJson(data, dataStr); httpClient.beginRequest(); httpClient.post(path); httpClient.sendHeader("Content-Type", "application/json"); httpClient.sendHeader("Content-Length", dataStr.length()); httpClient.sendHeader("Authorization", "Bearer " + String(device_secret_key)); httpClient.beginBody(); httpClient.print(dataStr); httpClient.endRequest(); }

#include <ArduinoHttpClient.h> #include <MKRGSM.h> #include <ArduinoJson.h> // PIN Number const char PINNUMBER[] = ""; //blank if no pin // APN data: check settings on mobile for sim provider or contact carrier for network settings const char GPRS_APN[] = ""; const char GPRS_LOGIN[] = ""; const char GPRS_PASSWORD[] = ""; // get this from the wia dashboard. it should start with `d_sk` const char* device_secret_key = "your-device-secret-key"; GSMClient client; GPRS gprs; GSM gsmAccess; // Wia API parameters char server[] = "api.wia.io"; char path[] = "/v1/locations"; int port = 80; StaticJsonBuffer<512> jsonBuffer; HttpClient httpClient = HttpClient(client, server, port); JsonObject& root = jsonBuffer.createObject(); String response; int statusCode = 0; String dataStr; void setup() { // initialize serial communications and wait for port to open: Serial.begin(9600); while (!Serial) { ; // wait for serial port to connect. Needed for native USB port only } Serial.println("Starting GSM connection to Wia!."); // connection state boolean connected = false; // After starting the modem with GSM.begin() // attach the shield to the GPRS network with the APN, login and password while (!connected) { if ((gsmAccess.begin(PINNUMBER) == GSM_READY) && (gprs.attachGPRS(GPRS_APN, GPRS_LOGIN, GPRS_PASSWORD) == GPRS_READY)) { connected = true; } else { Serial.println("Not connected"); delay(1000); } } Serial.println("connecting..."); // if you get a connection, report back via serial: if (client.connect(server, port)) { Serial.println("connected"); } else { // if you didn't get a connection to the server: Serial.println("connection failed"); } } void loop() { root["latitude"] = 43.56; root["longitude"] = 21.5; // if you get a connection, report back via serial: if (client.connect(server, port)) { postToWia(root); } else { // if you didn't get a connection to the server: Serial.println("connection failed"); } // read the status code and body of the response statusCode = httpClient.responseStatusCode(); response = httpClient.responseBody(); Serial.print("Status code: "); Serial.println(statusCode); Serial.print("Response: "); Serial.println(response); delay(3000); // Wait for 3 seconds to post again } void postToWia(JsonObject& data) { data.printTo(dataStr); httpClient.beginRequest(); httpClient.post(path); httpClient.sendHeader("Content-Type", "application/json"); httpClient.sendHeader("Content-Length", data.measureLength()); httpClient.sendHeader("Authorization", "Bearer " + String(device_secret_key)); httpClient.beginBody(); httpClient.print(dataStr); httpClient.endRequest(); }

If your SIM card has a pin, enter it in the PINUMBER field or else leave that field blank
To access your Access Point Name(APN), ask your network carrier for the details
Alternatively, you can attach your SIM card to your phone, check settings for the APN of the carriernetwork
Add the device_secret_key with your device secret key from the Wia Dashboard (the one that begins with d_sk)
Verify/Compile the code. If it runs correctly then go to Sketch > Upload to send it to your MKR GSM 1400

Go to the Wia dashboard to view the data coming through to your device.

If you need any help with getting setup or you don't understand the tutorial, tweet us, email support@wia.io or chat on Intercom.

Last updated on