# SODAQ SARA R41XM
Get started with the SODAQ SARA R410M/R412M SFF or AFF, an Arduino-based development board with an embedded u-blox SARA R41X LTE-M, NB-IoT and GPRS modem. The device comes with an integrated GPS, Accelerometer and Magnetometer.
### Quick Navigation
* [Getting Started with the SODAQ SARA](https://docs.monogoto.io/getting-started/general-device-configurations/iot-devices/u-blox-sara-r4/broken-reference)
* [Connect the u-blox to Monogoto](https://docs.monogoto.io/getting-started/general-device-configurations/iot-devices/u-blox-sara-r4)
* [Build an end-to-end tracking application](#trackingapplication)
* [Useful links](#useful-link)
### Prerequisites
* Monogoto SIM
* [SODAQ SARA R412M](https://shop.sodaq.com/sodaq-sara-aff-r412m.html) / [R410M](#prerequisites)
* [Arduino IDE](https://www.arduino.cc/en/software)
## **Getting Started with the SODAQ SARA**
### **Install SODAQ SARA board manager**
Open up the Arduino IDE and select ***Arduino***** > *****Preferences*** from the menu bar. Paste the following URL in the field next to **Additional Boards Manager URLs**:
`http://downloads.sodaq.net/package_sodaq_samd_index.json`
Go to ***Tools > Board > Board Manager***, search for **SODAQ SAMD** and install the latest version.
### **Upload Passthrough sketch**
*The Passthrough sketch allows you to send AT commands to the u-blox modem.*
 
Start by connecting the **LTE antenna**
Add the **Monogoto SIM**
Connect the **battery**
Connect the SODAQ SARA to your computer using the **micro USB port next to the SIM card slot**, an LED will light up **yellow**.
{% hint style="warning" %}
Make sure to connect the USB cable to the micro USB port next to the SIM card slot. When connecting the cable to the second USB port it is not possible to upload the Arduino sketch.
{% endhint %}
Select the right board in the Arduino IDE via ***Tools > Board > SODAQ SAMD Boards > SODAQ SARA AFF/SFF***
Select the right port via ***Tools > Port***
SODAQ SARA AFF passthrough Arduino Sketch:
```arduino
// Passthrough Arduino sketch
// Source: https://learn.sodaq.com/Boards/Sara_AFF/Examples/passthrough/
#include
#define R4XX // Comment out when you use the u-blox R2XX module
#if defined(ARDUINO_SODAQ_SARA)
#define DEBUG_STREAM SerialUSB
#define MODEM_STREAM Serial1
#define powerPin SARA_ENABLE
#define enablePin SARA_TX_ENABLE
#else
#error "Please select the SODAQ SARA as your board via Tools > Board:"
#endif
#if defined(R4XX)
unsigned long baud = 115200; //start at 115200 allow the USB port to change the Baudrate
#else
unsigned long baud = 9600; //start at 9600 allow the USB port to change the Baudrate
#endif
void setup()
{
#ifdef powerPin
// Turn the nb-iot module on
pinMode(powerPin, OUTPUT);
digitalWrite(powerPin, HIGH);
#endif
#ifdef enablePin
// Set state to active
pinMode(enablePin, OUTPUT);
digitalWrite(enablePin, HIGH);
#endif // enablePin
#if defined(R4XX)
pinMode(SARA_R4XX_TOGGLE, OUTPUT);
digitalWrite(SARA_R4XX_TOGGLE, LOW);
delay(2000);
pinMode(SARA_R4XX_TOGGLE, INPUT);
#endif
// Start communication
DEBUG_STREAM.begin(baud);
MODEM_STREAM.begin(baud);
}
// Forward every message to the other serial
void loop()
{
while (DEBUG_STREAM.available())
{
MODEM_STREAM.write(DEBUG_STREAM.read());
}
while (MODEM_STREAM.available())
{
DEBUG_STREAM.write(MODEM_STREAM.read());
}
// check if the USB virtual serial wants a new baud rate
// This will be used by the UEUpdater to flash new software
if (DEBUG_STREAM.baud() != baud) {
baud = DEBUG_STREAM.baud();
MODEM_STREAM.begin(baud);
}
}
```
SODAQ SARA SFF passthrough Arduino Sketch:
```
// Passthrough Arduino sketch
// Source: https://learn.sodaq.com/Boards/Sara_SFF/examples/passthrough/
#include
#define R4XX // Comment out when you use the u-blox R3XX or R2XX module
//#define N3XX // Uncomment when you use the ublox N3XX module
#define DEBUG_STREAM SerialUSB
#define MODEM_STREAM Serial1
#if defined(R4XX)
unsigned long baud = 115200; //start at 115200 allow the USB port to change the Baudrate
#elif defined(N3XX)
unsigned long baud = 57600; //start at 57600 allow the USB port to change the Baudrate
#else
unsigned long baud = 9600; //start at 9600 allow the USB port to change the Baudrate
#endif
void setup()
{
// Turn the power to the SARA module on.
// we have a powerswitch on board to switch the power to the SARA on/of when needed
// in most applications we keep the power on all the time
pinMode(SARA_ENABLE, OUTPUT);
digitalWrite(SARA_ENABLE, HIGH);
#if defined(R4XX) || defined(N3XX)
// Turn the nb-iot module on
// The R4XX module has an on/off pin. You can toggle this pin or keep it low to
// switch on the module
pinMode(SARA_R4XX_TOGGLE, OUTPUT);
digitalWrite(SARA_R4XX_TOGGLE, LOW);
delay(2000);
pinMode(SARA_R4XX_TOGGLE, INPUT);
#endif
// Start communication
DEBUG_STREAM.begin(baud);
MODEM_STREAM.begin(baud);
}
// Forward every message to the other serial
void loop()
{
while (DEBUG_STREAM.available())
{
MODEM_STREAM.write(DEBUG_STREAM.read());
}
while (MODEM_STREAM.available())
{
DEBUG_STREAM.write(MODEM_STREAM.read());
}
// check if the USB virtual serial wants a new baud rate
// This will be used by the UEUpdater to flash new software
if (DEBUG_STREAM.baud() != baud) {
baud = DEBUG_STREAM.baud();
MODEM_STREAM.begin(baud);
}
}
```
### **Establish a connection with the u-blox modem**
**Open up the Serial Monitor** from the Arduino IDE by clicking the Serial Monitor-button in the top right corner.
Set the baud rate to **115200** and enter `AT` in the Serial Monitor. If the connection with the u-blox modem has been established, the board will answer with `OK`.
{% hint style="warning" %}
If you donβt see `OK` click the reset button on the SODAQ SARA and try again.
{% endhint %}
Next up, disable PSM (Power Saving Mode) and eDRX (Extended Discontinuous Reception). When these features are enabled the modeqm goes to sleep automatically and stops responding to AT Commands.
Disable PSM:
```arduino
AT+CPSMS=0
```
Disable eDRX:
```arduino
AT+CEDRXS=0
```
Disable Power saving control:
```arduino
AT+UPSV=0
```
## **Connect the u-blox modem to Monogoto**
Visit the u-blox SARA R4 documentation for a detailed guide on connecting the modem to Monogoto.
{% content-ref url="" %}
[](https://docs.monogoto.io/getting-started/general-device-configurations/iot-devices/u-blox-sara-r4)
{% endcontent-ref %}
## Build an end-to-end tracking application
Guard your valuable assets, get notified if any assets move without your consent and keep track of their real-time GPS location.\
\&#xNAN;*Source:* [*AllThingsTalk*](https://www.allthingstalk.com/faq/guard-and-track-your-assets-with-the-lte-m-rdk)
### **Prerequisites**
* Monogoto SIM
* [SODAQ SARA R412M](https://shop.sodaq.com/sodaq-sara-aff-r412m.html) / [R410M](https://shop.sodaq.com/sodaq-sara-aff-r410m.html)
* [Arduino IDE](https://www.arduino.cc/en/software)
* [Account on AllThingsTalk](https://www.allthingstalk.com/)
### Install the AllThingsTalk Arduino library
Open your Arduino IDE and install the `AllThingsTalk LTE-M SDK` library via ***Sketch > Include library > Manage Libraries***.
Open the sketch `GuardAndTrackAssets`: ***File > Examples > AllThingsTalk LTE-M SDK > SDK Examples > GuardAndTrackAssets***
### Register your device in AllThingsTalk Maker
Create a [free account on AllThingsTalk](https://www.allthingstalk.com/)
Visit to the [AllThingsTalk Maker portal](https://maker.allthingstalk.com/)
Click the **CONNECT A DEVICE** button and select the **LTE-M Rapid Development Kit**. **Skip** the step for selecting a NB-IoT/LTE-M network provider.
Click on **Settings** and **Authentication** to find your **Device ID** and **Device Token**.
In your Arduino sketch click the tab `keys.h`. Add the authentication credentials and update the APN settings to `data.mono`.
Upload the sketch to the SODAQ SARA and wait for the onboard LED to turn **green**.
> Did the LED turn green? Congratulations! The device is connected to both Monogoto and AllThingsTalk π
### Start tracking your assets
Place your device outside or next to a window so it can receive GPS signals.
Go back to the **AllThingsTalk Maker**, select your asset and click on the actuator **Lock**, scroll down to the section **State** and enter.
```json
{
"value": "false"
}
```
Next up, click on the **Lock** actuator again, scroll down to the section **Command** and enter**:**
```json
{
"value": "true"
}
```
When shaking the device, an alert is triggered and the device starts sending GPS data regularly. Visit the **Debug** tab to see the GPS data appear.
> Great work! π You managed to build an end-to-end LTE-M application. You can now start playing around with [widgets](https://www.allthingstalk.com/faq/creating-a-pinboard) to visualize your GPS data in AllThingsTalk or to create [rules](https://www.allthingstalk.com/faq/get-started-with-rules) to trigger actions based on sensor data.
## Useful Link
* [AllThingsTalk documentation](https://www.allthingstalk.com/faq/guard-and-track-your-assets-with-the-lte-m-rdk)
* [u-blox AT commands](https://www.u-blox.com/sites/default/files/SARA-R4_ATCommands_UBX-17003787.pdf)
* [u-blox Product page](https://www.u-blox.com/en/product/sara-r4-series)
* [SODAQ Documentation](https://learn.sodaq.com/Boards/Sara_AFF/)
* [SODAQ Shop](https://shop.sodaq.com/sodaq-sara-aff-r412m.html)