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