企业官网建设流程全解析

简介：这份资源是NXP官方为基于Cortex-M3内核的LPC17xx系列微控制器提供的完整例程包，面向嵌入式初学者与有一定基础的开发者，帮助其快速上手芯片各功能模块并应用于工业控制、消费电子、通信接口等实际项目。压缩包共2687个文件，约57.03MB，以c源码与h头文件为核心，配合大量html说明文档、uvproj/uvopt工程文件、ewp/ewd/eww工程配置、makefile构建脚本及s汇编文件，另含pdf手册、gif/png图示与少量lib、hex、map等编译产物，覆盖从源码到工程配置的完整开发链路。内容围绕中断系统、GPIO、SPI、I2C、UART、定时器与PWM、ADC/DAC、USB设备与OTG、闪存编程调试、电源管理及FreeRTOS移植等知识点展开，每个模块均配有可直接编译运行的示例。已有753人学习下载，适合作为系统级编程与项目排错的常备参考。

1. 拿到 lpc17xx 官方例程先别急着编译：三个反直觉的真相

如果你手上正捏着一块 LPC1768 或 LPC1752 的开发板，打开 Keil 或 IAR 准备从零写 GPIO 翻转，大概率会在时钟配置那一步卡住——PLL0 的 M、N、P 值算不对，外设时钟使能顺序搞反，串口打印出来全是乱码。lpc17xx 官方例程就是为这种场景准备的：它把 Cortex-M3 内核、时钟系统、GPIO、UART、SPI、I2C、PWM、ADC、CAN 这些外设的寄存器级操作，按功能模块拆成一个个独立可编译的工程，每个工程只做一件事，代码量小、依赖少、寄存器注释全。适合谁？适合刚拿到板子要验证硬件好坏的嵌入式新手，也适合从 STM32 标准库转过来、需要快速摸清 NXP 这套外设寄存器命名习惯的老手。但先别急着点编译——官方例程有三个反直觉的地方：第一，它默认的晶振频率不一定匹配你板子上的实际晶振；第二，不同版本的例程对 CMSIS 和启动文件的选择有差异；第三，有些例程依赖外部扩展板，裸板跑不起来。这三个坑不先搞清楚，编译通过也看不到现象。

2. 例程目录结构与工程配置：从哪开始改，改哪几个数

2.1 目录里到底放了什么

拿到一份 lpc17xx 官方例程包，解压后通常能看到这样的结构：根目录下按外设名分文件夹，比如GPIO、UART、SPI、I2C、PWM、ADC、CAN、TIMER、RTC、WDT、SSP、DAC、EXTI、SYSTICK等。每个文件夹里一般包含src（源文件）、inc（头文件）、project（Keil 或 IAR 工程文件），以及一个readme.txt或doc文件夹说明该例程的硬件连接要求。公共代码放在Common或Drivers目录下，主要是lpc17xx_*.c/h这一套外设驱动库，以及system_LPC17xx.c系统初始化文件、startup_LPC17xx.s启动汇编文件、core_cm3.h内核头文件。

我一般会先打开Common目录确认三件事：system_LPC17xx.c里的SystemInit()函数是否被工程引用、startup_LPC17xx.s里的堆栈大小是否够用、lpc17xx_libcfg_default.h里是否把不需要的外设驱动关掉了。这三处不改，后面编译报错会像多米诺骨牌一样倒过来。

2.2 工程配置里必须核对的四个参数

以 Keil MDK 为例，打开任意一个例程工程后，点开 Options for Target，重点看四个地方：

晶振频率这一项最容易翻车。官方例程默认按 12 MHz 外部晶振计算 PLL 参数，但市面上很多 LPC1768 开发板焊的是 8 MHz 或 16 MHz 晶振。如果你不改这个值，系统时钟就不是预期的 100 MHz，串口波特率会跟着偏，打印出来就是乱码。改法很简单：在system_LPC17xx.c里找到#define CLOCK_SETUP和#define XTAL_FREQ，把XTAL_FREQ改成你板子的实际值，然后重新计算 PLL0 的 M、N、P 参数。

2.3 时钟配置：PLL0 参数怎么算

