Laird Sentrius MG100 User manual

A
Version 1.0

https://www.lairdconnect.com/
2
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Version
Date
Notes
Contributors
Approver
1.0
18 Nov 2021
Initial Release
Mark Calhoun
Andy Ross

https://www.lairdconnect.com/
3
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
1Overview .............................................................................................................................................................................4
2Hardware Description..........................................................................................................................................................4
2.1 Datasheet...................................................................................................................................................................4
2.2 Standard Kit Contents................................................................................................................................................4
2.3 User Provided items...................................................................................................................................................4
2.4 3rd Party purchasable items........................................................................................................................................4
2.5 Additional Hardware References................................................................................................................................4
3Set up your Development Environment...............................................................................................................................5
3.1 Tools Installation (IDEs, Toolchains, SDKs)...............................................................................................................5
3.2 Additional Software References.................................................................................................................................5
4Set up your hardware..........................................................................................................................................................5
5Setup your AWS account and Permissions.........................................................................................................................7
6Create Resources in AWS IoT.............................................................................................................................................7
7Provision the Device with credentials..................................................................................................................................7
8Build the demo.....................................................................................................................................................................7
9Run the demo......................................................................................................................................................................8
10 Debugging...........................................................................................................................................................................8
11 Troubleshooting.................................................................................................................................................................10

https://www.lairdconnect.com/
4
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Powered by Laird Connectivity's Pinnacle™ 100 Modem, the Sentrius™ MG100 Gateway captures data from Bluetooth 5 long
range sensors and sends it to the cloud via a global low power cellular (LTE-M/NB-IoT) connection. This makes it the perfect
fit for the following applications.
▪Cold chain transportation monitoring
▪Predictive Maintenance
▪Industrial IoT
The MG100 datasheet can be found on the MG100 product page:
https://www.lairdconnect.com/documentation/mg100-gateway-hardware-guide
The most common product kit is the Sentrius MG100 –Wireless IoT Starer Kit. This kit provides the following pieces of
hardware.
▪1x Sentrius MG100 Micro Gateway, LTE-M & NB1 modem, Bluetooth LE, external antenna, battery backup
▪1x MVNO SIM card
▪3x Sentrius™ BT510 – Bluetooth 5 multi sensor, IP67 –temperature, shock/movement, and open/close contact
▪3x Regional power supplies (US/EU/UK)
Product Page: https://www.lairdconnect.com/iot-devices/iot-gateways/sentrius-mg100-gateway-lte-mnb-iot-and-bluetooth-5
The user may need to supply the following items:
▪Micro USB Cable(s)
▪Micro SD card for logging
▪MNO or MVNO SIM card for LTE-M or NB-IoT
You may purchase the Micro USB cable and SD card here or elsewhere.
▪Micro USB Cable : https://www.amazon.com/dp/B074VM7J68/ref=twister_B07BWMNQTY?_encoding=UTF8&psc=1
▪SD card: https://www.amazon.com/dp/B07R8GVGN9/ref=twister_B09CG3FLV1?_encoding=UTF8&psc=1
You may find additional information on the hardware and starter kit on our MG100 product page.
▪https://www.lairdconnect.com/iot-devices/iot-gateways/sentrius-mg100-gateway-lte-mnb-iot-and-bluetooth-5

https://www.lairdconnect.com/
5
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
The Sentrius™MG100 uses the Zephyr RTOS as its operating system. You can use various IDEs, but the widely recommend
setup is with Microsoft’s VS Code and the PlatformIO plugin. These are available on Windows, MacOS, and Linux. Follow the
link below for a guide on how to set up an IDE.
▪https://www.zephyrproject.org/developing-zephyr-rtos-embedded-applications-on-platformio-and-simulating-on-antmicro-
renode/
To get the remaining necessary tools to develop, build, and flash a Zephyr application you’ll want to follow the latest Getting
Started Guide on the official Zephyr project.
▪https://docs.zephyrproject.org/latest/getting_started/index.html#
Other prerequisites for software are as follows.
▪mcumgr CLI (cross platform)
▪Sentrius MG100 device running AWS OOB demo firmware v3.x or greater
▪Terminal program: PuTTY (Windows, Linux, macOS), Teraterm (Windows), Serial (macOS)
You can find additional software information for the firmware and the out of box demo at the following locations on GitHub.
▪https://github.com/LairdCP/Pinnacle-100-Firmware
▪https://github.com/LairdCP/Pinnacle_100_oob_demo
The Sentrius MG100 has the hardware features depicted below.

