2. 开发环境搭建：Keil/IAR/GCC工具链配置，JLink/ST-Link调试器使用，工程模板建立

在蓝牙芯片适配实战中，开发环境的搭建是决定后续调试效率与代码质量的基础环节。本章将围绕三大主流工具链（Keil MDK、IAR EWARM、GCC + Makefile）的配置要点、两种常用调试器（JLink、ST-Link）的接入方法，以及可复用的工程模板结构展开讲解。目标是在30分钟内建立起一套“编译-烧录-调试”闭环环境。

2.1 工具链对比与选型建议

不同工具链在编译效率、调试体验、许可证成本上差异明显。下表从蓝牙芯片开发者的视角进行对比：

2.2 Keil MDK 工具链配置

2.2.1 安装与器件包管理

1. 安装 Keil MDK v5.38 或更高版本（建议使用最新稳定版）。
2. 通过 Pack Installer 安装对应蓝牙芯片的器件支持包（如 Nordic nRF52840_DFP、STM32WB55_DFP）。
3. 安装 CMSIS-Core 与 CMSIS-Driver 包，确保中断控制器与外设驱动层可用。

2.2.2 工程模板建立步骤

以下是一个标准的蓝牙芯片Keil工程模板结构：

Project_Template/
├── RTE/                    # Run-Time Environment 自动生成
│   ├── Device/
│   │   ├── startup_*.s     # 芯片启动文件（中断向量表）
│   │   └── system_*.c      # 系统时钟初始化
│   ├── Board/              # 板级支持包（LED、按键等）
│   └── Bluetooth/          # 蓝牙协议栈抽象层（SoftDevice或Zephyr）
├── User/                   # 用户代码
│   ├── main.c
│   ├── app_ble.c/h
│   ├── app_interrupt.c/h
│   └── app_drivers.c/h
├── Drivers/                # 外设驱动（GPIO、UART、SPI、Timer）
├── Middleware/              # 中间件（FreeRTOS、FatFS等）
├── Linker/                 # 分散加载文件（.sct）
└── Project.uvprojx         # Keil工程文件

2.2.3 中断向量表配置

Keil 使用分散加载文件（.sct）控制中断向量表的放置。对于蓝牙芯片，通常需要将中断向量表重定位到RAM中，以便协议栈动态更新。以下是一个典型的 .sct 文件片段：

LR_IROM1 0x00000000 0x00100000  {    ; 加载区：Flash起始地址与大小
  ER_IROM1 0x00000000 0x00100000  {
    *.o (RESET, +First)            ; 中断向量表放在Flash开头
    *(InRoot$$Sections)
    .ANY (+RO)
  }
  RW_IRAM1 0x20002000 0x0003E000  { ; 运行区：RAM起始地址（避开协议栈占用）
    .ANY (+RW +ZI)
  }
}

2.3 IAR EWARM 工具链配置

2.3.1 工程模板与ICF文件

IAR 使用 .icf 文件（ILINK Configuration File）替代 .sct。以下是一个针对蓝牙芯片的 ICF 配置示例：

define symbol __ICFEDIT_region_ROM_start__  = 0x00000000;
define symbol __ICFEDIT_region_ROM_end__    = 0x000FFFFF;
define symbol __ICFEDIT_region_RAM_start__  = 0x20002000;
define symbol __ICFEDIT_region_RAM_end__    = 0x2003FFFF;

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__];

place in ROM_region   { readonly section .intvec };  // 中断向量表
place in ROM_region   { readonly };
place in RAM_region   { readwrite, block HEAP, block CSTACK };

2.3.2 中断优先级分组配置

IAR 的启动文件中，中断优先级分组通常在 __iar_program_start 之前设置。在蓝牙协议栈中，必须确保优先级分组为 4位抢占优先级、0位子优先级（即 NVIC_SetPriorityGrouping(3)），以满足协议栈对中断嵌套的要求。

2.4 GCC + Makefile 工具链配置

2.4.1 工具链安装与路径设置

以 Ubuntu 22.04 为例，安装 GNU Arm Embedded Toolchain：

sudo apt update
sudo apt install gcc-arm-none-eabi binutils-arm-none-eabi libnewlib-arm-none-eabi
# 验证安装
arm-none-eabi-gcc --version

2.4.2 Makefile 核心结构

以下是一个支持蓝牙芯片中断向量表自动生成的 Makefile 模板：

# 工具链前缀
PREFIX   = arm-none-eabi-
CC       = $(PREFIX)gcc
LD       = $(PREFIX)ld
OBJCOPY  = $(PREFIX)objcopy
SIZE     = $(PREFIX)size

# 芯片与链接脚本
MCU      = -mcpu=cortex-m4 -mthumb -mfloat-abi=softfp -mfpu=fpv4-sp-d16
LINK_SCRIPT = bluetooth_chip.ld

