rt-thread/bsp/essemi/es32f369x/README.md

# ES-PDS-ES32F369x 开发板 BSP 说明
标签： EastSoft、国产MCU、Cortex-M3、ES32F3696LT

## 1. 简介

本文档为上海东软载波微电子开发团队为 ES-PDS-ES32F369x 开发板提供的 BSP (板级支持包) 说明。
通过阅读本文档，开发者可以快速地上手该 BSP，将 RT-Thread 运行在开发板上。

### 1.1  开发板介绍

主要内容如下：
ES-PDS-ES32F369x 是东软载波微电子官方推出的一款基于 ARM Cortex-M3 内核的开发板，最高主频为 96MHz，可满足基础功能测试及高端功能扩展等开发需求。

开发板外观如下图所示：

ES-PDS-ES32F369x-V1.3

![ES32F0654](figures/ES-PDS-ES32F369x-V1.3.jpg)

该开发板常用 **板载资源** 如下：

- MCU：ES32F3696LT，主频 96MHz，96KB SRAM，512KB FLASH，50 GPIOs
- 外部模块：SPI FLASH (MX25L64，8MB)、I2C EEPROM (M24C04，512B)
- 常用外设
  - 可调电阻：1个(PA05)
  - LED：2个，(PF00/PF01)
  - 按键：6个，PB02、PB12、PC10、PC11、PC12、RESET(MRST)
- 常用接口：GPIO、UART、SPI、I2C、CAN
- 调试接口，ESLinkⅡ(EastSoft 官方推出的开发工具，有标准版和mini版两种版本，均自带 CDC 串口功能) SWD 下载

外设支持:

本 BSP 目前对外设的支持情况如下：

| **板载外设** | **支持情况** | **备注**        |
| :----------- | :----------: | :-------------- |
| SPI FLASH    |     支持     | SPI0            |
| **片上外设** | **支持情况** | **备注**        |
| GPIO         |     支持     | 50 GPIOs        |
| UART         |     支持     | UART0/1/2/3/4/5 |
| SPI          |     支持     | SPI0/1/2        |
| I2C          |     支持     | I2C0/1          |
| CAN          |     支持     | CAN0            |
| PWM          |     支持     | PWM0/1          |
| TIMER        |     支持     | TIMER0/1        |
| RTC          |     支持     | RTC             |
| ADC          |     支持     | ADC0            |

### 1.2  注意事项

更多详细信息请咨询[上海东软载波微电子技术支持](http://www.essemi.com/)

## 2. 快速上手

本 BSP 为开发者提供 MDK5 工程。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。

### 硬件连接

使用 ESLinkⅡ (自带 CDC 串口)或 Jlink 等调试工具连接开发板到 PC，拨动开关选择使用调试工具供电或使用外部电源供电。若使用 Jlink 等调试工具，还需要将 UART0_TX(PB10)、UART0_RX(PB11)、GND 接到串口工具上。

使用ESlinkⅡ(mini)连接开发板如下图所示：

ESLinkⅡ(mini) + ES-PDS-ES32F369x-V1.3

![ESLinkII](figures/ESLinkII-mini.jpg)

### 编译下载

双击 project.uvprojx 文件，打开 MDK5 工程，工程默认配置使用 JLink 下载程序，在通过 JLink 连接开发板的基础上，点击下载按钮即可下载程序到开发板，如果使用 ESLinkⅡ，则选择 "CMSIS-DAP Debugger"，连接正常后即可编译并下载程序到开发板。

### 运行结果

下载程序成功之后，系统会自动运行，观察串口输出的信息，同时开发板LED闪烁。
```bash
 \ | /
- RT -     Thread Operating System
 / | \     4.0.2 build Jan 23 2020
 2006 - 2019 Copyright by rt-thread team
msh>
```
## 3. 进阶使用

此 BSP 默认只开启了 GPIO 和 uart0 的功能，如果需使用更多高级功能，需要利用 ENV 工具对 BSP 进行配置，步骤如下：

1. 在 bsp 下打开 env 工具。

2. 输入`menuconfig`命令配置工程，配置好之后保存退出。

    a）如果需要使用内核用例，先配置rt-thread内核，如图：

    ![kernel_config](figures/k_conf.jpg)

    然后配置内核用例，如图：

    ![kernel_samples](figures/k_ex.jpg)

    b）如果需要使用驱动用例：先使能驱动，如图：

    ![driver_config](figures/d_conf.jpg)

    然后配置驱动用例，如图：

    ![driver_sample](figures/d_ex.jpg)

3. 输入`pkgs --update`命令更新软件包。

4. 输入`scons --target=mdk5/iar` 命令重新生成工程。

更多 Env 工具的详细介绍请参考 [RT-Thread 文档中心](https://www.rt-thread.org/document/site/)

## 4. 联系人信息

- [liuhongyan](https://gitee.com/liuhongyan98) 

## 5. 参考

- [ EastSoft 官网](http://www.essemi.com)