1.. zephyr:board:: particle_argon
2
3Overview
4********
5
6The Particle Argon is a Wi-Fi enabled development board with a Nordic
7Semiconductor nRF52840 for mesh support and an ESP32 for Wi-Fi.  The
8board was developed by Particle Industries and has a SWD connector on it
9for programming.
10
11It is equipped with a onboard LIPO circuit and conforms to the
12Adafruit Feather formfactor.
13
14The Particle Argon provides support for the Nordic Semiconductor nRF52840 ARM
15|reg| Cortex |reg|-M4F SoC with an integrated 2.4 GHz transceiver supporting
16Bluetooth |reg| Low Energy and IEEE |reg| 802.15.4.
17
18For more information about the Particle Argon board:
19
20- `Argon Datasheet`_
21- `Argon Hardware Files`_
22
23Hardware
24********
25
26On the front of the board are RGB-LED, LED and LIPO circuitry.
27The RGB-LED is controlled by the nRF52840 via GPIO pins.
28
29Power supply
30============
31
32The board is optimized for low power applications and supports two
33power source configurations: battery and micro USB connector.
34
35It contains circuitry for LIPO usage and can be charged via the USB port.
36
37Supported Features
38==================
39
40The particle_argon board configuration supports the following
41hardware features:
42
43+-----------+------------+----------------------+
44| Interface | Controller | Driver/Component     |
45+===========+============+======================+
46| NVIC      | on-chip    | nested vectored      |
47|           |            | interrupt controller |
48+-----------+------------+----------------------+
49| RTC       | on-chip    | system clock         |
50+-----------+------------+----------------------+
51| UART      | on-chip    | serial port          |
52+-----------+------------+----------------------+
53| I2C       | on-chip    | i2c                  |
54+-----------+------------+----------------------+
55| SPI       | on-chip    | spi                  |
56+-----------+------------+----------------------+
57| GPIO      | on-chip    | gpio                 |
58+-----------+------------+----------------------+
59| FLASH     | on-chip    | flash                |
60+-----------+------------+----------------------+
61| RADIO     | on-chip    | Bluetooth            |
62+-----------+------------+----------------------+
63
64Other hardware features have not been enabled yet for this board.
65
66Connections and IOs
67===================
68
69Please see the `Argon Datasheet`_ for header pin assignments, which are
70common to all Feather-compatible Particle boards.  Some peripherals are
71available to applications through DTS overlay include directives:
72
73- ``mesh_feather_i2c1_twi1.dtsi`` exposes TWI1 on labeled Feather
74  SDA1/SCL1 pins
75- ``mesh_feather_spi_spi1.dtsi`` exposes SPI1 on labeled Feather
76  SPI pins
77- ``mesh_feather_spi_spi3.dtsi`` exposes SPI3 on labeled Feather
78  SPI pins
79- ``mesh_feather_spi1_spi3.dtsi`` exposes SPI3 on labeled Feather
80  SPI1 pins
81- ``mesh_feather_uart1_rtscts.dtsi`` adds hardware flow control to
82  labeled Feather UART pins
83
84LED
85---
86
87* LED0 (blue)
88* LED1 (red)
89* LED2 (green)
90* LED3 (blue)
91
92Push buttons
93------------
94
95* SW0 via MODE
96* SW1 via RESET
97
98I2C
99---
100
101* TWI0 enabled on labeled header (SDA/SCL)
102* TWI1 selectable with overlay (SDA1/SCL1)
103
104SPI
105---
106
107* SPI0 disabled due to TWI0 conflict
108* SPI1 selectable with overlay (SPI)
109* SPI2 internal to 32 Mb CFI flash chip
110* SPI3 selectable with overlay (SPI or SPI1)
111
112UART
113----
114
115* UARTE0 enabled RX/TX on labeled header (UART1); add RTS/CTS with overlay
116* UARTE1 internal to ESP32
117
118Programming and Debugging
119*************************
120
121Applications for the ``particle_argon`` board configuration can be
122built and flashed in the usual way (see :ref:`build_an_application`
123and :ref:`application_run` for more details).
124
125Flashing
126========
127
128Build and flash an application in the usual way, for example:
129
130.. zephyr-app-commands::
131   :zephyr-app: samples/basic/blinky
132   :board: particle_argon
133   :goals: build flash
134
135Debugging
136=========
137
138You can debug an application in the usual way.  Here is an example for the
139:zephyr:code-sample:`hello_world` application.
140
141.. zephyr-app-commands::
142   :zephyr-app: samples/hello_world
143   :board: particle_argon
144   :maybe-skip-config:
145   :goals: debug
146
147
148Testing the LEDs and buttons
149****************************
150
151There are 2 samples that allow you to test that the buttons (switches) and
152LEDs on the board are working properly with Zephyr:
153
154* :zephyr:code-sample:`blinky`
155* :zephyr:code-sample:`button`
156
157You can build and flash the examples to make sure Zephyr is running correctly on
158your board.
159
160.. _Argon Datasheet:
161   https://docs.particle.io/datasheets/wi-fi/argon-datasheet/
162
163.. _Argon Hardware Files:
164   https://github.com/particle-iot/argon
165