LPC17xx 的 PLL0 输出公式是：

Fcco = (2 * M * Fin) / N Fcpu = Fcco / (2 * P)

其中 Fin 是外部晶振频率，M 是倍频系数（1~256），N 是分频系数（1~32），P 是后分频系数（1、2、4、8）。约束条件是 Fcco 必须在 156 MHz 到 320 MHz 之间，Fcpu 不能超过 100 MHz。

以 12 MHz 晶振、目标 100 MHz 系统时钟为例，一组可用参数是 M=25、N=3、P=2：

Fcco = (2 * 25 * 12) / 3 = 200 MHz Fcpu = 200 / (2 * 2) = 50 MHz

等等，这里算出来是 50 MHz，不是 100 MHz。要得到 100 MHz，需要调整 P 值或 M/N 组合。常见做法是 M=50、N=3、P=2：

Fcco = (2 * 50 * 12) / 3 = 400 MHz // 超出 320 MHz 上限

所以 12 MHz 晶振下要得到 100 MHz，需要 M=25、N=3、P=1：

Fcco = (2 * 25 * 12) / 3 = 200 MHz Fcpu = 200 / (2 * 1) = 100 MHz

这组参数在官方例程的system_LPC17xx.c里通常已经写好，但如果你换了晶振，就得重新算。我一般会写个小脚本或者用表格把常用晶振对应的参数列出来，省得每次手算。

/* system_LPC17xx.c 中 PLL0 配置片段 */ #define CLOCK_SETUP 1 #define XTAL_FREQ 12000000 /* 改成你板子的晶振频率 */ #define PLL0_SETUP 1 #define PLL0_CFG (1 << 0) | (1 << 1) | (1 << 2) | (1 << 3) | (1 << 4) | (1 << 5) | (1 << 6) | (1 << 7) | (1 << 8) | (1 << 9) | (1 << 10) | (1 << 11) | (1 << 12) | (1 << 13) | (1 << 14) | (1 << 15) | (1 << 16) | (1 << 17) | (1 << 18) | (1 << 19) | (1 << 20) | (1 << 21) | (1 << 22) | (1 << 23) | (1 << 24) #define PLL0CFG_Val 0x00050063 /* M=25, N=3 的编码值 */ #define PLL0_FEED_Val 0x000000AA /* 喂狗序列 */ #define PLL0_STAT_Val 0x00000000

上面这段代码里，PLL0CFG_Val的编码方式是：低 8 位是 N-1，高 16 位是 M-1。所以 M=25、N=3 对应(24 << 16) | 2，即0x00180002。不同版本的例程可能用不同的宏名，但编码规则是一样的。改完参数后，一定要在SystemInit()里确认 PLL0 锁定判断和时钟切换顺序没被跳过。

2.4 外设驱动库的裁剪与引用

官方例程的lpc17xx_libcfg_default.h里有一堆#define _GPIO、#define _UART0这样的开关。如果你只跑 GPIO 例程，把其他外设的宏注释掉，编译出来的代码会小很多，也避免了一些外设时钟未使能导致的硬件异常。我一般会保留_GPIO、_UART0、_SYSTICK这三个，其他按需开。

引用驱动库时，工程里要包含lpc17xx_libcfg_default.h和对应的lpc17xx_*.c文件。有些例程用的是旧版驱动库，函数名和寄存器定义跟新版有差异，比如GPIO_SetDir在新版里可能叫GPIO_SetDir但参数顺序变了。遇到编译报错说函数未定义，先检查驱动库版本和头文件包含路径。

3. 从 GPIO 到 UART：把第一个例程跑出预期现象

3.1 GPIO 例程：点灯和按键消抖

GPIO 例程通常是第一个要跑的。官方例程里一般会做两件事：配置某个引脚为输出，翻转电平；配置另一个引脚为输入，读按键状态。代码结构大致如下：

