Browse Source

feat : add README document

1. 完善配置文件
2. 添加说明文档
linyuanbo_breo_server 3 years ago
parent
commit
83cd6c91b9

+ 11 - 20
bsp/n32g452xx/n32g452xx-mini-system/.config

@@ -29,6 +29,7 @@ CONFIG_RT_TIMER_THREAD_STACK_SIZE=512
 #
 # CONFIG_RT_KSERVICE_USING_STDLIB is not set
 # CONFIG_RT_KSERVICE_USING_TINY_SIZE is not set
+# CONFIG_RT_USING_ASM_MEMCPY is not set
 CONFIG_RT_DEBUG=y
 # CONFIG_RT_DEBUG_COLOR is not set
 # CONFIG_RT_DEBUG_INIT_CONFIG is not set
@@ -113,16 +114,7 @@ CONFIG_FINSH_ARG_MAX=10
 #
 # Device virtual file system
 #
-CONFIG_RT_USING_DFS=y
-CONFIG_DFS_USING_WORKDIR=y
-CONFIG_DFS_FILESYSTEMS_MAX=4
-CONFIG_DFS_FILESYSTEM_TYPES_MAX=4
-CONFIG_DFS_FD_MAX=16
-# CONFIG_RT_USING_DFS_MNTTABLE is not set
-# CONFIG_RT_USING_DFS_ELMFAT is not set
-CONFIG_RT_USING_DFS_DEVFS=y
-# CONFIG_RT_USING_DFS_ROMFS is not set
-# CONFIG_RT_USING_DFS_RAMFS is not set
+# CONFIG_RT_USING_DFS is not set
 
 #
 # Device Drivers
@@ -170,13 +162,8 @@ CONFIG_RT_USING_PIN=y
 #
 CONFIG_RT_USING_LIBC=y
 # CONFIG_RT_USING_PTHREADS is not set
-CONFIG_RT_USING_POSIX=y
-# CONFIG_RT_USING_POSIX_MMAP is not set
-# CONFIG_RT_USING_POSIX_TERMIOS is not set
-# CONFIG_RT_USING_POSIX_GETLINE is not set
-# CONFIG_RT_USING_POSIX_AIO is not set
 # CONFIG_RT_USING_MODULE is not set
-CONFIG_RT_LIBC_FIXED_TIMEZONE=8
+CONFIG_RT_LIBC_DEFAULT_TIMEZONE=8
 
 #
 # Network
@@ -267,7 +254,6 @@ CONFIG_RT_LIBC_FIXED_TIMEZONE=8
 # CONFIG_PKG_USING_AT_DEVICE is not set
 # CONFIG_PKG_USING_ATSRV_SOCKET is not set
 # CONFIG_PKG_USING_WIZNET is not set
-# CONFIG_PKG_USING_ZB_COORDINATOR is not set
 
 #
 # IoT Cloud
@@ -308,7 +294,6 @@ CONFIG_RT_LIBC_FIXED_TIMEZONE=8
 # CONFIG_PKG_USING_AGILE_MODBUS is not set
 # CONFIG_PKG_USING_AGILE_FTP is not set
 # CONFIG_PKG_USING_EMBEDDEDPROTO is not set
-# CONFIG_PKG_USING_RT_LINK_HW is not set
 
 #
 # security packages
@@ -505,7 +490,6 @@ CONFIG_RT_LIBC_FIXED_TIMEZONE=8
 # CONFIG_PKG_USING_KOBUKI is not set
 # CONFIG_PKG_USING_ROSSERIAL is not set
 # CONFIG_PKG_USING_MICRO_ROS is not set
-# CONFIG_PKG_USING_MCP23008 is not set
 
 #
 # AI packages
@@ -583,8 +567,15 @@ CONFIG_SOC_N32G452XX=y
 # On-chip Peripheral Drivers
 #
 CONFIG_RT_USING_GPIO=y
