2020-08-06 09:29:16 +01:00
.. _bt510:
2024-06-04 09:10:44 -05:00
Ezurio Sentrius BT510 Sensor
############################
2020-08-06 09:29:16 +01:00
Overview
***** ***
The Sentrius™ BT510 Sensor is a battery powered, Bluetooth v5 Long Range integrated sensor that uses a Nordic Semiconductor nRF52840 ARM Cortex-M4F CPU.
The sensor has the following features:
* :abbr: `ADC (Analog to Digital Converter)`
* CLOCK
* FLASH
* :abbr: `GPIO (General Purpose Input Output)`
* :abbr: `I2C (Inter-Integrated Circuit)`
* :abbr: `MPU (Memory Protection Unit)`
* :abbr: `NVIC (Nested Vectored Interrupt Controller)`
* :abbr: `PWM (Pulse Width Modulation)`
* RADIO (Bluetooth Low Energy and 802.15.4)
* :abbr: `RTC (nRF RTC System Clock)`
* Segger RTT (RTT Console)
* :abbr: `UART (Universal Asynchronous Receiver-Transmitter)`
* :abbr: `WDT (Watchdog Timer)`
.. figure :: img/bt510.jpg
:align: center
:alt: Sentrius BT510 Sensor, front view
Sentrius BT510 Sensor, front view
.. figure :: img/bt510_back.jpg
:align: center
:alt: Sentrius BT510 Sensor, rear view
Sentrius BT510 Sensor, rear view
More information about the board can be found at the
`Sentrius BT510 website`_ .
Hardware
***** ***
Supported Features
==================
The BT510 Sensor supports the following
hardware features:
+-----------+------------+----------------------+
| Interface | Controller | Driver/Component |
+===========+============+======================+
| ADC | on-chip | adc |
+-----------+------------+----------------------+
| CLOCK | on-chip | clock_control |
+-----------+------------+----------------------+
| FLASH | on-chip | flash |
+-----------+------------+----------------------+
| GPIO | on-chip | gpio |
+-----------+------------+----------------------+
| I2C(M) | on-chip | i2c |
+-----------+------------+----------------------+
| MPU | on-chip | arch/arm |
+-----------+------------+----------------------+
| NVIC | on-chip | arch/arm |
+-----------+------------+----------------------+
| PWM | on-chip | pwm |
+-----------+------------+----------------------+
| RADIO | on-chip | Bluetooth, |
| | | ieee802154 |
+-----------+------------+----------------------+
| RTC | on-chip | system clock |
+-----------+------------+----------------------+
| RTT | Segger | console |
+-----------+------------+----------------------+
| UART | on-chip | serial |
+-----------+------------+----------------------+
| WDT | on-chip | watchdog |
+-----------+------------+----------------------+
Connections and IOs
===================
LED
---
2021-01-18 09:42:13 +00:00
Two LEDs are visible through the BT510 housing lid.
* LED_1A (green) = P0.22
* LED_1B (red) = P0.20
2020-08-06 09:29:16 +01:00
Push button
------------
2021-01-18 09:42:13 +00:00
The BT510 housing lid also acts as a push button.
* BUTTON_1 = SW1 = P1.10
Magnetoresistive sensor
-----------------------
The BT510 incorporates a Honeywell SM351LT magnetoresistive sensor. Refer to the `Honeywell SM351LT datasheet`_ for further details.
* MAG = P1.14
Accelerometer
-------------
The BT510 incorporates an I2C ST Microelectronics LIS2DH accelerometer. Refer to the `ST Microelectronics LIS2DH datasheet`_ for further details.
* SDA = P0.26
* SCL = P0.27
* INT_1 = P1.05
* INT_2 = P1.12
Temperature Sensor
------------------
The BT510 incorporates an I2C Silabs SI7055 temperature sensor. Refer to the `Silabs 7055 datasheet`_ for further details.
* SDA = P0.26
* SCL = P0.27
2020-08-06 09:29:16 +01:00
Programming and Debugging
***** ***** ***** ***** *****
2021-01-06 17:01:24 -08:00
Applications for the `` bt510 `` board configuration can be built, flashed, and
debugged in the usual way. See :ref: `build_an_application` and
:ref: `application_run` for more details on building and running.
2020-08-06 09:29:16 +01:00
The BT510 features a TagConnect 10 way socket for connection of a
programmer/debugger, refer to `TagConnect TC2050 product page`_
for details of an appropriate TagConnect cable.
A non-standard layout is used to include access to the sensor debug UART.
+-----------+------------+----------------------+
| Pin No. | Name | Description |
+===========+============+======================+
| 1 | Vcc | Power Supply, 3.3V |
+-----------+------------+----------------------+
| 2 | SWDIO | SWD Data |
+-----------+------------+----------------------+
| 3 | RXD | Debug UART RX Data |
+-----------+------------+----------------------+
| 4 | SWDCLK | SWD Clock |
+-----------+------------+----------------------+
| 5 | TM | Spare GPIO |
+-----------+------------+----------------------+
| 6 | SWO | SWD Output |
+-----------+------------+----------------------+
| 7 | N/C | Not Connected |
+-----------+------------+----------------------+
| 8 | TXD | Debug UART TX Data |
+-----------+------------+----------------------+
| 9 | GND | Ground |
+-----------+------------+----------------------+
| 10 | RESET | Reset, Active Low |
+-----------+------------+----------------------+
Connectivity to the programmer/debugger must be modified to match
the pinout shown above.
2024-06-04 09:10:44 -05:00
Ezurio provide the USB-SWD programming board (750-03239) that supports
2020-08-06 09:29:16 +01:00
this connector layout, refer to the `USB SWD Programmer product page`_
.
Flashing
========
2021-03-08 07:29:02 +00:00
To connect the BT510 board for programming or debugging using the USB-SWD programming
board, on the programming board set SW6 to the supply out position and SW5 to the 3V3
position, ensure there is a jumper on J35 and that SW1 is in the debug position, then
connect the BT510 to the board using the Tag-Connect cable via J3:
boards: convert images to JPEG and reduce image size
The boards folder uses ~142.8 MB, being the largest in the repository.
This is due mostly to board images, which are in most cases not
optimized for web content. This patch tries to address this problem by
converting all pictures to JPEG (quality 75) and by adjusting its size
up to 750 px (the width of the documentation content). Images that
specified a fixed width in rst files are converted down to that value
instead.
With this patch, folder goes down to ~53.5 MB from 142.8 MB (-~63%).
Note that this patch introduces a new set of binary files to git
history, though (bad).
The process has been automated using this quickly crafted Python script:
```python
from pathlib import Path
import re
import subprocess
def process(doc, image, image_jpeg, size):
subprocess.run(
(
f"convert {image}"
"-background white -alpha remove -alpha off -quality 75"
f"-resize {size}\> {image_jpeg}"
),
shell=True,
check=True,
cwd=doc.parent,
)
if image != image_jpeg:
(doc.parent / image).unlink()
for doc in Path(".").glob("boards/**/*.rst"):
with open(doc) as f:
content = ""
image = None
for line in f:
m = re.match(r"^(\s*)\.\. (image|figure):: (.*)$", line)
if m:
if image:
process(doc, image, image_jpeg, size)
image = Path(m.group(3))
if image.suffix not in (".jpg", ".jpeg", ".png"):
content += line
image = None
continue
image_jpeg = image.parent / (image.stem + ".jpg")
size = 750
content += (
f"{m.group(1)}.. {m.group(2)}:: {image_jpeg}\n"
)
elif image:
m = re.match(r"\s*:height:\s*[0-9]+.*$", line)
if m:
continue
m = re.match(r"\s*:width:\s*([0-9]+).*$", line)
if m:
size = min(int(m.group(1)), size)
continue
content += line
if line == "\n":
process(doc, image, image_jpeg, size)
image = None
else:
content += line
with open(doc, "w") as f:
f.write(content)
```
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-08-16 13:05:36 +02:00
.. figure :: img/bt510_prog.jpg
2021-03-08 07:29:02 +00:00
:align: center
:alt: Sentrius BT510 Sensor connected to programming board
Sentrius BT510 Sensor connected to programming board
Then build and flash applications as usual (see :ref: `build_an_application` and
:ref: `application_run` for more details). For example, to flash:
.. code-block :: console
$ ninja flash
2020-08-06 09:29:16 +01:00
Here is an example for the :ref: `hello_world` application.
First, run your favorite terminal program to listen for output.
NOTE: On the BT510, the UART lines are at TTL levels and must be passed through
an appropriate line driver circuit for translation to RS232 levels. Refer to the `MAX3232 datasheet`_
2021-03-08 07:29:02 +00:00
for a suitable driver IC. The USB-SWD programming board has an in-built UART connected
to the BT510 acting as a USB CDC port, on Linux and Windows 10 this driver should be
installed automatically, for Windows 7, the MBED driver is required to use the serial
port - see the `MBED Serial Driver`_ link for details and how to install the driver.
2020-08-06 09:29:16 +01:00
.. code-block :: console
$ minicom -D <tty_device> -b 115200
2021-03-08 07:29:02 +00:00
Replace :code: `<tty_device>` with the port where the bt510 can be found. For example, under Linux, :code: `/dev/ttyACM0` .
2020-08-06 09:29:16 +01:00
Then build and flash the application in the usual way.
.. zephyr-app-commands ::
:zephyr-app: samples/hello_world
:board: bt510
:goals: build flash
Note that an external debugger is required to perform application flashing.
Debugging
=========
The `` bt510 `` board does not have an on-board J-Link debug IC
as some nRF5x development boards, however, instructions from the
:ref: `nordic_segger` page also apply to this board, with the additional step
2021-03-08 07:29:02 +00:00
of connecting an external debugger. The USB-SWD programmer board has a CMSIS debugger
compatible interface and debugging can be performed using pyocd, openocd or any other
applications that support the CMSIS interface.
2020-08-06 09:29:16 +01:00
Testing Bluetooth on the BT510
***** ***** ***** ***** ***** ***** *****
Many of the Bluetooth examples will work on the BT510.
Try them out:
2024-08-29 17:32:37 +02:00
* :zephyr:code-sample: `ble_peripheral`
* :zephyr:code-sample: `bluetooth_eddystone`
* :zephyr:code-sample: `bluetooth_ibeacon`
2020-08-06 09:29:16 +01:00
Testing the LEDs and buttons on the BT510
***** ***** ***** ***** ***** ***** ***** ***** *
There are 2 samples that allow you to test that the buttons (switches) and LEDs on
the board are working properly with Zephyr:
2023-09-05 23:58:56 +02:00
* :zephyr:code-sample: `blinky`
* :zephyr:code-sample: `button`
2020-08-06 09:29:16 +01:00
You can build and flash the examples to make sure Zephyr is running correctly on
2021-01-18 09:42:13 +00:00
your board. The button, LED and sensor device definitions can be found in
2024-06-04 09:10:44 -05:00
:zephyr_file:`boards/ezurio/bt510/bt510.dts`
2020-08-06 09:29:16 +01:00
References
***** *****
.. target-notes ::
2024-06-04 09:10:44 -05:00
.. _Sentrius BT510 website: https://www.ezurio.com/iot-devices/iot-sensors/bt510-bluetooth-5-long-range-ip67-multi-sensor
2020-08-06 09:29:16 +01:00
.. _TagConnect TC2050 product page: https://www.tag-connect.com/product/tc2050-idc-050
2024-06-04 09:10:44 -05:00
.. _USB SWD Programmer product page: https://www.ezurio.com/wireless-modules/programming-kits/usb-swd-programming-kit
2020-08-06 09:29:16 +01:00
.. _MAX3232 datasheet: https://www.ti.com/lit/ds/symlink/max3232.pdf
2021-01-18 09:42:13 +00:00
.. _Silabs 7055 datasheet: https://www.silabs.com/documents/public/data-sheets/Si7050-1-3-4-5-A20.pdf
.. _ST Microelectronics LIS2DH datasheet: https://www.st.com/resource/en/datasheet/lis2dh.pdf
.. _Honeywell SM351LT datasheet: https://sensing.honeywell.com/honeywell-sensing-nanopower-series-datasheet-50095501-c-en.pdf
2021-03-08 07:29:02 +00:00
.. _MBED Serial Driver: https://os.mbed.com/docs/mbed-os/v6.8/program-setup/windows-serial-driver.html