#include "lpc17xx.h" #include "lpc17xx_gpio.h" #define LED_PIN (1 << 18) /* P1.18 接 LED */ #define KEY_PIN (1 << 10) /* P2.10 接按键 */ void delay_ms(uint32_t ms) { uint32_t i, j; for (i = 0; i < ms; i++) for (j = 0; j < 8000; j++); /* 粗略延时，实际项目用 SysTick */ } int main(void) { /* 配置 P1.18 为输出 */ GPIO_SetDir(1, LED_PIN, 1); /* 配置 P2.10 为输入 */ GPIO_SetDir(2, KEY_PIN, 0); while (1) { if (GPIO_ReadValue(2) & KEY_PIN) { delay_ms(20); /* 消抖 */ if (GPIO_ReadValue(2) & KEY_PIN) { GPIO_SetValue(1, LED_PIN); /* 点亮 */ while (GPIO_ReadValue(2) & KEY_PIN); /* 等待释放 */ GPIO_ClearValue(1, LED_PIN); /* 熄灭 */ } } } }

这段代码里，GPIO_SetDir(port, pin_mask, direction)的第三个参数 1 表示输出、0 表示输入。GPIO_SetValue和GPIO_ClearValue分别置位和清零，不要用GPIO_WriteValue直接写整个端口，否则会影响到同端口其他引脚。按键消抖用delay_ms是权宜之计，实际项目里建议用 SysTick 定时器做状态机消抖，不然主循环会被阻塞。

跑 GPIO 例程时，如果 LED 不亮，先拿万用表量引脚电压有没有翻转。有翻转但灯不亮，检查 LED 极性是不是接反了，或者限流电阻太大。没翻转，检查GPIO_SetDir的端口号和引脚号是否和原理图一致——LPC17xx 的引脚分布比较散，P1.18 和 P2.10 在不同封装上可能不存在。

3.2 UART 例程：波特率计算与中断收发

UART 例程比 GPIO 复杂一点，因为涉及波特率计算和中断。LPC17xx 的 UART 波特率公式是：

BaudRate = PCLK / (16 * (256 * DLL + DLM) * (1 + DivAddVal / MulVal))

其中 PCLK 是外设时钟（通常等于系统时钟除以 4 或 1，取决于 PCLKSEL 寄存器），DLL 和 DLM 是除数锁存寄存器的低 8 位和高 8 位，DivAddVal 和 MulVal 是小数分频器。官方例程一般会提供一个UART_SetBaudRate函数，你只需要传入波特率值，它自动算 DLL、DLM、DivAddVal、MulVal。

#include "lpc17xx_uart.h" void UART0_Init(uint32_t baudrate) { UART_CFG_Type uartCfg; UART_FIFO_CFG_Type fifoCfg; /* 配置 UART0 引脚 P0.2(TXD0), P0.3(RXD0) */ PINSEL_CFG_Type pinCfg; pinCfg.Portnum = 0; pinCfg.Pinnum = 2; pinCfg.Funcnum = 1; pinCfg.Pinmode = PINSEL_PINMODE_PULLUP; pinCfg.OpenDrain = PINSEL_PINMODE_NORMAL; PINSEL_ConfigPin(&pinCfg); pinCfg.Pinnum = 3; PINSEL_ConfigPin(&pinCfg); /* UART 基本配置 */ uartCfg.Baud_rate = baudrate; uartCfg.Databits = UART_DATABIT_8; uartCfg.Parity = UART_PARITY_NONE; uartCfg.Stopbits = UART_STOPBIT_1; UART_Init(LPC_UART0, &uartCfg); /* FIFO 配置 */ fifoCfg.FIFO_ResetRxBuf = ENABLE; fifoCfg.FIFO_ResetTxBuf = ENABLE; fifoCfg.FIFO_DMAMode = DISABLE; fifoCfg.FIFO_Level = UART_FIFO_TRGLEV0; UART_FIFOConfig(LPC_UART0, &fifoCfg); UART_TxCmd(LPC_UART0, ENABLE); }

这段代码里，PINSEL_ConfigPin把 P0.2 和 P0.3 复用为 UART0 的 TXD 和 RXD。UART_Init内部会根据传入的Baud_rate自动计算分频参数。UART_FIFOConfig里的FIFO_Level决定中断触发深度，一般设UART_FIFO_TRGLEV0表示收到 1 个字节就触发。如果串口助手收到乱码，先检查波特率是否和 PC 端一致，再检查 PCLK 是否和预期一致——PCLK 不对，算出来的分频值就是错的。