https://www.lairdconnect.com/
6
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Please note that the Sentrius MG100 typically comes with a pre-installed MVNO-based SIM card for LTE-M or NB-IoT
connectivity. You may need to activate this SIM card via the MVNO’s website with your personal or business account. You
may also choose to use your own MNO or MVNO SIM card. In this case, unscrew the 4 screws on the back of the device and
separate the back from the front of the enclosure. Then remove the 2 screws holding the Pinnacle 100 modem in place.
Remove the modem and flip it over. Here you will find the SIM card slot.

https://www.lairdconnect.com/
7
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
The device is plug-and-play compatible on any Windows, Linux, or Mac system via a USB to Micro USB cable and your
favorite terminal program such as minicom, PuTTY, or Teraterm.
To connect to the device, identify the correct COM port on your host machine and then use the following serial settings.
Figure 1: MG100 terminal settings
Finally, turn on the device by flipping the power switch to the right side. In this case the device is “off” when the power switch is
set to the left position and it is “on” when the power switch is set to the right position. If the terminal is connected, you’ll see the
MG100 booting up and displaying debug information in the terminal.
Refer to the instructions at Set up your AWS Account. Follow the steps outlined in these sections to create your account and a
user and get started:
▪Sign up for an AWS account and
▪Create a user and grant permissions.
▪Open the AWS IoT console
Pay special attention to the notes in the AWS documentation.
Refer to the instructions at Create AWS IoT Resources. Follow the steps outlined in these sections to provision resources for
your device:
▪Create an AWS IoT Policy
▪Create a thing object
Pay special attention to the notes in the AWS documentation.
To provision your device with the proper credentials, follow the instructions in our BLE gateway firmware documentation.
▪https://lairdcp.github.io/guides/ble-gateway-firmware/1.0/docs/aws_iot#configure-device-for-aws-connection
The MG100 arrives pre-flashed with the demo app, but you may need to update to the latest version. This will require you to
flash the device. The latest software releases can be found here, along with instructions on how to flash the device.
▪https://github.com/LairdCP/Pinnacle-100-Firmware/releases

https://www.lairdconnect.com/
8
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
To verify this demo works and MQTT messages are being received by AWS IoT Core, follow the instructions on our
documentation site.
▪https://lairdcp.github.io/guides/ble-gateway-firmware/1.0/docs/aws_iot#monitor-aws-messages
To access the console or serial port of the device, plug in a USB to Micro USB cable between your PC and the MG100. Next
use your favorite serial or terminal program with the following settings to initiate a proper connection as explained in Set up
your hardware.
Figure 2: MG100 terminal settings
At initial boot up you will be presented with a command line interface as well as debug output. The command line interface has
an interactive help menu to guide you through the various commands and parameters you can use.

https://www.lairdconnect.com/
9
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Figure 3: MG100 terminal output
To enable logging use the command:
# log go
To disable logging use the command:
# log halt
To leverage the interactive help menu use the command:
# help
Note: There is only one level of logging on the device. However, you can enable or disable logging for specific software
modules of the device as seen below.
Figure 4: log command help on the MG100

https://www.lairdconnect.com/
10
© Copyright 2022 Laird Connectivity
All Rights Reserved
Americas: [phone]
Europe: [phone]
Hong Kong: [phone]
Problems may arise as you go through development and testing. Below are some commons issues and their solutions.
▪Device will not connect to a network.
–Ensure that your SIM card is inserted properly.
–Validate that the SIM card is active with your MNO/MVNO provider and has data allotted to it.
–Verify that the APN is set correctly.
▪Device will not connect to AWS.
–Check to see if you have the correct AWS endpoint set.
–Verify that you have the proper certificates and keys loaded to the device.
–Validate that you have the correct IoT Core thing and policies in place on AWS.