# 源文件
SRCS     = startup.c system.c main.c app_ble.c app_interrupt.c
OBJS     = $(SRCS:.c=.o)

# 编译标志
CFLAGS   = $(MCU) -O2 -g -Wall -Werror -I./inc -DUSE_HAL_DRIVER
LDFLAGS  = $(MCU) -T$(LINK_SCRIPT) --specs=nano.specs --specs=nosys.specs

all: firmware.hex

%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

firmware.elf: $(OBJS) $(LINK_SCRIPT)
	$(CC) $(LDFLAGS) $(OBJS) -o $@
	$(SIZE) $@

firmware.hex: firmware.elf
	$(OBJCOPY) -O ihex $< $@

clean:
	rm -f *.o *.elf *.hex

2.4.3 链接脚本中的中断向量表

GCC 使用 .ld 链接脚本。以下片段展示了如何将中断向量表放置在Flash开头，并预留RAM空间：

MEMORY
{
    FLASH (rx)  : ORIGIN = 0x00000000, LENGTH = 1M
    RAM   (rwx) : ORIGIN = 0x20002000, LENGTH = 248K
}

SECTIONS
{
    .isr_vector :
    {
        KEEP(*(.isr_vector))  /* 中断向量表 */
        . = ALIGN(4);
    } > FLASH

    .text :
    {
        *(.text*)
        *(.rodata*)
    } > FLASH

    .data : AT (ADDR(.text) + SIZEOF(.text))
    {
        _sdata = .;
        *(.data*)
        _edata = .;
    } > RAM

    .bss :
    {
        _sbss = .;
        *(.bss*)
        _ebss = .;
    } > RAM
}

2.5 JLink 与 ST-Link 调试器配置

2.5.1 调试器对比

2.5.2 JLink 配置步骤

1. 安装 SEGGER J-Link Software Pack（包含JLinkGDBServer、JFlash、JLinkSWDView等工具）。
2. 连接调试器：SWDIO → SWDIO，SWCLK → SWCLK，GND → GND，VCC → 3.3V（可选，用于电平检测）。
3. 在Keil中：Project → Options → Debug → 选择 J-Link / J-Trace Cortex → Settings → 确认SWD速度（建议初始设为4 MHz，稳定后再提高）。
4. 在GCC环境中，使用以下命令启动GDB Server：

JLinkGDBServer -device NRF52840_XXAA -if SWD -speed 4000 -port 2331

然后使用 arm-none-eabi-gdb 连接：

target remote localhost:2331
monitor reset
monitor halt
load firmware.elf
continue

2.5.3 ST-Link 配置步骤

1. 安装 STM32CubeProgrammer 或 ST-Link Utility，确保驱动正确安装。
2. 在IAR中：Project → Options → Debugger → Setup → Driver 选择 ST-Link → 在 Interface 中选择 SWD。
3. 在GCC环境中，使用 OpenOCD 作为桥接工具：

openocd -f interface/stlink.cfg -f target/stm32wbx.cfg -c "program firmware.hex verify reset exit"

2.6 工程模板建立与验证

2.6.1 模板目录结构

一个可复用的蓝牙芯片工程模板应包含以下核心文件：

ble_chip_template/
├── startup/               # 启动文件与中断向量表
│   ├── startup_ble.s      # 汇编启动文件（Keil/IAR/GCC三版本）
│   └── system_ble.c       # 系统时钟与中断优先级初始化
├── linker/                # 链接脚本
│   ├── ble_chip.sct       # Keil分散加载
│   ├── ble_chip.icf       # IAR配置
│   └── ble_chip.ld        # GCC链接脚本
├── drivers/               # 外设驱动层
│   ├── gpio.c/h
│   ├── uart.c/h
│   └── timer.c/h
├── ble_stack/             # 蓝牙协议栈抽象层
│   ├── ble_stack_if.c/h   # 协议栈初始化与事件回调
│   └── ble_gap.c/h        # GAP层接口
├── app/                   # 应用层
│   ├── main.c
│   └── app_config.h       # 引脚定义、中断优先级宏
├── Makefile               # GCC构建脚本
├── ble_chip.uvprojx       # Keil工程文件
└── ble_chip.eww           # IAR工作空间文件

2.6.2 验证流程

1. 编译验证：分别在Keil、IAR、GCC下执行全编译，确认无错误与警告。
2. 烧录验证：使用JLink或ST-Link烧录固件，观察芯片启动后LED闪烁或串口打印。
3. 中断验证：触发一个外部中断（如按键），在中断服务函数中翻转GPIO，使用逻辑分析仪或示波器确认响应时间。
4. 蓝牙协议栈验证：调用协议栈初始化函数，确认协议栈事件回调被正确触发。

2.7 本章小结