-# CONFIG_RT_USING_ON_CHIP_FLASH is not set
+# CONFIG_BSP_USING_ON_CHIP_FLASH is not set
 CONFIG_RT_USING_UART=y
 CONFIG_RT_USING_UART1=y
 # CONFIG_RT_USING_UART2 is not set
 # CONFIG_RT_USING_UART3 is not set
+# CONFIG_BSP_USING_PWM is not set
+# CONFIG_BSP_USING_HWTIMER is not set
+# CONFIG_BSP_USING_SPI is not set
+# CONFIG_BSP_USING_I2C1 is not set
+# CONFIG_BSP_USING_ADC is not set
+# CONFIG_BSP_USING_CAN is not set
+# CONFIG_BSP_USING_SDIO is not set

+ 126 - 0
bsp/n32g452xx/n32g452xx-mini-system/README.md

@@ -0,0 +1,126 @@
+# N32G452XX MINI-SYSTEM BSP 说明
+
+## 简介
+
+N32G452 MINI-SYSTEM 是国民技术推出的一款N32G452系列的评估板(目前市面还没有,以后也可能不会有),其搭载的MCU主要资源参数如下:
+
+| 硬件      | 描述          |
+| --------- | ------------- |
+| 芯片型号  | N32G452RCL7  |
+| CPU       | ARM Cortex M4 |
+| 主频      | 144M          |
+| 片内SRAM  | 80K可扩展144K |
+| 片内FLASH | 256K         |
+
+## 编译说明
+
+N32G452 MINI-SYSTEM 板级包支持MDK5开发环境和GCC编译器,以下是具体版本信息:
+
+| IDE/编译器 | 已测试版本                   |
+| ---------- | ---------------------------- |
+| MDK5       | MDK533                       |
+| GCC        | GCC 6.2.1 20161205 (release) |
+
+## 板载资源
+
+- MCU:N32G452RCL7,主频 144MHz,256KB FLASH ,80KB可扩展到144KB RAM
+- 常用接口:插针串口J8
+- 调试接口,JLINK、板载的 NS-LINK SWD 下载
+
+## 外设支持
+
+本 BSP 目前对外设驱动的支持情况如下:
+
+| 驱动      | 支持情况 |            备注            |
+| --------- | -------- | :------------------------: |
+| UART      | 支持(已移植,已测试)     | USART1/2/3                 |
+| GPIO      | 支持(已移植,已测试)     | PA0...PF7                  |
+| IIC       | 支持(已移植,待测试)     | GPIO-I2C                   |
+| SPI       | 支持(已移植,待测试)     | SPI1/2                     |
+| ADC       | 支持(已移植,待测试)     | ADC1/2                     |
+| PWM       | 支持(已移植,待测试)     | TMR1/2                     |
+| HWTIMER   | 支持(已移植,待测试)     | TMR3/4/5                   |
+| SDIO      | 支持(已移植,待测试)     | SDIO1                      |
+| CAN       | 支持(已移植,待测试)     | CAN1/2                     |
+| WDT       | 支持(已移植,待测试)     |                            |
+| RTC       | 支持(已移植,待测试)     |                            |
+| FLASH     | 支持(已移植,待测试)     |                            |
+| ETH       | 支持(已移植,待测试)     |                            |
+
+### IO在板级支持包中的映射情况
+
+| IO号 | 板级包中的定义 |
+| ---- | -------------- |
+| PA9  | USART1_TX      |
+| PA10 | USART1_RX      |
+| PA2  | USART2_TX      |
+| PA3  | USART2_RX      |
+| PB10 | USART3_TX      |
+| PB11 | USART3_RX      |
+| PA4  | SPI1_NSS       |
+| PA5  | SPI1_SCK       |
+| PA6  | SPI1_MISO      |
+| PA7  | SPI1_MOSI      |
+| PB12 | SPI2_NSS       |
+| PB13 | SPI2_SCK       |
+| PB14 | SPI2_MISO      |
+| PB15 | SPI2_MOSI      |
+| PB6  | I2C1_SCL       |
+| PB7  | I2C1_SDA       |
+| PC8  | SDIO1_D0       |
+| PC9  | SDIO1_D1       |
+| PC10 | SDIO1_D2       |
+| PC11 | SDIO1_D3       |
+| PC12 | SDIO1_CK       |
+| PD2  | SDIO1_CMD      |
+| PA8  | PWM_TMR1_CH1   |
+| PA11 | PWM_TMR1_CH4   |
+| PA0  | PWM_TMR2_CH1   |
+| PA1  | PWM_TMR2_CH2   |
+| PC0  | ADC1/2_IN10    |
+| PC1  | ADC1/2_IN11    |
+| PC2  | ADC1/2_IN12    |
+| PC3  | ADC1/2_IN13    |
+| PC4  | ADC1/2_IN14    |
+| PC5  | ADC1/2_IN15    |
+
+## 使用说明
+
+    本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。
+
+### 快速上手
+
+本 BSP 为开发者提供 MDK5工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。
+
+#### 硬件连接
+
+使用数据线连接开发板到 PC,打开电源开关。
+
+#### 编译下载
+
+双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。
+
+#### 运行结果
+
+下载程序成功之后,系统会自动运行,观察开发板上 LED 的运行效果,LED2/3/4 会周期性闪烁。
+
+连接开发板对应串口到 PC , 在终端工具里打开相应的串口(115200-8-1-N),复位设备后,在串口上可以看到 RT-Thread 的输出信息:
+
+```bash
+ \ | /
+- RT -     Thread Operating System
+ / | \     4.0.4 build Aug 19 2021
+ 2006 - 2021 Copyright by rt-thread team
+msh />
+```
+
+## 注意事项
+
+1. 使用 J-LINK 下载时,请设置下载完成自动复位(J-Flash设置步骤:`Options->Project settings->production->Start application`),否则下载完成后手动按键复位无法启动,初步定位问题原因为:芯片下电缓慢,参考《N32G43x系列芯片电源系统设计指南》或联系FAE了解情况。
+
+## 联系人信息
+
+维护人:
+
+- [LinYuanbo](https://github.com/Lim-LinYuanbo)
+- [breo.com](https://github.com/breo-shenzhen)

+ 0 - 23
bsp/n32g452xx/n32g452xx-mini-system/rtconfig.h

@@ -73,12 +73,6 @@
 
 /* Device virtual file system */
 
-#define RT_USING_DFS
-#define DFS_USING_WORKDIR
-#define DFS_FILESYSTEMS_MAX 4
-#define DFS_FILESYSTEM_TYPES_MAX 4
-#define DFS_FD_MAX 16
-#define RT_USING_DFS_DEVFS
 
 /* Device Drivers */
 
@@ -88,11 +82,7 @@
 #define RT_USING_SERIAL_V1
 #define RT_SERIAL_USING_DMA
 #define RT_SERIAL_RB_BUFSZ 64
-#define RT_USING_I2C
-#define RT_USING_I2C_BITOPS
 #define RT_USING_PIN
-#define RT_USING_ADC
-#define RT_USING_SPI
 
 /* Using USB */
 
@@ -100,7 +90,6 @@
 /* POSIX layer and C standard library */
 
 #define RT_USING_LIBC
-#define RT_USING_POSIX
 #define RT_LIBC_DEFAULT_TIMEZONE 8
 
 /* Network */
@@ -186,19 +175,7 @@
 /* On-chip Peripheral Drivers */
 
 #define RT_USING_GPIO
-#define BSP_USING_ON_CHIP_FLASH
 #define RT_USING_UART
 #define RT_USING_UART1
-#define RT_USING_UART2
-#define RT_USING_UART3
-#define BSP_USING_SPI
-#define BSP_USING_SPI1
-#define BSP_USING_SPI2
-#define BSP_USING_I2C1
-#define BSP_I2C1_SCL_PIN 22
-#define BSP_I2C1_SDA_PIN 23
-#define BSP_USING_ADC
-#define BSP_USING_ADC1
-#define BSP_USING_ADC2
 
 #endif