rt-thread/bsp/lpc55sxx/Libraries/template/lpc55s6xxxx/README.md

219 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# LPC55S69-EVK 板级支持包
## 1. 简介(Introduction)
LPC55S69 是由恩智浦NXP半导体推出的基于Cortex-M33内核的高性能单片机
包括如下硬件特性:
| 硬件 | 描述 |
| -- | -- |
|芯片型号| LPC556x/LPC55S6x 全系列 |
|CPU| Cortex-M33 Dual Core, with FPU |
|主频| 150MHz |
|基本外设| 8个Flexcomm(任意配置为USART/SPI/I2C/I2S) / 1个50MHz SPI / 双USB(1高1全支持主从) |
|特色| PowerQuad DSP协处理器 / 安全外设:PRINCE/PUF/CASPER/AES-256/HASH |
## 2. 硬件开发环境(Hardware development system)
开发板EVK
![开发板示意图](./figures/board.png)
## 3. 编译说明
| 环境 | 说明 |
| ------------ | ------------------------------------------------------------ |
| PC操作系统 | Linux/MacOS/Windows |
| 编译器 | arm-none-eabi-gcc version 6.3.1 20170620 (release)/armcc/iar |
| 构建工具 | scons/mdk5/iar |
| 依赖软件环境 | Env工具/(MDK或IAR或arm-none-eabi-gcc)/git/调试器驱动 |
1) 下载源码
```bash
git clone https://github.com/RT-Thread/rt-thread.git
```
2) 配置工程并准备env
Linux/Mac
```bash
cd rt-thread/bsp/lpc55s69_evk
scons --menuconfig
source ~/.env/env.sh
pkgs --upgrade
```
Windows
>在[RT-Thread官网][1]下载ENV工具包
3) 配置芯片型号
Linux/Mac
```bash
scons --menuconfig
```
Windows(ENV环境中)
```bash
menuconfig
```
在menuconfig页面配置并选择对应的芯片型号若开发环境为MDK/IAR则需要生成工程
4) 生成工程(Mac/Linux下请跳过此步骤)
Windows IAR
```bash
SET RTT_CC=iar
scons --target=iar -s
```
Windows MDK5*
```bash
scons --target=mdk5 -s
```
*该板级支持包不支持生成mdk4的工程
**MDK 与 IAR 在生成完成工程之后一定要在工程中手动选择一次芯片信号,否则会产生严重编译错误**
5) 编译
使用MDK或IAR请参见对应教程
Windows arm-none-eabi-gcc
使用以下指令设置gcc路径
```bash
set RTT_EXEC_PATH=[GCC路径]
```
Linux/Mac arm-none-eabi-gcc
使用以下指令设置gcc路径
```bash
export RTT_EXEC_PATH=[GCC路径]
```
编译WindowsLinux/Mac arm-none-eabi-gcc
```bash
scons -j4
```
或者通过 `scons --exec-path="GCC工具链路径"` 命令,在指定工具链位置的同时直接编译。
出现下列信息即为编译成功
```bash
LINK rtthread-lpc55s69.elf
arm-none-eabi-objcopy -O binary rtthread-lpc55s6x.elf rtthread.bin
arm-none-eabi-size rtthread-lpc55s69.elf
text data bss dec hex filename
41596 356 1456 43408 a990 rtthread-lpc55s6x.elf
scons: done building targets.
```
如果编译正确无误会产生rtthread-lpc55s6x.elf、rtthread.bin文件。其中rtthread.bin为二进制固件
## 3. 烧写及执行
烧写可以使用仿真器 ISP等多种方式 此处不再赘述
### 3.1 运行结果
如果编译 & 烧写无误会在Flexcomm0串口*上看到RT-Thread的启动logo信息
```bash
\ | /
- RT - Thread Operating System
/ | \ 4.0.1 build Jul 30 2019
2006 - 2019 Copyright by rt-thread team
uising armclang, version: 6120001
msh />
```
*默认串口
## 4. 驱动支持情况及计划
| 驱动 | 支持情况 | 备注 |
| ---------- | :------: | :--------------------------: |
| UART | 支持 | UART0/2 |
| GPIO | 支持 | 自动根据芯片型号选择引脚布局 |
| SPI | 支持 | 支持High Speed SPI |
| USB Device | 不支持 | 暂不支持 |
| USB Host | 不支持 | 暂不支持 |
| Windowed WatchDog | 不支持 | 支持 |
| ADC | 不支持 | 暂不支持 |
| I2C | 支持 | 可配合MMA8562 |
| I2C Sensor | 支持 | 获取板上MMA8562加速度传感器数据 |
| RTC | 支持 | RTC时钟自动配置 |
| SDIO | 支持 | 操作SD卡 |
| I2S | 不支持 | 暂不支持 |
### 4.1 IO在板级支持包中的映射情况
| PIO号 | 板级包中的定义 |
| -- | -- |
| PIO0_29 | Flexcomm0 USART RXD |
| PIO0_30 | Flexcomm0 USART TXD |
| | |
| PIO0_7 | SDIO SD0_CLK |
| PIO0_8 | SDIO SD0_CMD |
| PIO0_9 | SDIO SD0_POW_EN |
| PIO0_15 | SDIO SD0_WR_PRT |
| PIO0_17 | SDIO SD0_CARD_INT |
| PIO0_24 | SDIO SD0_D(0) |
| PIO0_25 | SDIO SD0_D(1) |
| PIO0_31 | SDIO SD0_D(2) |
| PIO1_0 | SDIO SD0_D(3) |
| | |
| PIO0_26 | High Speed SPI MOSI |
| PIO1_2 | High Speed SPI SCK |
| PIO1_3 | High Speed SPI MISO |
| | |
| PIO1_4 | GPIO1_4 output LED BLUE |
| PIO1_6 | GPIO1_6 output LED RED |
| PIO1_7 | GPIO1_7 output LED GREEN |
| | |
| PIO0_27 | Flexcomm2 USART TXD mikro BUS |
| PIO1_24 | Flexcomm2 USART RXD mikro BUS |
| | |
| PIO1_20 | Flexcomm4 I2C SCL |
| PIO1_21 | Flexcomm4 I2C SDA |
## 5. menuconfig Bsp菜单详解
| 选项 | 解释 |
| -- | -- |
| Device type | 选择芯片型号修改此处需修改MDK/IAR工程为相同芯片型号 |
*部分选项需要在RT-Thread组件菜单中开启对应的设备框架才能显示。
## 6. 联系人信息
维护人:
[Magicoe][2] < [magicoe@163.com][3] >
[AlexYang][2] < [alex.yang@nxp.com][3] >
[1]: https://www.rt-thread.org/download.html#download-rt-thread-env-tool
[2]: https://github.com/Magicoe
[3]: mailto:magicoe@163.com