开发环境:
MDK:Keil 5.30
开发板:N32G4FRML-STB 开发板
MCU:N32G4FRMEL7
国名技术的BSP架构已经构建了,笔者这里只需构建N32G4FRML-STB 开发板的BSP即可,其主控芯片为N32G4FRMEL7,主频144MHz,内部512K Flash,144KB SRAM,资源相当丰富。
1 BSP 文件构建
在具体移植N32G4FRML-STB的BSP之前,先看看N32的BSP架构,N32的BSP架构主要分为三个部分:libraries、tools和具体的Boards,其中libraries包含了N32的通用库,包括每个系列的Firmware Library以及适配RT-Thread的drivers;tools是生成工程的Python脚本工具;另外就是Boards文件,当然这里的Boards有很多,我这里值列举了N32G4FRML-STB。
这里先谈谈libraries和tools的构建,然后在后文单独讨论具体板级BSP的制作。
1.1 Libraries构建
Libraries文件夹包含国名技术提供的固件库。
下载地址:ftp://58.250.18.138
然后将N32G4FR_Firmware_Library复制到libraries目录下,其他的系列类似。
N32G4FR_Firmware_Library就是官方的文件,基本是不用动的,只是在文件夹中需要添加构建工程的脚本文件SConscript,其实也就是Python脚本。
SConscript文件的内容如下:
import rtconfig
from building import *
cwd = GetCurrentDir()
src = Split('''
CMSIS/device/system_n32g4fr.c
n32g4fr_std_periph_driver/src/n32g4fr_gpio.c
n32g4fr_std_periph_driver/src/n32g4fr_rcc.c
n32g4fr_std_periph_driver/src/n32g4fr_exti.c
n32g4fr_std_periph_driver/src/misc.c
''')
if GetDepend(['RT_USING_SERIAL']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_usart.c']
if GetDepend(['RT_USING_I2C']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_i2c.c']
if GetDepend(['RT_USING_SPI']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_spi.c']
if GetDepend(['RT_USING_CAN']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_can.c']
if GetDepend(['RT_USING_ADC']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_adc.c']
if GetDepend(['RT_USING_DAC']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_dac.c']
if GetDepend(['RT_USING_HWTIMER']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_tim.c']
if GetDepend(['RT_USING_RTC']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_rtc.c']
if GetDepend(['RT_USING_WDT']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_wwdg.c']
src += ['n32g4fr_std_periph_driver/src/n32g4fr_iwdg.c']
if GetDepend(['RT_USING_SDIO']):
src += ['n32g4fr_std_periph_driver/src/n32g4fr_sdio.c']
path = [
cwd + '/CMSIS/core',
cwd + '/CMSIS/device',
cwd + '/CMSIS',
cwd + '/n32g4fr_std_periph_driver/inc',]
CPPDEFINES = ['USE_STDPERIPH_DRIVER']
group = DefineGroup('libraries', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
Return('group')
该文件主要的作用就是添加库文件和头文件路径,一部分文件是属于基础文件,因此直接调用Python库的Split包含,另外一部分文件是根据实际的应用需求添加的。
这里是以N32G4FRMEL7来举例的,其他系列的都是类似的。
接下来说说Kconfig文件,这里是对内核和组件的功能进行配置,对RT-Thread的组件进行自由裁剪。
如果使用RT-Thread studio,则通过RT-Thread Setting可以体现Kconfig文件的作用。
如果使用ENV环境,则在使用 menuconfig配置和裁剪 RT-Thread时体现。
后面所有的Kconfig文件都是一样的逻辑。下表列举一些常用的Kconfig句法规则。
关键词 |
说明 |
config |
此关键字定义了一新的配置选项 |
menuconfig |
此关键字和前面的关键字很相似,但它在前面的基础上要求所有的子选项作为独立的行显示。 |
choice/endchoice |
该关键字定义了一组选择项。 |
comment |
这里定义了在配置过程中显示给用户的注释,该注释还将写进输出文件中。格式说明:comment "eg: description content" |
menu / endmenu |
这里定义了一个菜单,所有依赖于此菜单的选项都是它的子选项。 |
if/endif |
这里定义了if结构。 |
source |
读取其他具体的配置文件,其他配置文件会被解析。 |
Kconfig的语法规则网上资料很多,自行去学习吧。
bsp/n32/libraries/Kconfig内容如下:
config SOC_FAMILY_N32
bool
config SOC_SERIES_N32G4FR
bool
select ARCH_ARM_CORTEX_M4
select SOC_FAMILY_N32
因为该架构目前笔者只移植了N32G4FRMEL7的,因此这里的内容比较少,如果有些的系列,直接参考N32G4FRMEL7的配置例子在这里加就可以了。
最后谈谈n32_drivers,这个文件夹就是N32的外设驱动文件夹,为上层应用提供调用接口。
该文件夹是整个N32共用的,因此在编写和修改都要慎重。关于drv_xxx文件在后句具体移植BSP的时候讲解,这里主要将整体架构,SConscript和Kconfig的作用和前面的一样,只是具体的内容不同罢了。
好了,先看bsp/n32/libraries/n32_drivers/SConscript文件。
Import('RTT_ROOT')
Import('rtconfig')
from building import *
cwd = GetCurrentDir()
src = Split("""
""")
if GetDepend(['RT_USING_PIN']):
src += ['drv_gpio.c']
if GetDepend(['RT_USING_SERIAL']):
if GetDepend(['RT_USING_SERIAL_V2']):
src += ['drv_usart_v2.c']
else:
src += ['drv_usart.c']
if GetDepend(['RT_USING_HWTIMER']):
src += ['drv_hwtimer.c']
if GetDepend(['RT_USING_PWM']):
src += ['drv_pwm.c']
if GetDepend(['RT_USING_SPI']):
src += ['drv_spi.c']
if GetDepend(['RT_USING_I2C', 'RT_USING_I2C_BITOPS']):
if GetDepend('BSP_USING_I2C1') or GetDepend('BSP_USING_I2C2') or GetDepend('BSP_USING_I2C3') or GetDepend('BSP_USING_I2C4'):
src += ['drv_i2c.c']
if GetDepend(['RT_USING_ADC']):
src += Glob('drv_adc.c')
if GetDepend(['RT_USING_DAC']):
src += Glob('drv_dac.c')
if GetDepend(['RT_USING_CAN']):
src += ['drv_can.c']
if GetDepend(['RT_USING_RTC']):
src += ['drv_rtc.c']
if GetDepend(['RT_USING_WDT']):
src += ['drv_wdt.c']
path = [cwd]
path += [cwd + '/config']
group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path)
Return('group')
和N32G4FR_Firmware_Library文件夹中的SConscript是类似的。
bsp/n32/libraries/n32_drivers/Kconfig文件结构如下:
if BSP_USING_USBD
config BSP_USBD_TYPE_FS
bool
endif
1.2 Tools构建
该文件夹就是工程构建的脚本,
import os
import sys
import shutil
cwd_path = os.getcwd()
sys.path.append(os.path.join(os.path.dirname(cwd_path), 'rt-thread', 'tools'))
def dist_do_building(BSP_ROOT, dist_dir):
from mkdist import bsp_copy_files
import rtconfig
print("=> copy n32 bsp library")
library_dir = os.path.join(dist_dir, 'Libraries')
library_path = os.path.join(os.path.dirname(BSP_ROOT), 'Libraries')
bsp_copy_files(os.path.join(library_path, rtconfig.BSP_LIBRARY_TYPE),
os.path.join(library_dir, rtconfig.BSP_LIBRARY_TYPE))
print("=> copy bsp drivers")
bsp_copy_files(os.path.join(library_path, 'rt_drivers'), os.path.join(library_dir, 'rt_drivers'))
shutil.copyfile(os.path.join(library_path, 'Kconfig'), os.path.join(library_dir, 'Kconfig'))
以上代码很简单,主要使用了Python的OS模块的join函数,该函数的作用就是连接两个或更多的路径名。最后将BSP依赖的文件复制到指定目录下。
在使用scons --dist 命令打包的时候,就是依赖的该脚本,生成的dist 文件夹的工程到任何目录下使用,也就是将BSP相关的库以及内核文件提取出来,可以将该工程任意拷贝。
需要注意的是,使用scons --dist打包后需要修改board/Kconfig中的库路径,因此这里调用了bsp_update_board_kconfig方法修改。
1.3 n32g4frml-stb构建
该文件夹就n32g4frml-stb的具体BSP文件,文件结构如下:
在后面将具体讲解如何构建该部分内容。
2 BSP移植
2.1 Keil环境准备
目前市面通用的MDK for ARM版本有Keil 4和Keil 5:使用Keil 4建议安装4.74及以上;使用Keil 5建议安装5.20以上版本。笔者的MDK是5.30。
从MDK的官网可以下载得到MDK的安装包,然后安装即可,关于的MDK安装请看笔者的教程。
MDK安装教程
MDK下载地址
安装完成后会自动打开,我们将其关闭。
接下来我们下载N32G4FR的软件支持包。
下载地址:ftp://58.250.18.138
下载好后双击Nationstech.N32G4FR_DFP.1.0.4.pack运行即可:
点击[Next]即可安装完成。
安装成功后,重新打开Keil,则可以在File->Device Database中出现Gigadevice的下拉选项,点击可以查看到相应的型号。
2.2 BSP工程制作
1.构建基础工程
首先看看RT-Thread代码仓库中已有很多BSP,而我要移植的是Cortex-M4内核。这里我找了一个相似的内核,把它复制一份,并修改文件名为:n32g4frml-stb。这样就有一个基础的工程。然后就开始增删改查,完成最终的BSP,几乎所有的BSP的制作都是如此。
2.修改BSP构建脚本
bsp/n32/n32g4frml-stb/SConstruct修改后的内容如下:
import os
import sys
import rtconfig
if os.getenv('RTT_ROOT'):
RTT_ROOT = os.getenv('RTT_ROOT')
else:
RTT_ROOT = os.path.normpath(os.getcwd() + '/../../..')
sys.path = sys.path + [os.path.join(RTT_ROOT, 'tools')]
try:
from building import *
except:
print('Cannot found RT-Thread root directory, please check RTT_ROOT')
print(RTT_ROOT)
exit(-1)
TARGET = 'rtthread.' + rtconfig.TARGET_EXT
DefaultEnvironment(tools=[])
env = Environment(tools = ['mingw'],
AS = rtconfig.AS, ASFLAGS = rtconfig.AFLAGS,
CC = rtconfig.CC, CCFLAGS = rtconfig.CFLAGS,
AR = rtconfig.AR, ARFLAGS = '-rc',
CXX = rtconfig.CXX, CXXFLAGS = rtconfig.CXXFLAGS,
LINK = rtconfig.LINK, LINKFLAGS = rtconfig.LFLAGS)
env.PrependENVPath('PATH', rtconfig.EXEC_PATH)
if rtconfig.PLATFORM == 'iar':
env.Replace(CCCOM = ['$CC $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS -o $TARGET $SOURCES'])
env.Replace(ARFLAGS = [''])
env.Replace(LINKCOM = env["LINKCOM"] + ' --map rtthread.map')
Export('RTT_ROOT')
Export('rtconfig')
SDK_ROOT = os.path.abspath('./')
if os.path.exists(SDK_ROOT + '/libraries'):
libraries_path_prefix = SDK_ROOT + '/libraries'
else:
libraries_path_prefix = os.path.dirname(SDK_ROOT) + '/libraries'
SDK_LIB = libraries_path_prefix
Export('SDK_LIB')
# prepare building environment
objs = PrepareBuilding(env, RTT_ROOT, has_libcpu=False)
n32_library = 'N32G4FR_Firmware_Library'
rtconfig.BSP_LIBRARY_TYPE = n32_library
# include libraries
objs.extend(SConscript(os.path.join(libraries_path_prefix, n32_library, 'SConscript')))
# include drivers
objs.extend(SConscript(os.path.join(libraries_path_prefix, 'n32_drivers', 'SConscript')))
# make a building
DoBuilding(TARGET, objs)
该文件用于链接所有的依赖文件,并调用make进行编译。
3.修改Keil的模板工程
双击:template.uvprojx即可修改模板工程。
修改为对应芯片设备:
修改FLASH和RAM的配置:
修改可执行文件名字:
修改默认调试工具:CMSIS-DAP Debugger。
修改编程算法:N32G4FR Flash。
4.修改board文件夹
(1) 修改bsp/n32/n32g4frml-stb/board/linker_scripts/link.icf
修改后的内容如下:
/*###ICF### Section handled by ICF editor, don't touch! ****/
/*-Editor annotation file-*/
/* IcfEditorFile="$TOOLKIT_DIR$\config\ide\IcfEditor\cortex_v1_0.xml" */
/*-Specials-*/
define symbol __ICFEDIT_intvec_start__ = 0x08000000;
/*-Memory Regions-*/
define symbol __ICFEDIT_region_ROM_start__ = 0x08000000;
define symbol __ICFEDIT_region_ROM_end__ = 0x0807FFFF;
define symbol __ICFEDIT_region_RAM_start__ = 0x20000000;
define symbol __ICFEDIT_region_RAM_end__ = 0x20023FFF;
/*-Sizes-*/
define symbol __ICFEDIT_size_cstack__ = 0x1500;
define symbol __ICFEDIT_size_heap__ = 0x300;
/**** End of ICF editor section. ###ICF###*/
export symbol __ICFEDIT_region_RAM_end__;
define symbol __region_RAM1_start__ = 0x10000000;
define symbol __region_RAM1_end__ = 0x1000FFFF;
define memory mem with size = 4G;
define region ROM_region = mem:[from __ICFEDIT_region_ROM_start__ to __ICFEDIT_region_ROM_end__];
define region RAM_region = mem:[from __ICFEDIT_region_RAM_start__ to __ICFEDIT_region_RAM_end__];
define region RAM1_region = mem:[from __region_RAM1_start__ to __region_RAM1_end__];
define block CSTACK with alignment = 8, size = __ICFEDIT_size_cstack__ { };
define block HEAP with alignment = 8, size = __ICFEDIT_size_heap__ { };
initialize by copy { readwrite };
do not initialize { section .noinit };
keep { section FSymTab };
keep { section VSymTab };
keep { section .rti_fn* };
place at address mem:__ICFEDIT_intvec_start__ { readonly section .intvec };
place in ROM_region { readonly };
place in RAM_region { readwrite,
block CSTACK, block HEAP };
place in RAM1_region { section .sram };
该文件是IAR编译的链接脚本,N32G4FRMEL7的flash大小为512KB,SRAM大小为144KB,因此需要设置ROM和RAM的起始地址和堆栈大小等。
(2) 修改bsp/n32/n32g4frml-stb /board/linker_scripts/link.lds
修改后的内容如下:
MEMORY
{
CODE (rx) : ORIGIN = 0x08000000, LENGTH = 512k
DATA (rw) : ORIGIN = 0x20000000, LENGTH = 144k
}
ENTRY(Reset_Handler)
_system_stack_size = 0x1500;
SECTIONS
{
.text :
{
. = ALIGN(4);
_stext = .;
KEEP(*(.isr_vector))
. = ALIGN(4);
. = ALIGN(4);
__fsymtab_start = .;
KEEP(*(FSymTab))
__fsymtab_end = .;
. = ALIGN(4);
__vsymtab_start = .;
KEEP(*(VSymTab))
__vsymtab_end = .;
. = ALIGN(4);
. = ALIGN(4);
__rt_init_start = .;
KEEP(*(SORT(.rti_fn*)))
__rt_init_end = .;
. = ALIGN(4);
. = ALIGN(4);
_etext = .;
} > CODE = 0
__exidx_start = .;
.ARM.exidx :
{
_sidata = .;
} > CODE
__exidx_end = .;
.data : AT (_sidata)
{
. = ALIGN(4);
_sdata = . ;
. = ALIGN(4);
_edata = . ;
} >DATA
.stack :
{
. = . + _system_stack_size;
. = ALIGN(4);
_estack = .;
} >DATA
__bss_start = .;
.bss :
{
. = ALIGN(4);
_sbss = .;
. = ALIGN(4);
_ebss = . ;
} > DATA
__bss_end = .;
_end = .;
.stab 0 : { *(.stab) }
.stabstr 0 : { *(.stabstr) }
.stab.excl 0 : { *(.stab.excl) }
.stab.exclstr 0 : { *(.stab.exclstr) }
.stab.index 0 : { *(.stab.index) }
.stab.indexstr 0 : { *(.stab.indexstr) }
.comment 0 : { *(.comment) }
.debug 0 : { *(.debug) }
.line 0 : { *(.line) }
.debug_srcinfo 0 : { *(.debug_srcinfo) }
.debug_sfnames 0 : { *(.debug_sfnames) }
.debug_aranges 0 : { *(.debug_aranges) }
.debug_pubnames 0 : { *(.debug_pubnames) }
.debug_info 0 : { *(.debug_info .gnu.linkonce.wi.*) }
.debug_abbrev 0 : { *(.debug_abbrev) }
.debug_line 0 : { *(.debug_line) }
.debug_frame 0 : { *(.debug_frame) }
.debug_str 0 : { *(.debug_str) }
.debug_loc 0 : { *(.debug_loc) }
.debug_macinfo 0 : { *(.debug_macinfo) }
.debug_weaknames 0 : { *(.debug_weaknames) }
.debug_funcnames 0 : { *(.debug_funcnames) }
.debug_typenames 0 : { *(.debug_typenames) }
.debug_varnames 0 : { *(.debug_varnames) }
}
该文件是GCC编译的链接脚本,CODE和DATA 的LENGTH分别设置为512KB和144KB,其他芯片类似,但其实地址都是一样的。
(3) 修改bsp/n32/n32g4frml-stb/board/linker_scripts/link.sct
该文件是MDK的连接脚本,需要将 LR_IROM1 和 ER_IROM1 的参数设置为 0x00080000;RAM 的大小为144k,因此需要将 RW_IRAM1 的参数设置为 0x00024000。
************************************************************
; *** Scatter-Loading Description File generated by uVision ***
; *************************************************************
LR_IROM1 0x08000000 0x00080000 { ; load region size_region
ER_IROM1 0x08000000 0x00080000 { ; load address = execution address
*.o (RESET, +First)
*(InRoot$$Sections)
.ANY (+RO)
}
RW_IRAM1 0x20000000 0x00024000 { ; RW data
.ANY (+RW +ZI)
}
}
(4) 修改bsp/n32/n32g4frml-stb/board/board.h文件
修改后内容如下:
#ifndef __BOARD_H__
#define __BOARD_H__
#include "n32g4fr.h"
#include "drv_gpio.h"
#define N32_FLASH_START_ADRESS ((uint32_t)0x08000000)
#define N32_FLASH_SIZE (512 * 1024)
#define N32_FLASH_END_ADDRESS ((uint32_t)(N32_FLASH_START_ADRESS + N32_FLASH_SIZE))
#define N32_SRAM_SIZE (144)
#define N32_SRAM_END (0x20000000 + N32_SRAM_SIZE * 1024)
void rt_hw_board_init(void);
#if defined(__ARMCC_VERSION)
extern int Image$$RW_IRAM1$$ZI$$Limit;
#define HEAP_BEGIN ((void *)&Image$$RW_IRAM1$$ZI$$Limit)
#elif __ICCARM__
#pragma section="CSTACK"
#define HEAP_BEGIN (__segment_end("CSTACK"))
#else
extern int __bss_end;
#define HEAP_BEGIN ((void *)&__bss_end)
#endif
#define HEAP_END N32_SRAM_END
#endif
值得注意的是,不同的编译器规定的堆栈内存的起始地址 HEAP_BEGIN 和结束地址 HEAP_END。这里 HEAP_BEGIN 和 HEAP_END 的值需要和前面的链接脚本是一致的,需要结合实际去修改。
(5) 修改bsp/n32/n32g4frml-stb/board/board.c文件
修改后的文件如下:
#include <rthw.h>
#include <rtthread.h>
#include "board.h"
void NVIC_Configuration(void)
{
#ifdef VECT_TAB_RAM
NVIC_SetVectorTable(NVIC_VectTab_RAM, 0x0);
#else
NVIC_SetVectorTable(NVIC_VectTab_FLASH, 0x0);
#endif
}
void SysTick_Handler(void)
{
rt_interrupt_enter();
rt_tick_increase();
rt_interrupt_leave();
}
void rt_hw_board_init()
{
NVIC_Configuration();
SysTick_Config(SystemCoreClock / RT_TICK_PER_SECOND);
#ifdef RT_USING_COMPONENTS_INIT
rt_components_board_init();
#endif
#ifdef RT_USING_CONSOLE
rt_console_set_device(RT_CONSOLE_DEVICE_NAME);
#endif
#ifdef BSP_USING_SRAM
rt_system_heap_init((void *)EXT_SRAM_BEGIN, (void *)EXT_SRAM_END);
#else
rt_system_heap_init((void *)HEAP_BEGIN, (void *)HEAP_END);
#endif
}
该文件重点关注的就是SystemClock_Config配置,SystemCoreClock的定义在system_gd32f4xx.c中定义的。
(6) 修改bsp/n32/n32g4frml-stb /board/Kconfig文件
修改后内容如下:
menu "Hardware Drivers Config"
config SOC_SERIES_N32G4FR
bool
default y
config SOC_N32G4FR
bool
select SOC_SERIES_N32G4FR
select RT_USING_COMPONENTS_INIT
select RT_USING_USER_MAIN
default y
menu "Onboard Peripheral Drivers"
endmenu
menu "On-chip Peripheral Drivers"
config BSP_USING_GPIO
bool "Enable GPIO"
select RT_USING_PIN
default y
menuconfig BSP_USING_UART
bool "Enable UART"
default y
select RT_USING_SERIAL
if BSP_USING_UART
config BSP_USING_USART1
bool "Enable USART1"
default y
config BSP_USING_USART2
bool "Enable USART2"
default n
config BSP_USING_USART3
bool "Enable USART3"
default n
config BSP_USING_UART4
bool "Enable UART4"
default n
config BSP_USING_UART5
bool "Enable UART5"
default n
config BSP_USING_UART6
bool "Enable UART6"
default n
config BSP_USING_UART7
bool "Enable UART7"
default n
endif
menuconfig BSP_USING_SPI
bool "Enable SPI BUS"
default n
select RT_USING_SPI
if BSP_USING_SPI
config BSP_USING_SPI1
bool "Enable SPI1 BUS"
default n
config BSP_USING_SPI2
bool "Enable SPI2 BUS"
default n
config BSP_USING_SPI3
bool "Enable SPI3 BUS"
default n
endif
menuconfig BSP_USING_I2C1
bool "Enable I2C1 BUS (software simulation)"
default n
select RT_USING_I2C
select RT_USING_I2C_BITOPS
select RT_USING_PIN
if BSP_USING_I2C1
config BSP_I2C1_SCL_PIN
int "i2c1 scl pin number"
range 0 111
default 22
config BSP_I2C1_SDA_PIN
int "I2C1 sda pin number"
range 0 111
default 23
endif
menuconfig BSP_USING_RTC
bool "Enable RTC"
select RT_USING_RTC
default n
if BSP_USING_RTC
choice
prompt "Select clock source"
default BSP_RTC_USING_LSE
config BSP_RTC_USING_LSE
bool "RTC USING LSE"
config BSP_RTC_USING_LSI
bool "RTC USING LSI"
endchoice
endif
config BSP_USING_WDT
bool "Enable Watchdog Timer"
select RT_USING_WDT
default n
menuconfig BSP_USING_HWTIMER
bool "Enable hwtimer"
default n
select RT_USING_HWTIMER
if BSP_USING_HWTIMER
config BSP_USING_HWTIMER1
bool "using hwtimer1"
default n
config BSP_USING_HWTIMER2
bool "using hwtimer2"
default n
config BSP_USING_HWTIMER3
bool "using hwtimer3"
default n
config BSP_USING_HWTIMER4
bool "using hwtimer4"
default n
config BSP_USING_HWTIMER5
bool "using hwtimer5"
default n
config BSP_USING_HWTIMER6
bool "using hwtimer6"
default n
config BSP_USING_HWTIMER7
bool "using hwtimer7"
default n
config BSP_USING_HWTIMER8
bool "using hwtimer8"
default n
endif
menuconfig BSP_USING_ADC
bool "Enable ADC"
default n
select RT_USING_ADC
if BSP_USING_ADC
config BSP_USING_ADC1
bool "using adc1"
default n
config BSP_USING_ADC2
bool "using adc2"
default n
config BSP_USING_ADC3
bool "using adc3"
default n
config BSP_USING_ADC4
bool "using adc4"
default n
endif
menuconfig BSP_USING_DAC
bool "Enable DAC"
default n
select RT_USING_DAC
if BSP_USING_DAC
config BSP_USING_DAC1
bool "using dac1"
default n
config BSP_USING_DAC2
bool "using dac2"
default n
endif
menuconfig BSP_USING_CAN
bool "Enable CAN"
default n
select RT_USING_CAN
if BSP_USING_CAN
config BSP_USING_CAN1
bool "using can1"
default n
config BSP_USING_CAN2
bool "using can2"
default n
endif
source "../libraries/n32_drivers/Kconfig"
endmenu
menu "Board extended module Drivers"
endmenu
endmenu
这个文件就是配置板子驱动的,这里可根据实际需求添加。
(7) 修改bsp/n32/n32g4frml-stb/board/SConscript文件
修改后内容如下:
import os
import rtconfig
from building import *
Import('SDK_LIB')
cwd = GetCurrentDir()
src = Split('''
board.c
''')
path = [cwd]
startup_path_prefix = SDK_LIB
if rtconfig.PLATFORM in ['gcc']:
src += [startup_path_prefix + '/N32G4FR_Firmware_Library/CMSIS/device/startup/startup_n32g4fr_gcc.s']
elif rtconfig.PLATFORM in ['armcc', 'armclang']:
src += [startup_path_prefix + '/N32G4FR_Firmware_Library/CMSIS/device/startup/startup_n32g4fr.s']
elif rtconfig.PLATFORM in ['iccarm']:
src += [startup_path_prefix + '/N32G4FR_Firmware_Library/CMSIS/device/startup/startup_n32g4fr_EWARM.s']
CPPDEFINES = ['N32G4FR']
group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
Return('group')
该文件主要添加board文件夹的.c文件和头文件路径。另外根据开发环境选择相应的汇编文件,和前面的libraries的SConscript语法是一样,文件的结构都是类似的,这里就没有注释了。
到这里,基本所有的依赖脚本都配置完成了,接下来将通过menuconfig配置工程。
5.menuconfig配置
关闭套接字抽象层。
关闭网络设备接口。
关闭LWIP协议栈。
N32G4FRML-STB 开发板板载没有以太网,因此这里主要是关闭网络相关的内容,当然N32G4FRML-STB 开发板的资源丰富,不关这些其实也不影响,如果是其他MCU,根据实际需求自行修改吧。
6.驱动修改
一个基本的BSP中,串口是必不可少的,所以还需要编写串口驱动,这里使用的串口1作为调试串口。
板子上还有LED灯,主要编写GPIO驱动即可。
关于串口和LED的驱动可以查看源码,这里就不贴出来了。
7.应用开发
笔者在applications的main.c中添加LED的应用代码,
#define LED1_PIN GET_PIN(A, 8)
int main (void)
{
rt_pin_mode(LED1_PIN, PIN_MODE_OUTPUT);
while (1)
{
rt_pin_write(LED1_PIN, PIN_HIGH);
rt_thread_mdelay(500);
rt_pin_write(LED1_PIN, PIN_LOW);
rt_thread_mdelay(500);
}
}
当然,这需要GPIO驱动的支持。
8.使用ENV编译工程
在env中执行:scons
编译成功打印信息如下:
9.使用env生成MDK工程
在env中执行:scons --target=mdk5
生成MDK工程后,打开MDK工程进行编译
成功编译打印信息如下:
2.3 使用NS-Link 下载调试N32
N32部分开发板自带NS-link,可以用电路板上的NS-link调试仿真代码,不带的可外接NS-link模块,具体操作方法如下。
1.第一次使用NS-link插入电脑后,会自动安装驱动。
在Options for Target -> Debug 中选择“CMSIS-DAP Debugger”,只有Keil 4.74以上的版本和Keil 5才支持CMSIS-DAP Debugger选项。
2.在Options for Target -> Debug ->Settings勾选SWJ、 Port选择 SW。右框IDcode会出现”0xXBAXXXXX”。
3.在Options for Target -> Debug ->Settings -> Flash Download中添加N32的flash算法。
4.单击下图的快捷方式“debug”, 即可使用NS-Link进行仿真。
当然啦,也可使用NS-Link下载程序。
下载程序成功后,打印信息如下:
接上串口,打印信息如下:
同时LED会不断闪烁。
关于BSP的移植就到这里了,当然还有很多内容,这里只是抛砖引玉。最后希望更多的朋友加入进来,为国产RTOS贡献自己的力量吧。