.. zephyr:board:: adafruit_feather_stm32f405

Overview
********

The Adafruit Feather STM32F405 is an ARM Development board in the
Feather standard layout, sharing peripheral placement with other
devices labeled as Feathers or FeatherWings. The board is equipped
with a lithium ion battery charger, native USB C connector, 2MB of
external flash memory, and SD card socket.

Hardware
********

- STM32F405 Cortex M4 with FPU and 1MB Flash, 168MHz speed
- 192KB RAM total - 128 KB RAM + 64 KB program-only/cache RAM
- USB C power and data
- LiPo connector and charger
- SD socket on the bottom, connected to SDIO port
- 2 MB SPI Flash chip
- Built in NeoPixel indicator
- I2C, UART, GPIO, ADCs, DACs
- Qwiic/STEMMA-QT connector for fast I2C connectivity
- SWD SMT mount region on board underside.

Supported Features
==================

.. zephyr:board-supported-hw::

Connections and IOs
===================

The `Adafruit Feather STM32F405 Express Learn site`_ has detailed
information about the board including `pinouts`_ and the `schematic`_.

System Clock
============

The STM32F405 is configured to use the 12MHz HSE Oscillator to produce
a 168MHz system clock.

Serial Port
===========

The STM32F405 UART 3 peripheral is available on the TX (PB10) and RX
(PB11) pins.

I2C Port
========

The STM32F405 I2C1 peripheral is available on the SDA (PB7) and SCL
(PB6) pins.

SPI Port
========

The STM32F405 SPI2 peripheral is available on the SCK (PB13), MI
(PB14) and MO (PB15) pins.

SPI1 uses SCK (PB3), MI (PB4), MO (PB5) and SS (PA15) pins and is
dedicated to the 2 MB SPI Flash chip.

Programming and Debugging
*************************

.. zephyr:board-supported-runners::

DFU-Util programming is supported through Zephyr by default. Set up
of the built in DFU-Util bootloader is possible by following the
`instructions on the Learn website`_.

Flashing
========

#. Build the Zephyr kernel and the :zephyr:code-sample:`blinky` sample application:

   .. zephyr-app-commands::
      :zephyr-app: samples/basic/blinky
      :board: adafruit_feather_stm32f405
      :goals: build
      :compact:

#. On the Adafruit Feather STM32F405, connect the 3.3V pin to the B0 boot pin
   with a jumper wire.

#. Flash the image:

   .. zephyr-app-commands::
      :zephyr-app: samples/basic/blinky
      :board: adafruit_feather_stm32f405
      :goals: flash
      :compact:

   You should see the D13 LED blinking.

References
**********

.. target-notes::

.. _Adafruit Feather STM32F405 Express Learn site:
    https://learn.adafruit.com/adafruit-stm32f405-feather-express/

.. _pinouts:
    https://learn.adafruit.com/adafruit-stm32f405-feather-express/pinouts

.. _schematic:
    https://learn.adafruit.com/adafruit-stm32f405-feather-express/downloads

.. _instructions on the Learn website:
    https://learn.adafruit.com/adafruit-stm32f405-feather-express/dfu-bootloader-details
