1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/boards/generic-cc2538-cc2592-dk/doc.txt
Marian Buschsieweke 947d05ed77
boards/generic-cc2538-cc2592-dk: add board support
The CC2538-CC2592-DK is one of the few readily available and
affordable boards featuring a legacy CC2538 MCU. This should make
maintaining RIOT support for that legacy MCU more affordable :-)
2024-01-05 00:00:48 +01:00

85 lines
3.3 KiB
Plaintext

/**
@defgroup boards_generic_cc2538_cc2592_dk Generic CC2538-CC2592-DK Board
@ingroup boards
@brief Support for the 3rd party CC2538-CC2592-DK board
## Overview
@image html https://raw.githubusercontent.com/maribu/images/master/CC2538-CC2592-DK-front.jpeg "Front side of the CC2538-CC2592-DK board" width=50%
@image html https://raw.githubusercontent.com/maribu/images/master/CC2538-CC2592-DK-back.jpeg "Back side of the CC2538-CC2592-DK board" width=50%
The generic CC2538-CC2592-DK board can obtained from various vendors in the
typical [online][buy-cc2538-cc2592-dk-1] [shops][buy-cc2538-cc2592-dk-2].
There are currently few options for readily available and affordable boards
featuring a legacy CC2538 MCU; this is one of them.
The boards seem to be based on the schematics provided by
[`@knowic`][knowic-author] via [the CC2538_CC2592_DK repo][board-repo].
[buy-cc2538-cc2592-dk-1]: https://www.aliexpress.com/wholesale?SearchText=CC2538+CC2592+development+board
[buy-cc2538-cc2592-dk-2]: https://www.ebay.com/sch/i.html?_nkw=CC2538+CC2592+development+board
[knowic-author]: https://github.com/knowic
[board-repo]: https://github.com/knowic/CC2538_CC2592_DK
## Hardware
| MCU | CC2538SF53 |
|:----------------- |:----------------------------------------- |
| Family | ARM Cortex-M3 |
| Vendor | Texas Instruments |
| RAM | 32 KiB |
| Flash | 512 KiB |
| Frequency | 32 MHz |
| FPU | no |
| Timers | 4 |
| ADCs | 1x 12-bit (8 channels) |
| UARTs | 2 |
| SPIs | 2 |
| I2Cs | 1 |
| Vcc | 3.6 V - 5 V (MCU powered @ 3.3 V via LDO) |
| Schematics | [Board Schematics][schematics] |
### Schematics
<img src="https://raw.githubusercontent.com/maribu/images/master/CC2538-CC2592-DK-schematic.svg" alt="Schematics of the CC2538-CC2592-DK board" style="width: 100%;">
[Download schematics from author's repo][schematics].
[schematics]: https://github.com/knowic/CC2538_CC2592_DK/blob/main/CC2538_CC2592_DK_1V3.pdf
## Flashing
Prior to flashing the bootloader needs to be entered. For this, hold the
"SELECT" button, press the "RESET" button, then release the "SELECT"
button. Now run
```
make BOARD=generic-cc2538-cc2592-dk flash
```
@note Flashing via J-Link would also be possible by passing
`PROGRAMMER=jlink`, but requires attaching a J-Link programmer/debugger.
## Accessing the terminal
The board features an CP2102 USB to UART bridge that is used for stdio by
default. Just use
```
make BOARD=generic-cc2538-cc2592-dk term
```
## Debugging
Assuming an J-Link (e.g. the J-Link EDU Mini) debugger is connected, debugging
is as simple as:
```
make BOARD=generic-cc2538-cc2592-dk debug
```
@note By default OpenOCD is used for debugging. While debugging works fine
with OpenOCD, flashing is only supported via the bootloader or `jlink`.
*/