zephyr/boards/bytesatwork/bytesensi_l/doc/index.rst

152 lines
4.7 KiB
ReStructuredText

.. zephyr:board:: bytesensi_l
Overview
********
The byteSENSI-L is a fun LoRa device based on nRF52 MCU that integrates many
sensors.
Hardware
********
Supported Features
==================
+-----------+------------+----------------------+
| Interface | Controller | Driver/Component |
+===========+============+======================+
| CLOCK | on-chip | clock_control |
+-----------+------------+----------------------+
| FLASH | on-chip | flash |
+-----------+------------+----------------------+
| GPIO | on-chip | gpio |
+-----------+------------+----------------------+
| GPS | u-blox | gnss |
+-----------+------------+----------------------+
| I2C(M) | on-chip | i2c |
+-----------+------------+----------------------+
| MPU | on-chip | arch/arm |
+-----------+------------+----------------------+
| NVIC | on-chip | arch/arm |
+-----------+------------+----------------------+
| RADIO | on-chip | Bluetooth |
+-----------+------------+----------------------+
| RADIO | Semtech | LoRa |
+-----------+------------+----------------------+
| RTC | on-chip | system clock |
+-----------+------------+----------------------+
| RTT | Segger | console |
+-----------+------------+----------------------+
| WDT | on-chip | watchdog |
+-----------+------------+----------------------+
Connections and IOs
===================
External Connectors
-------------------
External Supply @ X1
+-------+--------------+---------------------------------------+
| PIN # | Signal Name | Function |
+=======+==============+=======================================+
| 1 | VBAT | Power input instead of CR2477 battery |
+-------+--------------+---------------------------------------+
| 2 | GND | Ground |
+-------+--------------+---------------------------------------+
Programming Connector @ SL1
+-------+--------------+
| PIN # | Signal Name |
+=======+==============+
| 1 | VBAT |
+-------+--------------+
| 2 | SWDIO |
+-------+--------------+
| 3 | GND |
+-------+--------------+
| 4 | SWDCLK |
+-------+--------------+
| 5 | GND |
+-------+--------------+
| 6 | NC (SWO) |
+-------+--------------+
| 7 | NC (Key) |
+-------+--------------+
| 8 | NC |
+-------+--------------+
| 9 | GND |
+-------+--------------+
| 10 | nReset |
+-------+--------------+
I2C Sensor @ X3
+-------+--------------+-------------------------+
| PIN # | Signal Name | Function |
+=======+==============+=========================+
| 1 | VBAT | Power out |
+-------+--------------+-------------------------+
| 2 | SCL | I2C clock at P0.15 |
+-------+--------------+-------------------------+
| 3 | SDA | I2C data at P0.16 |
+-------+--------------+-------------------------+
| 4 | INT | Interrupt at P0.13 |
+-------+--------------+-------------------------+
| 5 | I2C_ADDR | tied to VBAT |
+-------+--------------+-------------------------+
| 6 | GND | Ground |
+-------+--------------+-------------------------+
One Wire Sensor @ X2
+-------+----------------+-------------------------+
| PIN # | Signal Name | Function |
+=======+================+=========================+
| 1 | VDD | 4V8 |
+-------+----------------+-------------------------+
| 2 | IO | One Wire |
+-------+----------------+-------------------------+
| 3 | GND | Ground |
+-------+----------------+-------------------------+
External BLE Antenna @ J1
External LoRa Antenna @ J2
External GPS Antenna @ J3
Programming and Debugging
*************************
Flashing
========
The byteSENSI-L board can be flashed with the SEGGER JLink programmer.
You can build and flash applications in the usual way. Here is an example for
the :zephyr:code-sample:`hello_world` application.
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: bytesensi_l
:goals: build flash
:compact:
Debugging
=========
Debugging your application can be done with ``west debug``.
Serial console
==============
The byteSENSI-L board only uses Segger's RTT console for providing serial
console. There is no physical serial port available.
References
**********
* `bytesatwork website <https://www.bytesatwork.io/>`_
* `bytesatwork wiki <https://wiki.bytesatwork.io/>`_