Laird Sentrius mg100 User manual

Version 1.0

https://www.lairdconnect.com/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

Version

Date

Notes

Contributors

Approver

1.0

18 Nov 2021

Initial Release

Mark Calhoun

Andy Ross

https://www.lairdconnect.com/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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/

Americas: +1-800-492-2320

Europe: +44-1628-858-940

Hong Kong: +852-2762-4823

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.

Other manuals for Sentrius MG100

Other Laird Gateway manuals

Laird

Laird Sentrius RG191+LTE User manual