de13103f0b
Add .. zephyr:board-supported-runners:: to the Programming and Debugging section of the documentation for each board that has one such section, as this is the most natural place to put it. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
142 lines
3.8 KiB
ReStructuredText
142 lines
3.8 KiB
ReStructuredText
.. zephyr:board:: adafruit_feather_m0_lora
|
|
|
|
Overview
|
|
********
|
|
|
|
The Adafruit Feather M0 Lora is a thin, light ARM development
|
|
boards with an onboard battery connector and charger for 3.7 V lithium
|
|
polymer batteries, charging status indicator and user LEDs, native USB
|
|
connector, 20 I/O pins, and a LoRa radio module from Semtech.
|
|
|
|
Hardware
|
|
********
|
|
|
|
- ATSAMD21G18A ARM Cortex-M0+ processor at 48 MHz
|
|
- 32.768 kHz crystal oscillator
|
|
- 256 KiB flash memory and 32 KiB of RAM
|
|
- Battery connector and charger for 3.7 V lithium polymer batteries
|
|
- Charging indicator LED
|
|
- User LED
|
|
- Reset button
|
|
- Native USB port
|
|
- SX127x LoRa radio
|
|
|
|
Supported Features
|
|
==================
|
|
|
|
.. zephyr:board-supported-hw::
|
|
|
|
Connections and IOs
|
|
===================
|
|
|
|
The `Adafruit Feather M0 with LoRa radio module Learn site`_ has detailed
|
|
information about the board including `pinouts`_ and the `schematic`_.
|
|
|
|
System Clock
|
|
============
|
|
|
|
The SAMD21 MCU is configured to use the 32.768 kHz external oscillator
|
|
with the on-chip PLL generating the 48 MHz system clock.
|
|
|
|
Serial Port
|
|
===========
|
|
|
|
The SAMD21 MCU has 6 SERCOM based USARTs. On the Adafruit Feather M0
|
|
with LoRa, SERCOM0 is the Zephyr console and is available on pins 0
|
|
(RX) and 1 (TX).
|
|
|
|
I2C Port
|
|
========
|
|
|
|
The SAMD21 MCU has 6 SERCOM based USARTs. On the Adafruit Feather M0
|
|
with LoRa, SERCOM3 is available on pin 20 (SDA) and pin 21 (SCL).
|
|
|
|
SPI Port
|
|
========
|
|
|
|
The SAMD21 MCU has 6 SERCOM based SPIs. On the Adafruit Feather M0
|
|
with LoRa, SERCOM4 is available on pin 22 (MISO), pin 23 (MOSI), and
|
|
pin 24 (SCK).
|
|
|
|
USB Device Port
|
|
===============
|
|
|
|
The SAMD21 MCU has a USB device port that can be used to communicate
|
|
with a host PC. See the :zephyr:code-sample-category:`usb` sample applications for
|
|
more, such as the :zephyr:code-sample:`usb-cdc-acm` sample which sets up a virtual
|
|
serial port that echos characters back to the host PC.
|
|
|
|
LoRa Radio
|
|
==========
|
|
The Semtech SX127x radio chip on the Adafruit Feather M0 with LoRa
|
|
is attached to the SPI port (SERCOM4). Depending on the hardware
|
|
version, 433MHz or 900MHz is supported.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
.. zephyr:board-supported-runners::
|
|
|
|
The Adafruit Feather M0 with LoRa ships with a BOSSA compatible
|
|
SAM-BA bootloader. The bootloader can be entered by quickly tapping
|
|
the reset button twice.
|
|
|
|
Flashing
|
|
========
|
|
|
|
#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: adafruit_feather_m0_lora
|
|
:goals: build
|
|
:compact:
|
|
|
|
#. Connect the Adafruit Feather M0 with LoRa to your host computer
|
|
using USB
|
|
|
|
#. Connect a 3.3 V USB to serial adapter to the board and to the
|
|
host. See the `Serial Port`_ section above for the board's pin
|
|
connections.
|
|
|
|
#. Run your favorite terminal program to listen for output. Under Linux the
|
|
terminal should be :code:`/dev/ttyACM0`. For example:
|
|
|
|
.. code-block:: console
|
|
|
|
$ minicom -D /dev/ttyACM0 -o
|
|
|
|
The -o option tells minicom not to send the modem initialization
|
|
string. Connection should be configured as follows:
|
|
|
|
- Speed: 115200
|
|
- Data: 8 bits
|
|
- Parity: None
|
|
- Stop bits: 1
|
|
|
|
#. Tap the reset button twice quickly to enter bootloader mode
|
|
|
|
#. Flash the image:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: adafruit_feather_m0_lora
|
|
:goals: flash
|
|
:compact:
|
|
|
|
You should see "Hello World! adafruit_feather_m0_lora" in your terminal.
|
|
|
|
References
|
|
**********
|
|
|
|
.. target-notes::
|
|
|
|
.. _Adafruit Feather M0 with LoRa radio module Learn site:
|
|
https://learn.adafruit.com/adafruit-feather-m0-radio-with-lora-radio-module
|
|
|
|
.. _pinouts:
|
|
https://learn.adafruit.com/adafruit-feather-m0-radio-with-lora-radio-module/pinouts
|
|
|
|
.. _schematic:
|
|
https://learn.adafruit.com/adafruit-feather-m0-radio-with-lora-radio-module/downloads
|