Sentrius IG60-BL654 + BT510 Starter Kit (+ optional LTE)

IP stands for Ingress Protection. Its a standard we use to check the sealability of a product once it is installed.

It is composed as IP## , where first digit is for dust/solid objects and the 2nd digit, is for liquids.
Here is the meaning for each numerical code:

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.

Laird Connectivity will provide the USB-SWD programming board that supports this connector layout, refer to the USB SWD Programmer product page

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:

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.

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

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.

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.

Yes. There is a python script on the IG60-BL654 LL developer SD card image called
btpa_firmware_loader.py

This can be used to upload a new firmware to the BL654 inside IG60-BL654 LL.

The Sentrius™ BT510 is a Bluetooth 5 Low Energy multi-sensor and can last for months or years on its replaceable coin-cell battery. That battery life is dependent on lots of factors such as sleep time, ambient temperature, and more.

To estimate how long your BT510 application can go on a single battery, adjust the values at the BT510 battery life estimator

There exist pre-defined GPIOs in the IG60 to control the BL654 module, which can be found under /sys/devices/platform/gpio:

• bt_nautorun: If set to 0 (low) autorun is active and and $autorun$ application will start after power up/reset and if set to 1 (high) autorun will be disabled.
• card_nreset: Setting to 0 (low) asserts BL654 reset and 1 (high) releases reset.

To exit an $autorun$ application nAUTORUN needs to be set high followed by a module reset.

echo 1 > /sys/devices/platform/gpio/bt_nautorun/value (disables autorun)
echo 0 > /sys/devices/platform/gpio/card_nreset/value (assert reset)
echo 1 > /sys/devices/platform/gpio/card_nreset/value (release reset)
echo 0 > /sys/devices/platform/gpio/bt_nautorun/value (re-enable autorun)

You should now be able to connect to the BL654 through e.g. microcom with access to the smartBASIC interactive mode:

microcom -s 115200 /dev/ttyS2

You can now use e.g. AT&F* to clear the flash file system before loading a new smartBASIC app to the module with the above Python script. (Note: CTRL-x will exit microcom).

Note: You can always check the current state of the above GPIOs with

cat /sys/devices/platform/gpio/.../value

See also the IG60-BL654 online documentation.

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.

On the LairdLinux versions of the IG60 (455-00006, 455-00076, 455-00084 or 455-00088) you can access the console port by either attaching a USB to Serial adapter to the IG60 USB port and a null modem cable to your computer or by attaching a USB to serial cable to the IG60 USB port and a null modem adapter to your computer.

Also on the IG60-Serial (455-00006) or the IG60-Serial+LTE (455-00084), you can connect a null modem cable to the serial port on the IG60 and your computer.  

Note: You are not able to access the console on a GreenGrass version of the IG60 (455-00008, 455-00081, 455-00085 or 455-00089).