【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

时间:2024-10-20 23:36:56

习惯了ST的库,猛然间看到ATMEL的库,有点无从下手。这几天参考这示例工程,终于建立了一个使用ATMEl库的工程。

软件库版本:

软件平台:MDK470A

硬件平台:英蓓特 EB-SAM3S

MCU:     AT91SAM3S4C

1、库的来源

库来自atmel的网站:http://www.atmel.com/tools/SAM3SSOFTWAREPACKAGE.aspx

我使用的工具链是MDK,下载的是:AT91SAM3S-EK MDK® Software Package for Keil uVision4

http://www.atmel.com/images/SAM3S_softpack_2.1_for_uVision_4.12.zip(需要Atmel注册才能下载)

2、MDK中需要设置的地方

因为要使用ATMEL提供的的库,所以需要根据库的要求对开发环境进行一些设置:

板子使用芯片SAM3S4C,设置预定义符号sam3s4。

将于库的目录和用到的。h文件目录加到IncludePath里边(根据下一部分目录结构定)

命令选项:--gnu。因为库里边有些东西不是ANIS C的。比如变量定义不再函数的最前面等等

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

设置输出目录如下:

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

3、一步步建立工程

启动文件请参见本博的另一个博文:http://www.cnblogs.com/zyqgold/p/3201527.html

本文使用ATMEl的启动处理方式,即:注册中断向量之后,从resethandler进入main函数。

(1)新建目录E:\at91sam3s4c,并在该目录下建立文件夹:chip、at91lib、out、src

(2)将刚才从ATMEl下载到的库压缩包解压缩

(3)将目录\SAM3S_softpack_2.1_for_uVision_4.12\sam3s-ek\libraries\libboard_sam3s-ek下的两个文件夹include、source已经board.h拷贝到at91lib目录E:\at91sam3s4c\at91lib

(4)将目录\SAM3S_softpack_2.1_for_uVision_4.12\sam3s-ek\libraries\libchip_sam3s下的文件夹cmsis、include、source以及文件chip.h拷贝到目录E:\at91sam3s4c\chip

(5)MDK中,在E:\at91sam3s4c新建工程at91sam3s4c_LED,选择MCU AT91SAM3S4C

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

(6)电机确定后会弹出对话框,询问是否要拷贝启动文件,选择是。当然我们不是要使用这个启动文件,之后我们将会改写这个文件。

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

7、电机【AT91SAM3S】建立基于SAM3S库的工程并点亮LED设置工程组织结构如下:

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

(8)向工程添加文件

将E:\at91sam3s4c\at91lib\source中的board_cstartup_keil.c和board_lowlevel.c文件添加到工程的at91lib目录下,将E:\at91sam3s4c\chip\source中的exceptions.c、wdt.c、pmc.c、pio.c文件添加到工程的chip目录。将E:\at91sam3s4c\chip\cmsis中的core_cm3.c文件添加到工程的chip目录

在E:\at91sam3s4c\src中新建文件main.c,并添加到工程的usr目录。

(9)添加工程引用位置(IncludePath)

E:\at91sam3s4c;.\chip\cmsis;.\at91lib;.\at91lib\include;.\chip;.\chip\include

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

(10)编辑sct文件:

在工程选项的Linker选项卡中,首先取消Use Memory Layout...之前的选择,然后点击ScatterFile选择框后边的EDIT。使用自己的分散加载描述文件

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

(11)想分散加载描述文件中添加内容:

; *************************************************************
; *** Scatter-Loading Description File generated by uVision ***
; *************************************************************

Load_region 0x400000 0x40000
{
    ; Flash 256K
    Vector_region 0x400000
    {
        board_cstartup_keil.o (vectors, +FIRST)
    }
    Fixed_region +0
    {
        .ANY (+RO)
    }
    ; SRAM0 32K
    Relocate_region 0x20000100 (0x8000-0x100)
    {
        .ANY (+RW +ZI)
    }
    ; Configure Stack and Heap
    ARM_LIB_HEAP 0x20007000 EMPTY 0x400
    {
    }

ARM_LIB_STACK 0x20007FFC EMPTY -0x400
    {
    }
}

(12)编辑文件startup_SAM3S.s

删除该文件所有的内容,因为我们不用MDK提供的启动文件。之后向这个文件添加内容:

AREA WORKAROUND,CODE,READONLY
EXTERN  __vector_table
LDR     r0,=__vector_table
ALIGN
END

这些内容的意思可参考http://www.cnblogs.com/zyqgold/p/3201527.html

(13)最后按F7生成即可。此时工程中还没有main函数,系统会报错。不用急,完成下一步就好了。

4、用库写一个点灯程序

板子LED的原理图如下:

【AT91SAM3S】建立基于SAM3S库的工程并点亮LED

即3个LED分别由PA19、PA20和PC20驱动。PA19、PA20电平为高时D2、D3被点亮,PC20为低电平时D4被点亮。

#include "board.h"

int main()
{
    Pin LED2,LED3,LED4;  //定义三个引脚结构体,三个引脚分别对应三个LED
    WDT_Disable(WDT); //复位时候看门狗默认是打开的,手动关掉。不让MCU反复复位

LED2.mask = PIO_PA19;   //引脚属性定义
    LED2.pio = PIOA;
    LED2.id = ID_PIOA;
    LED2.type = PIO_OUTPUT_1;
    LED2.attribute = PIO_DEFAULT;
   
    LED3.mask = PIO_PA20;
    LED3.pio = PIOA;
    LED3.id = ID_PIOA;
    LED3.type = PIO_OUTPUT_1;
    LED3.attribute = PIO_DEFAULT;
   
    LED4.mask = PIO_PA20;
    LED4.pio = PIOC;
    LED4.id = ID_PIOC;
    LED4.type = PIO_OUTPUT_0;
    LED4.attribute = PIO_DEFAULT;
   
    Pin pinlist[] = {LED2,LED3,LED4}; //专门为库函数定义的Pin列
    uint32_t numLeds = PIO_LISTSIZE( pinlist ) ;  //库里边建议这么写的
   
    PIO_Configure(pinlist,numLeds);   //库函数初始化Pin
   
    PIO_Clear(&LED2);//点亮D2
    PIO_Clear(&LED3);  //点亮D3
    PIO_Set(&LED4);  //点亮D4

while(1);
}

最后,下载到板子上。等一会就会看见板子上的3个LED亮了。等一会的原因,是这个板子的晶振稳定的比较慢,不要怪MCU哦。