1.. zephyr:board:: adafruit_feather_stm32f405
2
3Overview
4********
5
6The Adafruit Feather STM32F405 is an ARM Development board in the
7Feather standard layout, sharing peripheral placement with other
8devices labeled as Feathers or FeatherWings. The board is equipped
9with a lithium ion battery charger, native USB C connector, 2MB of
10external flash memory, and SD card socket.
11
12Hardware
13********
14
15- STM32F405 Cortex M4 with FPU and 1MB Flash, 168MHz speed
16- 192KB RAM total - 128 KB RAM + 64 KB program-only/cache RAM
17- USB C power and data
18- LiPo connector and charger
19- SD socket on the bottom, connected to SDIO port
20- 2 MB SPI Flash chip
21- Built in NeoPixel indicator
22- I2C, UART, GPIO, ADCs, DACs
23- Qwiic/STEMMA-QT connector for fast I2C connectivity
24- SWD SMT mount region on board underside.
25
26Supported Features
27==================
28
29The Adafruit Feather STM32F405 board configuration supports the
30following hardware features:
31
32+-----------+------------+----------------------+
33| Interface | Controller | Driver/Component     |
34+===========+============+======================+
35| NVIC      | on-chip    | nested vectored      |
36|           |            | interrupt controller |
37+-----------+------------+----------------------+
38| SYSTICK   | on-chip    | system clock         |
39+-----------+------------+----------------------+
40| UART      | on-chip    | serial port          |
41+-----------+------------+----------------------+
42| GPIO      | on-chip    | gpio                 |
43+-----------+------------+----------------------+
44| I2C       | on-chip    | i2c                  |
45+-----------+------------+----------------------+
46| SPI       | on-chip    | spi                  |
47+-----------+------------+----------------------+
48| USB       | on-chip    | USB device           |
49+-----------+------------+----------------------+
50
51Other hardware features have not been enabled yet for this board.
52
53Connections and IOs
54===================
55
56The `Adafruit Feather STM32F405 Express Learn site`_ has detailed
57information about the board including `pinouts`_ and the `schematic`_.
58
59System Clock
60============
61
62The STM32F405 is configured to use the 12MHz HSE Oscillator to produce
63a 168MHz system clock.
64
65Serial Port
66===========
67
68The STM32F405 UART 3 peripheral is available on the TX (PB10) and RX
69(PB11) pins.
70
71I2C Port
72========
73
74The STM32F405 I2C1 peripheral is available on the SDA (PB7) and SCL
75(PB6) pins.
76
77SPI Port
78========
79
80The STM32F405 SPI2 peripheral is available on the SCK (PB13), MI
81(PB14) and MO (PB15) pins.
82
83SPI1 uses SCK (PB3), MI (PB4), MO (PB5) and SS (PA15) pins and is
84dedicated to the 2 MB SPI Flash chip.
85
86Programming and Debugging
87*************************
88
89DFU-Util programming is supported through Zephyr by default. Set up
90of the built in DFU-Util bootloader is possible by following the
91`instructions on the Learn website`_.
92
93Flashing
94========
95
96#. Build the Zephyr kernel and the :zephyr:code-sample:`blinky` sample application:
97
98   .. zephyr-app-commands::
99      :zephyr-app: samples/basic/blinky
100      :board: adafruit_feather_stm32f405
101      :goals: build
102      :compact:
103
104#. On the Adafruit Feather STM32F405, connect the 3.3V pin to the B0 boot pin
105   with a jumper wire.
106
107#. Flash the image:
108
109   .. zephyr-app-commands::
110      :zephyr-app: samples/basic/blinky
111      :board: adafruit_feather_stm32f405
112      :goals: flash
113      :compact:
114
115   You should see the D13 LED blinking.
116
117References
118**********
119
120.. target-notes::
121
122.. _Adafruit Feather STM32F405 Express Learn site:
123    https://learn.adafruit.com/adafruit-stm32f405-feather-express/
124
125.. _pinouts:
126    https://learn.adafruit.com/adafruit-stm32f405-feather-express/pinouts
127
128.. _schematic:
129    https://learn.adafruit.com/adafruit-stm32f405-feather-express/downloads
130
131.. _instructions on the Learn website:
132    https://learn.adafruit.com/adafruit-stm32f405-feather-express/dfu-bootloader-details
133