1.. zephyr:board:: max32655fthr
2
3Overview
4********
5The MAX32655FTHR is a rapid development platform to help engineers quickly implement
6ultra low-power wireless solutions using MAX32655 Arm© Cortex®-M4F and Bluetooth® 5.2 Low Energy (LE).
7The board also includes the MAX20303 PMIC for battery and power management.
8The form factor is a small 0.9in x 2.6in dual-row header footprint that is compatible
9with Adafruit Feather Wing peripheral expansion boards. The board includes a variety of peripherals,
10such as a digital microphone, lowpower stereo audio CODEC, 128MB QSPI Flash, micro SD card connector,
11RGB indicator LED, and pushbutton.
12The MAX32655FTHR provides a power-optimized flexible platform for quick proof-of-concepts and
13early software development to enhance time to market. Go to
14https://www.analog.com/MAX32655FTHR to get started developing with this board.
15
16
17The Zephyr port is running on the MAX32655 MCU.
18
19.. image:: img/max32655fthr_img1.jpg
20   :align: center
21   :alt: MAX32655FTHR Front
22
23.. image:: img/max32655fthr_img2.jpg
24   :align: center
25   :alt: MAX32655FTHR Front Modules
26
27.. image:: img/max32655fthr_img3.jpg
28   :align: center
29   :alt: MAX32655FTHR Back
30
31Hardware
32********
33
34- MAX32655 MCU:
35
36  - Ultra-Low-Power Wireless Microcontroller
37    - Internal 100MHz Oscillator
38    - Flexible Low-Power Modes with 7.3728MHz System Clock Option
39    - 512KB Flash and 128KB SRAM (Optional ECC on One 32KB SRAM Bank)
40    - 16KB Instruction Cache
41  - Bluetooth 5.2 LE Radio
42    - Dedicated, Ultra-Low-Power, 32-Bit RISC-V Coprocessor to Offload Timing-Critical Bluetooth Processing
43    - Fully Open-Source Bluetooth 5.2 Stack Available
44    - Supports AoA, AoD, LE Audio, and Mesh
45    - High-Throughput (2Mbps) Mode
46    - Long-Range (125kbps and 500kbps) Modes
47    - Rx Sensitivity: -97.5dBm; Tx Power: +4.5dBm
48    - Single-Ended Antenna Connection (50Ω)
49  - Power Management Maximizes Battery Life
50    - 2.0V to 3.6V Supply Voltage Range
51    - Integrated SIMO Power Regulator
52    - Dynamic Voltage Scaling (DVS)
53    - 23.8μA/MHz Active Current at 3.0V
54    - 4.4μA at 3.0V Retention Current for 32KB
55    - Selectable SRAM Retention + RTC in Low-Power Modes
56  - Multiple Peripherals for System Control
57    - Up to Two High-Speed SPI Master/Slave
58    - Up to Three High-Speed I2C Master/Slave (3.4Mbps)
59    - Up to Four UART, One I2S Master/Slave
60    - Up to 8-Input, 10-Bit Sigma-Delta ADC 7.8ksps
61    - Up to Four Micro-Power Comparators
62    - Timers: Up to Two Four 32-Bit, Two LP, TwoWatchdog Timers
63    - 1-Wire® Master
64    - Up to Four Pulse Train (PWM) Engines
65    - RTC with Wake-Up Timer
66    - Up to 52 GPIOs
67  - Security and Integrity​
68    - Available Secure Boot
69    - TRNG Seed Generator
70    - AES 128/192/256 Hardware Acceleration Engine
71
72- External devices connected to the MAX32655FTHR:
73
74  - Audio Stereo Codec Interface
75  - Digital Microphone
76  - PMIC and Battery Charger
77  - A 128Mb QSPI flash
78  - Micro SDCard Interface
79  - RGB LEDs
80  - Push Buttons
81
82Supported Features
83==================
84
85Below are the interfaces supported by Zephyr on MAX32655FTHR.
86
87+-----------+------------+-------------------------------------+
88| Interface | Controller | Driver/Component                    |
89+===========+============+=====================================+
90| NVIC      | on-chip    | nested vector interrupt controller  |
91+-----------+------------+-------------------------------------+
92| SYSTICK   | on-chip    | systick                             |
93+-----------+------------+-------------------------------------+
94| CLOCK     | on-chip    | clock and reset control             |
95+-----------+------------+-------------------------------------+
96| GPIO      | on-chip    | gpio                                |
97+-----------+------------+-------------------------------------+
98| UART      | on-chip    | serial                              |
99+-----------+------------+-------------------------------------+
100| TRNG      | on-chip    | entropy                             |
101+-----------+------------+-------------------------------------+
102| I2C       | on-chip    | i2c                                 |
103+-----------+------------+-------------------------------------+
104| DMA       | on-chip    | dma controller                      |
105+-----------+------------+-------------------------------------+
106| Watchdog  | on-chip    | watchdog                            |
107+-----------+------------+-------------------------------------+
108| SPI       | on-chip    | spi                                 |
109+-----------+------------+-------------------------------------+
110| ADC       | on-chip    | adc                                 |
111+-----------+------------+-------------------------------------+
112| Timer     | on-chip    | counter                             |
113+-----------+------------+-------------------------------------+
114| PWM       | on-chip    | pwm                                 |
115+-----------+------------+-------------------------------------+
116| Flash     | on-chip    | flash                               |
117+-----------+------------+-------------------------------------+
118
119Push Buttons
120************
121There are six pushbuttons on the MAX32655FTHR board
122
123SW1
124===
125PMIC Power Button, when the board is powered on state, pressing
126this button for 12 seconds performs a hard powerdown.
127When the board is in a powered-off state, pressing this button powers on the board.
128This button can also be read by MAX32655 firmware, PMIC_PFN2 signal connected to Port 0.13
129is a buffered input of the button status. When the button is pressed, this signal goes to a logic-low
130state.
131
132SW2
133===
134User-programmable function button connected to
135MAX32655 Port 0.2 through a debouncer IC.
136
137SW3
138===
139User-programmable function button connected to
140MAX32655 Port 0.3 through a debouncer IC.
141
142SW4
143===
144Wake-up button connected to MAX32655 Port 3.1.
145
146SW5
147===
148Resets the MAX32655 through RSTN input of the MAX32655.
149
150SW6
151===
152DAPLink adapter button. Keep this button
153pressed while applying power to the board to
154put the MAX32625 DAPLink adapter on board
155to MAINTENANCE mode for DAPLink firmware
156updates.
157
158
159LEDs
160****
161There are three RGB LEDs on the MAX32655FTHR board
162
163LED1 (D1)
164=========
165Connected to the MAX32655FTHR GPIO ports.
166This LED can be controlled by user firmware.
167Port 0.18: Red color
168Port 0.19: Green color
169Port 0.26: Blue color
170
171LED2 (D2)
172=========
173Connected to MAX20303 PMIC LEDx outputs.
174These LEDs can be controlled through I2C commands.
175They also can be configured as charge
176status indicators by issuing I2C commands.
177
178LED3 (D3)
179=========
180DAPLink adapter MAX32625 status LED.
181Controlled by the DAPLink adapter and cannot be
182used as a user LED.
183
184Programming and Debugging
185*************************
186
187Flashing
188========
189
190The MAX32625 microcontroller on the board is flashed with DAPLink firmware at the factory.
191It allows debugging and flashing the MAX32655 Arm Core over USB.
192
193Once the USB cable is connected to your host computer, then you can simply run the
194``west flash`` command to write a firmware image into flash.
195
196Debugging
197=========
198
199Please refer to the `Flashing`_ section and run the ``west debug`` command
200instead of ``west flash``.
201
202References
203**********
204
205- `MAX32655FTHR web page`_
206
207.. _MAX32655FTHR web page:
208   https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/max32655fthr.html
209