1.. zephyr:board:: legend
2
3Overview
4********
5The Legend board family contains three revisions: 25hdd, 25ssd, and 35.
6
7The Legend 2.5" HDD board (revision 25hdd) can be found in the Seagate FireCuda
8Gaming Hard Drive, Gaming Drive for Xbox and Gaming Drive for PlayStation
9devices. A 2.5" drive and two chips are embedded: an ASMedia ASM1153 USB-to-SATA
10bridge controller and a STM32F070 MCU. The former is handling the USB to HDD I/Os
11while the latter is dedicated to the LED effects. The two chips are connected
12together through I2C.
13
14The Legend 2.5" SSD board (revision 25ssd) is found in the Seagate SSD Gaming
15Drive for Xbox. A Realtek RTS5411S USB hub is embedded and connected to a Phison
16U17 2.5" SSD, as well as a STM32F070 MCU.
17
18The Legend 3.5" board (revision 35) can be found in the Seagate FireCuda Gaming
19Hub and Gaming Drive Hub for Xbox devices. A Genesys Logic GL3523-S USB hub is
20connected to an ASMedia ASM1153 USB-to-SATA bridge controller and a STM32F070
21MCU. The two chips are connected together using I2C.
22
23On all boards, the Zephyr port is running on the STM32F070 MCU.
24
25.. image:: img/firecuda_gaming_hard_drive.jpg
26   :align: center
27   :alt: Seagate FireCuda Gaming Hard Drive
28
29.. image:: img/firecuda_gaming_hub.jpg
30   :align: center
31   :alt: Seagate FireCuda Gaming Hub
32
33Hardware
34********
35
36- STM32F070cb MCU:
37
38  - ARM Cortex-M0+
39  - 16KB SRAM
40  - 128KB on-chip flash
41
42- External devices connected to the STM32F070cb MCU:
43
44  - ASMedia ASM1153 USB-to-SATA bridge (I2C master on port 1) (HDD only)
45  - 6 (hdd) or 4 (ssd) Everlight B1414 LEDs connected on SPI1 MOSI
46  - 1 white LED (HDD only)
47  - 64KB external SPI flash connected on SPI2
48
49Supported Features
50==================
51
52.. zephyr:board-supported-hw::
53
54Connections and IOs
55===================
56
57+---------+-----------------+----------------------------+
58| Name    | Function        | Usage                      |
59+=========+=================+============================+
60| PB6     | I2C1            | I2C1 SCL (HDD only)        |
61+---------+-----------------+----------------------------+
62| PB7     | I2C1            | I2C1 SDA (HDD only)        |
63+---------+-----------------+----------------------------+
64| PA10    | UART            | USART0 RX                  |
65+---------+-----------------+----------------------------+
66| PA9     | UART            | USART0 TX                  |
67+---------+-----------------+----------------------------+
68| PB0     | PWM             | Activity LED (HDD only)    |
69+---------+-----------------+----------------------------+
70| PB12    | SPI2            | SPI2 Enable                |
71+---------+-----------------+----------------------------+
72| PB13    | SPI2            | SPI2 Clock                 |
73+---------+-----------------+----------------------------+
74| PB14    | SPI2            | SPI2 MISO                  |
75+---------+-----------------+----------------------------+
76| PB15    | SPI2            | SPI2 MOSI                  |
77+---------+-----------------+----------------------------+
78| PA7     | LED strip       | SPI1 MOSI                  |
79+---------+-----------------+----------------------------+
80| PA12    | USB             | USB DM (25ssd and 35 only) |
81+---------+-----------------+----------------------------+
82| PA13    | USB             | USB DP (25ssd and 35 only) |
83+---------+-----------------+----------------------------+
84
85Programming and Debugging
86*************************
87
88.. zephyr:board-supported-runners::
89
90Flashing
91========
92
93The STM32F070cb MCU can be flashed by connecting an external debug probe to the
94SWD port (on-board 4-pin header). In the default OpenOCD configuration, the
95ST Link interface is selected. You may need to replace it with the interface of
96your debug probe.
97
98Once the debug probe is connected to both the Legend board and your host
99computer, then you can simply run the ``west flash`` command to write a firmware
100image into flash.
101
102Debugging
103=========
104
105Please refer to the `Flashing`_ section and run the ``west debug`` command
106instead of ``west flash``.
107
108References
109**********
110
111- `STM32F070 reference manual`_
112
113.. _STM32F070 reference manual:
114   https://www.st.com/resource/en/reference_manual/dm00031936.pdf
115