1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/boards/cc1312-launchpad/doc.txt
Jean Pierre Dudey 130467dd91
cc1312-launchpad: add board documentation
Signed-off-by: Jean Pierre Dudey <jeandudey@hotmail.com>
2020-02-22 12:43:11 -05:00

90 lines
3.0 KiB
Plaintext

/**
@defgroup boards_cc1312_launchpad TI CC1312 LaunchPad
@ingroup boards
@brief Texas Instruments SimpleLink(TM) CC1312 Wireless MCU LaunchPad(TM) Kit
## Overview
The [LAUNCHXL-CC1312R1](http://www.ti.com/tool/LAUNCHXL-CC1312R1) is a Texas
Instrument's development kit for the CC1312R1 SoC MCU which combines a
Cortex-M4F microcontroller alongside a dedicated Cortex-M0 to control radio.
## Hardware
![LAUNCHXL-CC1312R1](http://www.ti.com/diagrams/launchxl-cc1312r1_cc1312r1-top-prof1.jpg)
| MCU | CC1312R1 |
|:------------ |:----------------- |
| Family | ARM Cortex-M4F |
| Vendor | Texas Instruments |
| RAM | 80 Kb |
| Flash | 352 Kb |
| Frequency | 48 MHz |
| FPU | yes |
| Timers | 4 |
| ADCs | 1x 12-bt (channels) |
| UARTs | 2 |
| SPIs | 2 |
| I2Cs | 1 |
| Vcc | 1.8V - 3.8V |
| Datasheet | [Datasheet](http://www.ti.com/lit/ds/symlink/cc1312r.pdf) (pdf file) |
| Reference Manual | [Reference Manual](http://www.ti.com/lit/ug/swcu185d/swcu185d.pdf) |
## Board pinout
The [CC1312R Quick Start Guide](http://www.ti.com/lit/ml/swru535c/swru535c.pdf)
provides the default pinout for the board.
## Flashing and Debugging
The LAUNCHXL-CC1312R1 comes with an XDS110 on-board debug probe that provides
programming, flashing and debugging capabilities.
### Installing CCS and Uniflash
The TI's Code Composer Studio provides the necessary tools to use the debug
features of the XDS110; Uniflash provides flashing tools. Both programs can
be found here:
- [Code Composer Studio (CCS) Integrated Development Environment (IDE)](http://www.ti.com/tool/CCSTUDIO).
- [Uniflash Standalone Flash Tool for TI Microcontrollers (MCU), Sitara Processors & SimpleLink devices](http://www.ti.com/tool/UNIFLASH).
Before using the XDS110 with the latest CCS/Uniflash versions the firmware for
it needs to be updated. Texas Instruments has a guide to correctly update it
[here](http://software-dl.ti.com/ccs/esd/documents/xdsdebugprobes/emu_xds110.html#updating-the-xds110-firmware).
### Setting up the environment
In order to make use of the programming and debugging capabilities of the XDS110
some environment variable needs to be set:
```
export CCS_PATH=<path to ti install folder>/ti/ccs930
export UNIFLASH_PATH<path to ti install folder>/ti/uniflash_5.2.0
```
That assumes you have CCS 9.3.0 (for the path name) and Uniflash 5.2.0, adjust
accordingly.
After that you can flash using the RIOT `make flash` command on your application
or to debug you first start the debug server:
```
make debug-server
```
And then on another terminal you can run:
```
make debug
```
It will open GDB and connect to the debug server automatically.
### Reset
The LAUNCHXL-CC1312R1 provides a reset button but it can also be reset from
a computer using the `make reset` command.
*/