3.3 中断向量表与 NVIC 配置

LPC17xx 的中断向量表在startup_LPC17xx.s里定义，每个外设中断对应一个弱符号函数名，比如UART0_IRQHandler、TIMER0_IRQHandler。你要用哪个中断，就在自己的 C 文件里重新实现同名函数，然后在NVIC_EnableIRQ里使能对应的中断号。

void UART0_IRQHandler(void) { uint8_t data; if (UART_GetIntId(LPC_UART0) & UART_IIR_INTID_RDA) { data = UART_ReceiveByte(LPC_UART0); UART_SendByte(LPC_UART0, data); /* 回显 */ } } /* 在初始化里使能中断 */ NVIC_EnableIRQ(UART0_IRQn); UART_IntConfig(LPC_UART0, UART_INTCFG_RBR, ENABLE);

这里有个容易忽略的点：UART_GetIntId返回的中断 ID 要跟UART_IIR_INTID_RDA做位与判断，不能直接等号比较，因为 IIR 寄存器高几位可能有多余标志。另外，中断服务函数里不要做耗时操作，回显一个字节就够了，收一整包数据建议用环形缓冲区加主循环处理。

4. 避坑与排查：五个让例程跑不起来的常见问题

4.1 编译通过但灯不闪，示波器量不到波形

现象：工程编译零错误零警告，下载后 LED 不亮，示波器测引脚无电平变化。

原因：最常见的是SystemInit()没被调用。官方例程的启动文件里会在跳转到main之前调用SystemInit，但如果你换了启动文件或者手动改了向量表，这一步可能被跳过。系统时钟没配好，外设时钟就没使能，GPIO 寄存器写不进去。

解决：在main函数开头手动调用一次SystemInit()，或者在启动文件里确认Reset_Handler中LDR R0, =SystemInit和BLX R0这两条指令还在。另外检查PINSEL寄存器是否把引脚配成了 GPIO 功能，有些引脚默认是其他复用功能。

4.2 串口打印乱码，换波特率也不行

现象：串口助手收到一堆乱码，改波特率、改数据位停止位都无效。

原因：系统时钟频率和预期不符。比如板子焊的是 8 MHz 晶振，但system_LPC17xx.c里XTAL_FREQ还是 12 MHz，PLL 算出来的 Fcpu 就不是 100 MHz，UART 分频值跟着错。还有一种可能是 PCLKSEL 寄存器把 UART 的时钟源分频了，导致实际 PCLK 和代码里假设的不一样。

解决：先用示波器或逻辑分析仪量一下 UART TX 引脚上的波形，算一下实际波特率。如果实际波特率是预期的 2/3 或 3/4，基本就是晶振频率设错了。改XTAL_FREQ后重新编译，同时检查lpc17xx_clkpwr.c里CLKPWR_SetPCLKDiv的调用，确认 UART 时钟分频值是 1 还是 4。

4.3 中断进不去，程序卡在启动文件

现象：下载后程序不跑，调试器显示 PC 停在HardFault_Handler或Default_Handler。

原因：中断向量表偏移不对，或者中断服务函数名拼写错误。LPC17xx 的向量表默认从 0x00000000 开始，如果你用了 Bootloader 或者把程序烧到其他地址，需要设置SCB->VTOR寄存器。另外，C 文件里的中断函数名必须和启动文件里的弱符号名完全一致，大小写都不能错。

解决：在SystemInit()里加上SCB->VTOR = 0x00000000;（如果程序从 Flash 起始地址跑）。检查启动文件里UART0_IRQHandler的拼写，然后在 C 文件里用同样的名字定义。如果用了 RTOS，还要确认 RTOS 的中断接管机制没有把向量表改掉。

4.4 例程依赖外部扩展板，裸板跑不起来

现象：某些例程编译下载后没现象，但代码逻辑看起来没问题。

原因：官方例程里有一部分是针对官方评估板写的，比如 LCD 例程需要接 LCD 扩展板，CAN 例程需要接 CAN 收发器，ADC 例程需要外部提供模拟电压。你手上只有一块最小系统板，这些外设不存在，自然看不到现象。

