Sentrius MG100 + BT510 Starter Kit
Overview
EOL Notice: The MG100 + BT510 IoT Starter Kit is EOL as of Nov 18, 2022. See our EOL Notice for more details.
Ezurio's Sentrius™ MG100 + BT510 IoT Starter Kit contains everything you need to start sending Bluetooth 5 Sensor data over LTE to the cloud! It contains the following:
- 1x Sentrius MG100 Wireless IoT Gateway with global power supplies
- 3x Sentrius BT510 – Long-range Bluetooth 5 temperature, motion, and open door sensor
- Ezurio's (formerly Laird Connectivity) free AWS-based IoT monitoring platform
- Sentrius IG Connect - iOS and Android mobile app for fast, in-field provisioning
- Global AC and DC power adapters
Use cases include cold chain transportation monitoring, predictive maintenance, and industrial IoT.
Specifications
Verizon
Vodafone
MicroSD slot (SDHC, SD Card 2.0)
NFC
SD card support
NB-IoT
Bluetooth 5
NFC
Part Number | Additional Description |
---|---|
455-00120 End of Life (EOL) Buy Now | MG100 + BT510 Bluetooth 5 Starter Kit - 1x MG100 Gateway and 3x BT510 Sensors |
Documentation
Name | Part | Type | Last Updated |
---|---|---|---|
Product Brief - MG100 Gateway | All | Product Brief | 02/28/2024 |
Product Brief - BT510 | All | Product Brief | 09/09/2024 |
Application Note - MG100 IP6x COTS Housing Recommendation | All | Application Note | 06/24/2021 |
PCN 8O-2021 - MG100 / Pinnacle 100 / MG100-BT510 Starter Kit | All | Legacy Material | 12/16/2022 |
Getting Started with AWS IoT Core - MG100 | All | Legacy Material | 12/16/2022 |
EOL Notice - IoT Starter Kits - Nov 2022 | All | Documentation | 11/23/2022 |
I'm having trouble transferring scripts to my Canvas enabled device, what should I do?
To reliably transfer files,
your python app cannot be in a loop or printing any messages. Follow the steps provided below to ensure reliable file transfers.
- Open
the UART and issue Ctrl+C.
- You
should now have a REPL prompt.
- Open
the UART with Xbit VS Code.
- Rename
main.py to something else and reboot.
- Now you
can transfer files.
- Important Note: To have
a reliable file transfer experience, reduce the print messages in your
python app, the file transfer is over this UART so cross talk must be eliminated.
How can I see more verbose modem output when using the Canvas net_helper.py?
If you would like verbose output from the modem, change the bool on this function to "true":
How do I set the APN when using Canvas Firmware?
The APN is set in your main.py script. The script linked below is the minimum modem configuration:
https://github.com/LairdCP/canvas_python_samples/blob/main/networking/modem/modem_minimal.py
This function call is for setting the APN:
https://lairdcp.github.io/canvas_python_docs/canvas_net.html#canvas_net.Modem.set_apn
Can I use mcumgr with WSL or GitBash?
Many functions of mcumgr will not work with WSL
or GitBash. Serial communication isn't fully vetted with
these terminal emulators. When using Windows, it's best to use
mcumgr in the "command prompt" app.
Where can I find the firmware manifest for Canvas device management enabled firmware?
Below is a link to the manifest:
I'd like to lower the power usage of the MG100. What codebase should I look at to get started?
The low power sample manifest can be used to evaluate low_power modes of the Pinnacle 100:
Why is my MG100 resetting? Can I disable the watchdog?
The attribute "mqtt_watchdog" should be set to a value appropriate to your use case. If no MQTT activity is detected for that value, then the device will reset. A value of 0 disables the watchdog feature.
What are the licensing requirements/restrictions if we decide to base our product's firmware on Canvas.
The firmware is licensed that it must run on Ezurio hardware.
Follow this link for more details: License
What happens when battery or temp sense is set to a zero value?
When the Temperature Sense Interval is set to 0, temperature measurements are stopped, although there will be 1 one more measurement when the value is changed.
When the Battery Sense Interval is set to 0, battery measurements are stopped. Note there is a power fail circuit built into the device that constantly monitors the battery level. Even if the Battery Sense Interval is set to 0, and the battery level drops below the failure level, a battery fail event will still be advertised.
Where are the keys located in the lfs?
Root CA and public device cert keys:
/lfs1/tel/trust/ca.crt
/lfs1/tel/trust/cert.crt
Private/public key:
/lfs1/enc/tel/key/private.key
/lfs1/enc/tel/key/public.key
Is the TLS handshake performed by the Modem or the MCU?
The TLS handshake is handled
by the stack in the nrf52820, not the HL7800.
How do I update the modem firmware on the MG100?
To update the modem firmware, follow the steps in this document:
Updating HL7800 Firmware Via UART
Firmware can be downloaded directly from Sierra Wireless.
https://source.sierrawireless.com/resources/airprime/software/hl7800-firmware/hl78xx-firmware/
After you select the updated firmware version, download the XMODEM package. Firmware updates are diff updates. The XMODEM package has the diff files used to load into the MG100 and update the HL7800. You need to know what version you are currently running and then you can select the file that goes from the current firmware to the new one.
How can you clean the Zephyr build?
If you would like to clean your Zephyr build use the "-p" switch for pristine, or when all else fails delete the build directory.
How do I launch menuconfig for Zephyr?
If you would like to launch "menuconfig" for your Zephyr build, add "-t menuconfig" to the end of your build command.
For example:
west build -p -b mg100 -d ble_gateway_dm_firmware/build/mg100 ble_gateway_dm_firmware -- -DAPP_TYPE=mqtt -t menuconfig
For more information:
Interactive Kconfig interfaces — Zephyr Project Documentation
How can I determine the MG100 or Pinnacle100 Modem Signal Strength?
If you would like to see the Modem's signal strength it can be viewed using the "attr get lte_rsrp" command.
What is the Project Zephyr Discord?
There's a Zephyr RTOS Discord channel. This is a great place to ask questions and have them answered by the engineers who wrote the software. There's even a channel for HL7800!
Using STTY with the USB-SWD
These instructions are intended for Linux or Macintosh OS. They may work using WSL, Cigwin, or other bash style terminals in Windows although this is untested.
It may be desired to communicate with a device attached to the USB-SWD without terminal emulation, I.E. Picocom, Screen, Putty. This can be useful for writing bash scripts, or if you're using Zephyr's "west flash" and would like a quick way to check your output.
- Verify you have the program "stty" available using the command "which stty", if this does not return a value you will need to install it. Fortunately "stty" generally comes standard with Linux and MacOS.
- Identify your serial device. This can be done using the command "dmesg -w" then connecting the USB-SWD. You will see output like this (In Linux).
- (Optional) Assign the device name to a variable, for example "DEVICE=/dev/ttyACM0".
- Configure "stty" to talk with the device "stty -F $DEVICE 115200 -echo -echoe -echok"
- To see output from the device execute "cat $DEVICE &". This will send serial communication from the device to Linux's standard output. The "&" is to run this program in the background.
- Now press the reset button on the USB-SWD, you should see the output from your device. In this example the Zephyr "Hello World" example has been flashed to a BT510.
- (Optional) if you would like to send commands back to the device you can use "echo" or add an argument to your shell, "foo() { echo -n -e "$1\r" > $DEVICE; }". Now commands can be issued directly from the command line, for example "foo "my_command"" will send the string "my_command" to the device.
Can I use a different magnet to trigger the BT510 sensor magnet switch?
Technically any magnet with sufficient field strength and proper field orientation can be used.
The magnet sensor used in the BT510 is a magnetoresistive sensor and hence the sensitive axis is in the sensor plane (other than for hall sensors where the sensitive axis is perpendicular to the sensor plane). Below picture indicates the sensitive axis. The sensor is NOT sensitive to the direction of the field!
More information about sensitivity and orientation recommendations from the sensor chip perspective is in the SM351LT data sheet. The below picture summarizes the most important aspects. It also shows the orientation of the sensor chip relative to the BT510 enclosure. The magnet coming with the BT510 is a rod-style magnet with axial magnetization and hence the field lines go from the short sides (top/bottom) of the magnet (more or less parallel) along the long sides of the magnet like indicated in the “magnet movement” section of the picture. This orientation ensures the field lines penetrating the sensor chip mainly along its sensitive axis. One can also see that rotating the magnet by 90° would lead to the field lines penetrating the sensor chip perpendicular to the sensitive axis and hence not generate any signal.
When selecting a different magnet than the standard BT510 magnet both field strength and orientation needs to be taken into account. A magnet with higher field strength can cover a larger operating distance to trigger the magnet switch.
There exist a lot of standard round magnets on the market often used to stick/fix something onto metal surfaces and hence the magnetization is not critical and works for any magnetization type (like axial, vertical, diametrical…). However, often the magnetization type is not even specified for a particular magnet and cheap ones (like used for white boards) sometimes even have several magnetic poles in parallel over the area of the magnet. This actually helps for the common use-case of sticking well to metal surfaces but makes them quite unusable for reliably and reproducibly triggering a sensor chip.
How to best orientate your round magnet to get stable sensor near/far readings would depend on how the magnet is being magnetized and how the magnetic field lines would penetrate the sensor chip when applied. If the magnetization is unknown a magnetic field viewer (aka flux detector/viewer) can be used to "see" the magnetic poles and get the orientation of field lines.
The general advice would be to either use a rod-style magnet with axial magnetization in the above shown orientation or a round magnet with known magnetization type and then positioned in a way so that the field lines penetrate the sensor in its most sensitive axis. To ensure this, the magnetization of the magnet must be known before mounting.
How do I get started with Memfault?
Laird customers get instant access to Memfault's device observability platform for up to 100 devices free forever. To get started with Memfault for remote debugging, continuous monitoring, and OTA firmware updates, sign up here.
- Pinnacle 100 Modem Memfault Integration Guide
- With additional integration and configuration, Memfault can also be used with any Laird connected device, contact your FAE or Memfault for more information.
How can I diagnose and debug crashes and other issues with devices remotely without an FAE on-site?
You can use Memfault to remotely monitor the health of their devices and debug issues in both the Pinnacle 100 and MG100 Gateway designs. Laird customers get instant access to Memfault for up to 100 devices free forever.
- Sign up here and follow the steps on the Pinnacle 100 Modem Memfault Integration Guide to get started with Memfault.
- With additional integration and configuration, Memfault can also be used with any Laird embedded device, contact your FAE or Memfault for more information.
How can I measure the performance and health of my Pinnacle 100 / MG100 devices once they're in production?
For analyzing overall performance patterns in your fleet, metrics can easily be collected using our Memfault integration with the Pinnacle 100 and Sentrius MG100. Laird customers get instant access to Memfault for up to 100 devices free forever.
- Sign up here and follow the steps on the Pinnacle 100 Modem Memfault Integration Guide to get started with Memfault.
- With additional integration, Memfault can also be used with any Laird embedded device, contact your FAE or Memfault for more information.
Where are the instructions for the Out-Of-Box Demo for the Pinnacle 100/MG100 cellular gateways?
Everything needed to get started with our Out of the Box Demos for the Pinnacle 100 cellular modem and the MG100 cellular gateway can be found on GitHub
These links is also made available on the Pinnacle 100 Product Page in the Documentation section under Software.A demo video for the Pinnacle 100 is also linked on the Product page for additional reference.
Do I need to build the OOB Demo to evaluate the Pinnacle100?
You do not need to build the OOB Demo on your own, if you have need to upgrade your OOB Demo version on your Pinnacle 100 modem or MG100 gateway, please use our official releases found here: https://github.com/LairdCP/Pinnacle-100-Firmware/releases.
Found at this link are several firmware file types depending on how you plan to upgrade, *.hex is for SWD while *.bin is used for BLE, UART, and HTTP over LTE. Additionally, 480-00052 is for the Pinnacle 100 and 480-00070 is for the MG100.
See the Firmware Updates section for how to upgrade over the different interfaces, BLE/UART/HTTP over LTE
To upgrade over SWD, use the JLINK USB port on the Pinnacle 100 DVK board, for the MG100 see the MG100 Hardware Guide section 5.4.4 to learn how to connect a J-Link debugger to the board for the upgrade using nRF Connect or Nordic Command Line Tools.
On Windows 10 when building firmware such as oob_demo firmware I am getting the following error: ninja: error: FindFirstFileExA(c/:/oob_demo/oob_demo/src): The filename, directory name, or volume label syntax is incorrect can you help me to correct this?
On Windows 10 when building firmware such as oob_demo firmware I am getting the following error: ninja: error: FindFirstFileExA(c/:/oob_demo/oob_demo/src): The filename, directory name, or volume label syntax is incorrect can you help me to correct this?
The ninja: error: FindFirstFileExA(c/:/oob_demo/oob_demo/src): The filename, directory name, or volume label syntax is incorrect, may be thrown if you have previously set up a Zephyr environment. This indicates ninja needs to be upgraded. If west update did not update ninja to the latest version enter choco upgrade ninja --force
in cmd.exe as administrator to force the upgrade:
C:\Windows\system32>choco upgrade ninja --force
Is the BT510 sensor battery replaceable?
Yes, the BT510 Sentrius™ BT510 sensor is replaceable by removing the rear battery door cover.
The battery is a 3-volt lithium of CR2477 type.
The battery door cover has a gasket inside to keep out liquids.
How can I extend the range of the BT510 Sensor?
The Sentrius™ BT510 sensors range is dependent on a number of factors some of which are under user control.
You can configure a sensor using a Bluetooth connection and the Laird virtual serial port(vSP) service. The protocol sent over the virtual serial port is JSON-RPC version 2.This allows you to add new commands and features without changing the Bluetooth interface.
This includes being able to configure
- Tx power
- LE Coded (Long Range) PHY
More details are available via the BT510 user guide.
It is also possible to extend the range of the BT510 using the Laird BL654 Repeater/gateway smartbasic programs this allows the Laird BL654 module to function as a repeater or gateway for adverts from Laird’s BT510 sensors. It can also operate in AT mode where it can advertise, scan, connect, and offer GATT client and server capabilities. This application is controlled with the industry standard AT command protocol over a UART interface.
- BT510 Repeater Mode–The module listens for adverts from Laird’s BT510 sensors or other BT510 repeaters and rebroadcasts over the air so that a range extension can be facilitated. All other adverts are ignored.
- BT10 Gateway Mode–The module listens for adverts from Laird’s BT510 orBT510 Repeaters and sends them out in hex format over the UART interface so that a host can process them. It could forward to the cloud if it has the appropriate connectivity. All other adverts are ignored.
- Generic BLE Client/Server Mode–The module can be made to advertise, scan, connect, and pair. In addition, it can enable the creation of a GATT server table on-the-fly and, conversely can be a GATT client to interact with remote GATT servers.
More details are available via the BT510 Repeater/Gateway user guide.
The source code for all of these applications is hosted on our GitHub page:
Can I access the accelerometer data in the BT510 sensor?
The Sentrius™ BT510 advertises events. An event can be a temperature measurement, an alarm ,a battery measurement, a button press, a door opening/closing, or movement. The configuration of a sensor determines what kind of events it generates.
Access to accelerometer values is not possible but it is possible to configure the accelerometer sensitivity. You can configure a sensor using a Bluetooth connection and the Laird virtual serial port (VSP) service. The protocol sent over the virtual serial port is JSON-RPC version 2. This allows you to add new commands and features without changing the Bluetooth interface. The BT510 accelerometer creates a movement event.
More details can be found in the BT510 user guide.
Can the BT510 sensor use BLE LE Coded Phy (Long range)?
Yes!
You can configure a sensor using a Bluetooth connection and the Laird virtual serial port(vSP) service. The protocol sent over the virtual serial port is JSON-RPC version 2. This allows you to add new commands and features without changing the Bluetooth interface.
This includes being able to change the PHY to LE coded for long range applications.
The Laird BT510 smartphone applications allows a user to select LE Coded PHY.
LE Coded PHY can also be selected from your own smartphone application using JSON over VSP BLE connections.
Details can be found in the BT510 user guide
Can I program the BT510 myself?
Out of the box the BT510 is configured via a smartphone app but this does not allow a developer to reprogram the BT510. However the BT510 can be programmed by a developer using Zephyr in C. More details can be found at the following link.
The Zephyr OS is based on a small-footprint kernel designed for use on resource-constrained and embedded systems: from simple embedded environmental sensors and LED wearables to sophisticated embedded controllers, smart watches, and IoT wireless applications.
Is there a programming cable available for the BT510 Sensor?
The BT510 sensor is configured using a smartphone via BLE out of the box. It is also possible for a developer to load their own C code onto the BT510 via a programming cable.
The BT510 board does not have an on-board J-Link debug IC as some nRF5x development boards, however, instructions from the Nordic nRF5x Segger J-Link; page also apply to this board, with the additional step of connecting an external debugger.
Ezurio will provide the USB-SWD programming board that supports this connector layout, refer to the USB SWD Programmer product page
What IDE can I use with Zephyr for development and debug on the Pinnacle 100 or other Nordic-based modules?
We suggest using Visual Studio Code, please see the following for more information: https://github.com/LairdCP/Pinnacle_100_oob_demo/blob/master/docs/development.md
- We suggest using Memfault for an out-of-the-box fault debugging and device observability solution. Memfault integrates seamlessly with Zephyr on the Pinnacle 100 and Sentrius MG100. Laird customers get instant access to Memfault for up to 100 devices free forever.
- Sign up here and follow the steps on the Pinnacle 100 Modem Memfault Integration Guide to get started with Memfault.
- With additional integration and configuration, Memfault can also be used with any Laird embedded device, contact your FAE or Memfault for more information.
Become an Ezurio Customer to Gain Exclusive Access to Our Design Experts
- Antenna Scans
- Antenna selection and placement
- Custom antenna design
- Worldwide EMC testing / certifications
- Embedded RF hardware / firmware design
- Cloud architecture and integration
- Mobile application development
- Product & Industrial Design
Distributors
Distributor | Phone Number | Region | Website |
---|---|---|---|
Arrow Electronics | 1-855-326-4757 +44 2039 365486 |
APAC, North America, South America, EMEA | Website |
Avnet | 1-480-643-2000 +44 1628 512900 |
APAC, North America, South America, EMEA | Website |
Braemac Australia, New Zealand, South East Asia | +61 2 9550 6600 +64 9 477 2148 |
APAC | Website |
Cal-Chip Connect | 1-215-942-8900 |
North America | Website |
DigiKey | 1-800-344-4539 |
North America, South America, APAC, EMEA | Website |
EBV Elektronik | EMEA | Website | |
Farlink Technology China, Hong Kong | +86 13266922199 |
APAC | Website |
Farnell | 1-800-936-198 +44 3447 11 11 22 |
EMEA | Website |
Future Electronics | 1-800-675-1619 1-514-428-8470 |
North America, South America, APAC, EMEA | Website |
Glyn | +49-6126-590-0 |
EMEA | Website |
Hy-Line Germany Only | +49 89 614 503 0 |
EMEA | Website |
Jetronic China, Hong Kong and Taiwan | 852-27636806 |
APAC | Website |
Laird Connectivity | 1-847-839-6925 +44 1628 858941 |
North America, South America, APAC, EMEA | Website |
M2M Germany | +49-6081-587386-0 |
EMEA | Website |
Martinsson | +46 8 7440300 |
EMEA | Website |
McCoy South East Asia | +65 6515 2988 |
APAC | Website |
Mouser | 1-800-346-6873 +44 1494 427500 |
North America, South America, APAC, EMEA | Website |
RS Components | +852-2421-9898 +44 3457-201201 |
North America, South America, APAC, EMEA | Website |
Ryoyo Japan | +81-3-3543-7711 |
APAC | Website |
Solsta UK Only | +44 (0) 1527 830800 |
EMEA | Website |
Supreme Components International India, South East Asia | +65 6848-1178 |
APAC | Website |
Symmetry Electronics | 1-866-506-8829 |
North America | Website |
Tekdis Australia and New Zealand | +61 3 8669 1210 |
APAC | Website |
Telsys | +972 3 7657666 |
EMEA | Website |
WPG | +44 1628 958460 |
EMEA | Website |