MAC OS X平台搭建STM32开发环境

      本人主要用MAC作开发,其实MAC平台只要不是用来开发Windows或者是嵌入式的话,作其余任何开发都比较舒服,至少我认为比在windows上要舒服的多。可是坑爹的事情也有,就是若是作嵌入式开发就比较蛋疼了。没办法,蛋疼归蛋疼,该作的也仍是要作的。html

    本人手头上有一块STM32F103VET6的开发板,若是在windows下,那么轻松愉快,装个KeilMDK或者IAR for ARM就搞定了。可是在Mac OS X以及Linux下,就要用Makefile来管理开发了,这些平台上可没有很是方便的IDE供咱们来选择。shell

    好了,废话很少说,下面就进入正题。windows

1、准备工做bash

    至少要准备如下软件,XCode,arm-none-eabi-gcc以及J-Link for MAC。我用的软件版本以下:网络

    XCode6.x  (AppStore 直接安装就行了)app

    gcc-arm-none-eabi-4_8-2014q3-20140805-mac.tar (VeryARM上下载,各个平台都有)electron

    JLink_MacOSX_V500k.pkg   (https://www.segger.com/jlink-software.html 这个地方能够下载)ide

2、环境配置工具

    好了,安装包都准备好了吧?先将gcc-arm-none-eabixxx这个包解压到你自已方便的位置,并在.bash_profile中添加以下环境变量:ui

export PATH=$PATH:$(ARM-TOOLS-ROOT)/bin

其中$(ARM-TOOLS-ROOT)表明工具链解压以后的根目录,请用绝对路径而且路径名不要包含空格。完成以后在shell上执行以下指令使得以上设置的环境变量有效:

 

$ source .bash_profile

完成以后能够在shell中执行以下命令查看时候安装成功:

 

$ arm-none-eabi-gcc -v

若是安装成功,此时会再shell中打印出一堆的gcc的版本信息,若是失败,应该会打印此命令找不到之类的信息,那么确定是环境变量设置出错。

    此时编译工具链已经安装完成,那么再将JLink驱动装上就行了,这个与通常的其余软件安装过程同样。若是安装成功,应该会在/usr/bin下面找到JLinkExe,JFlashSPI等等可执行文件的。

3、代码示例

    本人使用代码目录结构以下图:

       这里主要贴一下Makefile,这些Makefile也是在网上参考了其余人并通过加工而成。主要的Makefile有三个,

Makefile.common这个是公共配置文件,STM32目录下得Makefile以及libs下得Makefile。

一、Makefile.common

 

# include Makefile  
  
#This file is included in the general Makefile, the libs Makefile and the src Makefile  
#Different optimize settings for library and source files can be realized by using arguments  
#Compiler optimize settings:  
# -O0 no optimize, reduce compilation time and make debugging produce the expected results (default).  
# -O1 optimize, reduce code size and execution time, without much increase of compilation time.  
# -O2 optimize, reduce code execution time compared to ‘O1’, increase of compilation time.  
# -O3 optimize, turns on all optimizations, further increase of compilation time.  
# -Os optimize for size, enables all ‘-O2’ optimizations that do not typically increase code size and other code size optimizations.  
#Recommended optimize settings for release version: -O3  
#Recommended optimize settings for debug version: -O0  
#Valid parameters :  
# OptLIB=0 --> optimize library files using the -O0 setting  
# OptLIB=1 --> optimize library files using the -O1 setting  
# OptLIB=2 --> optimize library files using the -O2 setting  
# OptLIB=3 --> optimize library files using the -O3 setting  
# OptLIB=s --> optimize library files using the -Os setting  
# OptSRC=0 --> optimize source files using the -O0 setting  
# OptSRC=1 --> optimize source files using the -O1 setting  
# OptSRC=2 --> optimize source files using the -O2 setting  
# OptSRC=3 --> optimize source files using the -O3 setting  
# OptSRC=s --> optimize source files using the -Os setting  
# all --> build all  
# libs --> build libs only  
# src --> build src only  
# clean --> clean project  
# tshow --> show optimize settings  
#Example:  
# make OptLIB=3 OptSRC=0 all tshow  
  
#TOP=$(shell readlink -f "$(dir $(lastword $(MAKEFILE_LIST)))")  
TOP			= /Users/zhj/Developer/STM32
PROGRAM		= stm32_project
LIBDIR		= $(TOP)/libs

#Adust the following line to the library in use   
STMLIB		= $(LIBDIR)/STM32F10x_StdPeriph_Lib_V3.5.0/Libraries

#Adjust TypeOfMCU in use, see CMSIS file "stm32f10x.h"
#STM32F103RBT (128KB FLASH, 20KB RAM) --> STM32F10X_MD
#STM32F103RET (512KB FLASH, 64KB RAM) --> STM32F10X_HD
#STM32F103ZET (512KB FLASH, 64KB RAM) --> STM32F10X_HD    
TypeOfMCU 	= STM32F10X_HD

# Tool chains settings.
TOOLCHAINS_PREFIX	=	arm-none-eabi
CC					=	$(TOOLCHAINS_PREFIX)-gcc
ld 					=	$(TOOLCHAINS_PREFIX)-ld -v
OBJCOPY 			=	$(TOOLCHAINS_PREFIX)-objcopy
AR 					=	$(TOOLCHAINS_PREFIX)-ar
GDB 				=	$(TOOLCHAINS_PREFIX)-gdb

INCLUDE	 =-I$(TOP)/inc  
INCLUDE	+=-I$(STMLIB)/CMSIS/CM3/CoreSupport
INCLUDE	+=-I$(STMLIB)/CMSIS/CM3/DeviceSupport/ST/STM32F10x
INCLUDE	+=-I$(STMLIB)/STM32F10x_StdPeriph_Driver/inc

COMMONFLAGS		= -g -mcpu=cortex-m3 -mthumb
COMMONFLAGSlib	= $(COMMONFLAGS)
#Commands for general Makefile and src Makefile  
ifeq ($(OptSRC),0)
	COMMONFLAGS	+=	-O0
	InfoTextSrc	 =	src (no optimize, -O0)
else ifeq ($(OptSRC),1)
	COMMONFLAGS +=	-O1
	InfoTextSrc  =	src (optimize time+ size+, -O1)
else ifeq ($(OptSRC),2)
	COMMONFLAGS +=	-O2
	InfoTextSrc  =	src (optimize time++ size+, -O2)
else ifeq ($(OptSRC),s)
	COMMONFLAGS +=	-Os
	InfoTextSrc  =	src (optimize size++, -Os)
else  
	COMMONFLAGS	+=	-Os
	InfoTextSrc  = 	src (full optimize, -O3)
endif
CFLAGS  +=  $(COMMONFLAGS) -Wall -Werror $(INCLUDE)
CFLAGS  +=  -D$(TypeOfMCU)
CFLAGS  +=  -DUSE_STDPERIPH_DRIVER
  
#Commands for libs Makefile  
ifeq ($(OptLIB),0)
	COMMONFLAGSlib	+=  -O0
	InfoTextLib		 =  libs (no optimize, -O0)
else ifeq ($(OptLIB),1)
	COMMONFLAGSlib	+=  -O1
	InfoTextLib		 =	libs (optimize time+ size+, -O1)
else ifeq ($(OptLIB),2)
	COMMONFLAGSlib  +=  -O2
	InfoTextLib		 =  libs (optimize time++ size+, -O2)
else ifeq ($(OptLIB),s)
	COMMONFLAGSlib	+=  -Os
	InfoTextLib		 =  libs (optimize size++, -Os)
else  
	COMMONFLAGSlib	+=	-O3
	InfoTextLib		 =	libs (full optimize, -O3)
endif  
CFLAGSlib += $(COMMONFLAGSlib) -Wall -Werror $(INCLUDE)
CFLAGSlib += -D$(TypeOfMCU)
CFLAGSlib += -DUSE_STDPERIPH_DRIVER

二、libs下的Makefile是用来编译STM32标准驱动库的,生成的中间文件在libs/out/tmp中,而最后成果在libs/out/lib中。请看具体内容:

 

# libs Makefile  
include ../Makefile.common 

INC       = -I$(TOP)/src
LIBS 	  = libstm32.a   
OBJOUTDIR = $(LIBDIR)/out/tmp
LIBOUTDIR = $(LIBDIR)/out/lib

MY_C_SOURCES := $(wildcard $(STMLIB)/CMSIS/CM3/CoreSupport/*.c)
MY_C_SOURCES += $(wildcard $(STMLIB)/CMSIS/CM3/DeviceSupport/ST/STM32F10x/*.c)
MY_C_SOURCES += $(wildcard $(STMLIB)/STM32F10x_StdPeriph_Driver/src/*.c)

SOURCES := $(patsubst %.c, %.c, $(MY_C_SOURCES))

MY_S_SOURCES := $(STMLIB)/CMSIS/CM3/DeviceSupport/ST/STM32F10x/startup/gcc_ride7/startup_stm32f10x_hd.s
S_OBJS 		 := $(patsubst %.s, %.o, $(MY_S_SOURCES))

OBJS				:= $(patsubst %.c, %.o, $(SOURCES))
OBJSWITHOUTDIR 		:= $(patsubst %.c, $(OBJOUTDIR)/%.o, $(notdir $(SOURCES)))
OBJSWITHOUTDIR		+= $(OBJOUTDIR)/$(notdir $(S_OBJS))

all: $(LIBS) 

$(LIBS):$(OBJS) $(S_OBJS)
	$(AR) cr $(LIBOUTDIR)/$@ $(OBJSWITHOUTDIR)

.PHONY: clean tshow
  
clean:
	rm -f $(LIBOUTDIR)/*.a
	rm -f $(OBJOUTDIR)/*.o

show:
	@echo $(MY_C_SOURCES)
	@echo 
	@echo $(SOURCES)
	@echo 
	@echo $(OBJS)
	@echo 

tshow:  
	@echo "#####################################################################################"  
	@echo "################# optimize settings: $(InfoTextLib), $(InfoTextSrc)"  
	@echo "#####################################################################################"  

$(S_OBJS): $(MY_S_SOURCES)
	$(CC) $(CFLAGSlib) -c $< -o $(OBJOUTDIR)/$(notdir $@)

%.o:%.c
	$(CC) $(CFLAGSlib) $(INC) -c $< -o $(OBJOUTDIR)/$(notdir $@)

三、编译二进制可执行文件的Makefile,就在与Makefile.common同级的目录中。它编译的结果包括中间文件都在src/out目录中,这里的编译会用到libs下生成的libstm32.a文件。

 

# general Makefile  
  
include Makefile.common  

PROGRAM	  = stm32_project
LIBS 	  = libstm32.a   
OBJOUTDIR = $(TOP)/src/out/tmp
BINOUTDIR = $(TOP)/src/out/bin
LIBOUTDIR = $(LIBDIR)/out/lib
INC 	  = -I$(TOP)/src

LDFLAGS=$(COMMONFLAGS) -fno-exceptions -ffunction-sections -fdata-sections \
	-L$(LIBOUTDIR) -Wl,--no-whole-archive -lstm32 \
	-nostartfiles -Wl,--gc-sections,-T$(TOP)/src/stm32_flash.ld  

MY_C_SOURCES 		:= $(wildcard $(TOP)/src/*.c)
SOURCES 			:= $(patsubst %.c, %.c, $(MY_C_SOURCES))
OBJS				:= $(patsubst %.c, %.o, $(SOURCES))
OBJSWITHOUTDIR 		:= $(patsubst %.c, $(OBJOUTDIR)/%.o, $(notdir $(SOURCES)))

.PHONY: libs clean tshow  show
all: libs src  
  
libs:
	$(MAKE) -C $@
	
src: $(OBJS)
	$(CC) -o $(BINOUTDIR)/$(PROGRAM).elf $(OBJSWITHOUTDIR) $(LDFLAGS)
	$(OBJCOPY) -O ihex $(BINOUTDIR)/$(PROGRAM).elf $(BINOUTDIR)/$(PROGRAM).hex
	$(OBJCOPY) -O binary $(BINOUTDIR)/$(PROGRAM).elf $(BINOUTDIR)/$(PROGRAM).bin
	arm-none-eabi-readelf -a $(BINOUTDIR)/$(PROGRAM).elf > $(BINOUTDIR)/$(PROGRAM).info_elf
	arm-none-eabi-size -d -B -t $(BINOUTDIR)/$(PROGRAM).elf > $(BINOUTDIR)/$(PROGRAM).info_size
	arm-none-eabi-objdump -S $(BINOUTDIR)/$(PROGRAM).elf > $(BINOUTDIR)/$(PROGRAM).info_code
	arm-none-eabi-nm -t d -S --size-sort -s $(BINOUTDIR)/$(PROGRAM).elf > $(BINOUTDIR)/$(PROGRAM).info_symbol

%.o:%.c
	$(CC) $(CFLAGS) $(INC) -c $< -o $(OBJOUTDIR)/$(notdir $@)

clean:
	$(MAKE) -C libs $@
	-rm -r $(OBJOUTDIR)/*.o
	@cd $(BINOUTDIR)
	-rm -f $(PROGRAM).elf $(PROGRAM).hex $(PROGRAM).bin $(PROGRAM).info_elf $(PROGRAM).info_size
	-rm -f $(PROGRAM).info_code
	-rm -f $(PROGRAM).info_symbol
	@cd ..

show:
	@echo $(MY_C_SOURCES)
	@echo 
	@echo $(SOURCES)
	@echo 
	@echo $(OBJS)
	@echo 
	@echo $(OBJSWITHOUTDIR)

tshow:  
	@echo "######################################################################################################"  
	@echo "################# optimize settings: $(InfoTextLib), $(InfoTextSrc)"  
	@echo "######################################################################################################"

四、当文件都配置稳当,那么就能够在STM32这一级目录中执行make指令,若是一块儿正常就会在src/out/bin下生成一个stm32_project.bin的文件,这个文件就是最终要烧录到开发板的二进制文件。

五、还要注意的是,注意程序在连接的时候须要一个连接脚本,这个脚本定义了连接过程当中全部代码的定位问题。因此必定要注意其配置。这个文件在STM32标准驱动库中的Project/STM32F10x_StdPerihp_Template/TrueSTUDIO中每一EVAL目录中有示例,主要区别就是目标MCU的RAM/FLASH的大小。必定注意,我使用的STM32F103VET6是512KB flash/64KB RAM,其连接脚本(stm32_flash.ld)以下:

 

/*
*****************************************************************************
**
**  File        : stm32_flash.ld
**
**  Abstract    : Linker script for STM32F103ZE Device with
**                512KByte FLASH, 64KByte RAM
**
**                Set heap size, stack size and stack location according
**                to application requirements.
**
**                Set memory bank area and size if external memory is used.
**
**  Target      : STMicroelectronics STM32
**
**  Environment : Atollic TrueSTUDIO(R)
**
**  Distribution: The file is distributed “as is,” without any warranty
**                of any kind.
**
**  (c)Copyright Atollic AB.
**  You may use this file as-is or modify it according to the needs of your
**  project. Distribution of this file (unmodified or modified) is not
**  permitted. Atollic AB permit registered Atollic TrueSTUDIO(R) users the
**  rights to distribute the assembled, compiled & linked contents of this
**  file as part of an application binary file, provided that it is built
**  using the Atollic TrueSTUDIO(R) toolchain.
**
*****************************************************************************
*/

/* Entry Point */
ENTRY(Reset_Handler)

/* Highest address of the user mode stack */
_estack = 0x20010000;    /* end of 64K RAM */

/* Generate a link error if heap and stack don't fit into RAM */
_Min_Heap_Size = 0;      /* required amount of heap  */
_Min_Stack_Size = 0x200; /* required amount of stack */

/* Specify the memory areas */
MEMORY
{
  FLASH (rx)      : ORIGIN = 0x08000000, LENGTH = 512K
  RAM (xrw)       : ORIGIN = 0x20000000, LENGTH = 64K
  MEMORY_B1 (rx)  : ORIGIN = 0x60000000, LENGTH = 0K
}

/* Define output sections */
SECTIONS
{
  /* The startup code goes first into FLASH */
  .isr_vector :
  {
    . = ALIGN(4);
    KEEP(*(.isr_vector)) /* Startup code */
    . = ALIGN(4);
  } >FLASH

  /* The program code and other data goes into FLASH */
  .text :
  {
    . = ALIGN(4);
    *(.text)           /* .text sections (code) */
    *(.text*)          /* .text* sections (code) */
    *(.rodata)         /* .rodata sections (constants, strings, etc.) */
    *(.rodata*)        /* .rodata* sections (constants, strings, etc.) */
    *(.glue_7)         /* glue arm to thumb code */
    *(.glue_7t)        /* glue thumb to arm code */

    KEEP (*(.init))
    KEEP (*(.fini))

    . = ALIGN(4);
    _etext = .;        /* define a global symbols at end of code */
  } >FLASH


   .ARM.extab   : { *(.ARM.extab* .gnu.linkonce.armextab.*) } >FLASH
    .ARM : {
    __exidx_start = .;
      *(.ARM.exidx*)
      __exidx_end = .;
    } >FLASH

  .ARM.attributes : { *(.ARM.attributes) } > FLASH

  .preinit_array     :
  {
    PROVIDE_HIDDEN (__preinit_array_start = .);
    KEEP (*(.preinit_array*))
    PROVIDE_HIDDEN (__preinit_array_end = .);
  } >FLASH
  .init_array :
  {
    PROVIDE_HIDDEN (__init_array_start = .);
    KEEP (*(SORT(.init_array.*)))
    KEEP (*(.init_array*))
    PROVIDE_HIDDEN (__init_array_end = .);
  } >FLASH
  .fini_array :
  {
    PROVIDE_HIDDEN (__fini_array_start = .);
    KEEP (*(.fini_array*))
    KEEP (*(SORT(.fini_array.*)))
    PROVIDE_HIDDEN (__fini_array_end = .);
  } >FLASH

  /* used by the startup to initialize data */
  _sidata = .;

  /* Initialized data sections goes into RAM, load LMA copy after code */
  .data : AT ( _sidata )
  {
    . = ALIGN(4);
    _sdata = .;        /* create a global symbol at data start */
    *(.data)           /* .data sections */
    *(.data*)          /* .data* sections */

    . = ALIGN(4);
    _edata = .;        /* define a global symbol at data end */
  } >RAM

  /* Uninitialized data section */
  . = ALIGN(4);
  .bss :
  {
    /* This is used by the startup in order to initialize the .bss secion */
    _sbss = .;         /* define a global symbol at bss start */
    __bss_start__ = _sbss;
    *(.bss)
    *(.bss*)
    *(COMMON)

    . = ALIGN(4);
    _ebss = .;         /* define a global symbol at bss end */
    __bss_end__ = _ebss;
  } >RAM

  PROVIDE ( end = _ebss );
  PROVIDE ( _end = _ebss );

  /* User_heap_stack section, used to check that there is enough RAM left */
  ._user_heap_stack :
  {
    . = ALIGN(4);
    . = . + _Min_Heap_Size;
    . = . + _Min_Stack_Size;
    . = ALIGN(4);
  } >RAM

  /* MEMORY_bank1 section, code must be located here explicitly            */
  /* Example: extern int foo(void) __attribute__ ((section (".mb1text"))); */
  .memory_b1_text :
  {
    *(.mb1text)        /* .mb1text sections (code) */
    *(.mb1text*)       /* .mb1text* sections (code)  */
    *(.mb1rodata)      /* read-only data (constants) */
    *(.mb1rodata*)
  } >MEMORY_B1

  /* Remove information from the standard libraries */
  /DISCARD/ :
  {
    libc.a ( * )
    libm.a ( * )
    libgcc.a ( * )
  }
}

4、使用J-Link下载代码到MCU

    好了,如今咱们拥有一个能够烧录的stm32_project.bin文件。如今请将J-LINK链接到你的MAC而且为开发板供电。

若是J-LINK链接正常,那么系统信息中会显示J-Link设备。个人设备以下:

   

    如今可使用安装好的J-LINK驱动将bin文件下载到MCU得内置flash中。请先在shell中进入的工程根目录,并在shell执行以下命令:

$ JLinkExe
J-Link>

    如今您能够在此命令行中执行相关命令来下载bin文件。首先要执行device这条指令用来指定您的目标MCU,个人是STM32F103VET6,因此以下:

 

J-Link > exec device=STM32F103VE

    是否成功会有消息提示,请仔细阅读。

    在使用以上命令选择了目标MCU以后,就能够下载bin文件了,以下:

 

J-Link > loadbin src/out/bin/stm32_project.bin 0x08000000

    其中loadbin为命令,紧接着为文件名,再接着为目标MCU内置Flash的起始地址。这个地址依赖具体的MCU,请查阅相关Datasheet,但应该与stm32_flash.ld中memory section中Flash描述的起始地址同样,及以下:

 

/* Specify the memory areas */
MEMORY
{
  FLASH (rx)      : ORIGIN = 0x08000000, LENGTH = 512K
  RAM (xrw)       : ORIGIN = 0x20000000, LENGTH = 64K
  MEMORY_B1 (rx)  : ORIGIN = 0x60000000, LENGTH = 0K
}

    其中的 FLASH(rx) 中的ORIGIN就表示Flash的起始地址,上述命令中的地址应该与其保持一致。若是这条命令执行成功就会打印出OK等字样,而且会打印相关打印的时间信息等。

    大功告成,如此一来,只要将MCU复位,就能够看到代码的执行效果了。

5、总结

    本文主要介绍了Mac OS X下如何搭建STM32的开发环境。其实本文中的Makefile仍是不太完善,由于每次执行make全部的文件都会从新编译,可是不影响功能,相关完善就再也不发文,请知悉。文中内容均为原创,只有Makefile.common的部份内容摘录自网络,转载请注明出处,谢谢。

相关文章
相关标签/搜索