解决：先看例程目录下的readme.txt或doc文件夹，确认硬件要求。如果没有扩展板，可以改代码用 GPIO 模拟或者跳过外设初始化，只验证核心逻辑。比如 ADC 例程可以改成读内部温度传感器通道，CAN 例程可以改成回环模式测试。

4.5 Keil 和 IAR 工程不兼容，换编译器报一堆错

现象：Keil 工程用 IAR 打开，或者反过来，编译报错说找不到头文件、寄存器定义冲突。

原因：两个编译器的启动文件、链接脚本、预定义宏都不一样。Keil 用startup_LPC17xx.s和.sct分散加载文件，IAR 用startup_LPC17xx.s和.icf配置文件。驱动库里的__inline、__weak等关键字在两个编译器下写法也有差异。

解决：不要混用工程文件。如果必须换编译器，从对应版本的例程包里找匹配的工程文件，或者手动把源文件添加到新工程里，然后根据编译器手册调整启动文件和链接配置。我一般会在项目根目录下同时保留Keil和IAR两个文件夹，各放各的工程文件，源文件用相对路径引用，避免路径混乱。

5. 进阶：用 SysTick 做非阻塞延时和任务调度

跑通几个例程之后，你会发现delay_ms这种阻塞延时在稍微复杂一点的应用里根本不够用——按键响应迟钝、串口收数据丢包、多个任务互相卡。LPC17xx 的 SysTick 定时器是 Cortex-M3 内核自带的，配置简单，适合做毫秒级系统节拍。我一般会用它搭一个极简的时间片轮询框架，不跑 RTOS 也能让多个任务看起来“同时”运行。

配置 SysTick 的代码如下：

#include "lpc17xx_systick.h" volatile uint32_t g_tick = 0; void SysTick_Handler(void) { g_tick++; } void SysTick_Init(uint32_t ms) { /* SystemCoreClock 在 system_LPC17xx.c 里定义，单位 Hz */ SYSTICK_InternalInit(ms); SYSTICK_IntCmd(ENABLE); SYSTICK_Cmd(ENABLE); } uint32_t GetTick(void) { return g_tick; } /* 非阻塞延时：检查时间差，不占用 CPU 空转 */ uint8_t IsTimeout(uint32_t start, uint32_t timeout_ms) { return ((g_tick - start) >= timeout_ms); }

SYSTICK_InternalInit(ms)的参数是毫秒数，内部会根据SystemCoreClock自动算重装载值。SysTick_Handler里只做一件事：递增全局 tick 计数。主循环里用IsTimeout判断是否到了执行某个任务的时间，到了就执行，没到就继续轮询其他任务。这样按键消抖可以改成状态机，串口收数据可以放到环形缓冲区，LED 闪烁和传感器读取互不干扰。

一个典型的时间片轮询结构：

int main(void) { SystemInit(); SysTick_Init(1); /* 1ms 节拍 */ UART0_Init(115200); GPIO_Init(); uint32_t last_led = 0, last_key = 0, last_uart = 0; while (1) { uint32_t now = GetTick(); if (IsTimeout(last_led, 500)) { last_led = now; GPIO_ToggleLED(); } if (IsTimeout(last_key, 10)) { last_key = now; Key_Scan_StateMachine(); } if (IsTimeout(last_uart, 5)) { last_uart = now; UART_Process_RxBuffer(); } } }

这个框架的边界在于：任务执行时间不能超过节拍周期，否则会互相挤占。如果某个任务要跑几十毫秒，要么把它拆成状态机分步执行，要么上 RTOS。我一般会在每个任务函数入口和出口翻转一个空闲 GPIO，用示波器看任务实际耗时，超过节拍就优化。

从那以后我每次拿到新的 LPC17xx 例程包，都强制走一遍这个流程：先核对晶振频率和 PLL 参数，再确认启动文件和向量表，然后从 GPIO 例程开始点灯，接着跑 UART 确认时钟链路，最后用 SysTick 搭时间片框架。这套顺序走下来，后面再复杂的例程也只是在这个基础上加外设驱动而已。希望帮到你。

本文还有配套的精品资源，点击获取