简介：这是一份面向九齐NY8系列单片机开发者的全型号例程合集，覆盖NY8A、NY8B、NY8T等主流子系列，具体包括NY8A051D、NY8A053D、NY8B062D、NY8BE62D等数十款常见芯片，适合从入门到进阶的嵌入式工程师按需查阅。资源共112个文件，包含40个h头文件、17个nysln工程文件、17个cb配置文件、17个naprj工程文件、9个asm汇编源码、8个c源码及说明文档，压缩包仅335KB，轻量易用。目录按芯片型号分层组织，便于快速定位初始化、GPIO控制、定时器、PWM、ADC、UART、I2C、SPI等外设驱动示例；所有例程均提供标准C语言与传统汇编两种实现，兼顾不同开发习惯与项目需求。配套include文件夹包含常用头文件与宏定义，NY8 C文件夹集中存放C语言工程模板，History.txt记录版本更新说明，并附卸载程序便于环境清理。目前已有50人学习下载，适合需要对照真实工程快速上手九齐单片机开发的读者。 好久没在博客里写这类实战总结了。正好最近把九齐NY8系列单片机的例程库从头到尾整理了一遍，从NY8A、NY8B到NY8T的主流型号，C语言和汇编两套代码都重新捋了捋，踩了不少坑，也补了不少之前没搞清楚的细节。这篇就当是自己的一个项目复盘，顺便把能直接拿来抄作业的东西都放出来，给正在用九齐或者准备从51、STM32转过来的朋友做个参考。
先说说这份合集到底是什么。九齐（Nyquest）的NY8系列是一类8位内核的OTP/MTP单片机，主打小家电、消费电子、玩具、灯控这类成本敏感、功能不算复杂的场景，一颗芯片的价格通常在几毛到一两块钱之间，资源也从1K ROM、64字节RAM这种“极小杯”到4K ROM、256字节RAM的“中杯”不等。我这份例程合集不搞花架子，就是把每个型号的GPIO、定时器、中断、PWM、ADC、睡眠唤醒这些基础外设，分别用C和汇编写一遍，再加几个完整的小应用，比如按键长按短按、呼吸灯、一路PWM调光、电池电压检测，全是实际项目里天天用的东西。内容价值一句话概括：你不用再从零啃数据手册一个个试寄存器，直接把代码拉过来改改引脚和参数就能跑。
这套合集适合谁看呢？一类是刚接触八位单片机、想低成本做个小产品的硬件工程师；另一类是常年用ST、NXP这类资源丰富MCU，忽然被项目逼着换“资源抠门”方案的软件工程师。后者最容易栽跟头，因为习惯了堆库函数、多开几个外设，到NY8上会非常不适应。这篇帖子我不打算讲太多高深理论，主要聊整理这套合集时的思路、代码组织方式，以及那些数据手册不会写、但实际调试一定会遇到的教训。
1. 我为什么攒了这份NY8例程合集，它到底能干什么
1.1 九齐NY8系列是一颗什么样的单片机
把NY8系列放在整个单片机生态里看，它的定位和经典的51单片机很像，但比51更极端。51至少还有比较完善的Keil生态和众多教学资源，而九齐属于台湾系八位机的一大分支，同类的还有辉芒微、应广这类，核心卖点就是一个字：省。省到引脚最少的型号只有6个脚，省到内部RC振荡器可以直接跑，省到几个分钱的成本差异都能决定项目能不能量产。当然，省也会有代价——没有昂贵的调试器，资料相对分散，开发环境也比较小众，代码写不好还会出现各种奇怪的复位、跑飞现象。
NY8系列的内部结构并不复杂，CPU核心是单周期的精简8位RISC架构，大部分指令一条周期就能执行完，速度在同级别里算快的。片上集成的东西也很务实：一路或两路定时器、若干路PWM、AD转换、比较器、上电复位、低压检测，该有的小件都有，唯独没有硬件乘法器、没有DMA这些东西。所以拿到这颗芯片第一件事就是调整心态：它不是STM32，不要指望外设自动接管一切，很多时候连一个简单的延时都得自己算周期。
1.2 合集覆盖的型号与内容构成
这份合集一开始只写了NY8A051D一个型号的例程，后来因为项目需要又把手上的NY8B062D、NY8T系列等几颗料也拉了进来，顺便建了一个统一的代码目录结构。最终内容大概这样的：
| 型号系列 | 覆盖例程 | 语言版本 | 典型封装 | 主要用途 |
|---|---|---|---|---|
| NY8A系列 | GPIO/定时器/中断/ADC/低功耗 | C + 汇编 | SOT23-6、DIP8、SOP8 | 低成本小家电、玩具、灯控 |
| NY8B系列 | 上述全部 + PWM/比较器/多IO驱动 | C + 汇编 | SOP14、SOP16、DIP14 | 功能稍复杂的家电面板、风扇、充电器协议 |
| NY8T系列 | 基础例程 + 触摸或特殊封装适配 | 以C为主 | SOP8、SOP16 | 触摸按键、对成本极度敏感的量产方案 |
每个型号下都放着一套最小工程模板，不管是C还是汇编，拿过去直接改就能用。另外，我还在顶层放了一个doc/文件夹，里面是我整理过的各型号数据手册的关键页扫描笔记，包括寄存器映射、中断向量表、封装引脚功能复用表。这玩意儿在调试的时候救了我好几次，因为九齐官网的PDF分得散，同一个系列不同型号的数据手册排版还不一样，经常翻半天找不到一个寄存器在哪页。
2. 选型之前先搞清楚NY8A/NY8B/NY8T的区别
2.1 从命名规则看资源配置
九齐这颗料的型号命名相当有规律，看懂之后选型基本不用问代理。以NY8A051D为例：NY8是系列名，A是大类，051代表具体的ROM/RAM配置档位，最后的D一般是封装或版本后缀。不同字母开头的大类，定位差异非常明显：
- NY8A系列：最入门、最抠资源的行列，ROM大多在1K到2K左右，RAM几十字节，适合代码量千行以内的小控制逻辑。比如一个单按键电子蜡烛、一个闪烁LED胸牌，用这个绰绰有余。
- NY8B系列：资源比A系列明显宽松一档，IO数量也更多，支持的功能更全。如果要做带数码管显示的电饭煲面板、多档位风扇遥控解码这类程序体积稍大的活，建议直接从B系列起步。
- NY8T系列：从名字就能看出，偏向触控应用。内部会带一些和触摸检测相关的模拟前端，做小家电触摸按键比A系列裸用IO扫描稳很多。
还有一点容易忽略，九齐有不少型号是**OTP（一次性可编程）**的，代码烧进去就改不了了，所以调试阶段千万别直接用OTP型号，要先选同系列的MTP（多次可编程）版本，或者用带窗口的工程样品。吃过一次亏之后我把所有例程工程都区分了_otp和_mtp两种编译宏，就是提醒自己别烧错芯片。
2.2 选型思路与适用场景
我在整理例程的过程中总结了一套自己的选型顺序，分享出来供参考：
- 先数引脚需求。先看产品需要多少个IO，包括按键、LED、传感器输入、输出驱动管。别只算功能需要的，还得算上烧录接口占用的引脚，否则画完板子发现烧录口被复用掉了，调试时只能干瞪眼。
- 再算程序体积。写C语言的话，即便很简单的一个功能，编译出来可能也要0.5K以上，所以1K ROM的型号只建议做逻辑极其简单的小玩意儿。凡是有串口打印、多级菜单、复杂状态机需求的，至少选2K以上。
- 最后看电压和功耗场景。如果产品要电池供电，注意选静态功耗低的型号，并且要确认是否有真正可用的掉电模式。NY8这颗料在睡眠模式下能跑到微安级别的电流，但前提是外部电路不能漏电，否则再省电的单片机也白搭。
3. C语言例程的核心部分怎么组织
3.1 从工程模板到第一盏LED
很多从大厂MCU转过来的朋友看到九齐的官方例程会有点懵：没有标准外设库，没有HAL，甚至没有统一的启动文件风格。C语言例程里，说白了就是直接和寄存器打交道。我整理例程时的第一件事，就是建立一套足够“朴素”且稳定的工程模板。
先看GPIO点亮LED这节。NY8系列的端口控制寄存器并不多，核心就是方向寄存器、数据寄存器，再加上上拉、开漏这些选项。C代码写起来大概是这种感觉：
// 以NY8B062D为例，点亮接在PB0上的LED #include <ny8.h> void main(void) { // 设置PCON等系统控制寄存器，选择内部16MHz RC振荡器 PCON = 0x00; // PB0配置为输出方向 PB0 = 0; // 先输出低电平 _pb0 = 1; // 某些型号用位操作寄存器，需看头文件定义 PB0CON |= 0x01; // 配置PB0为IO功能而非其他复用功能 while (1) { // 简单延时，注意NY8没有标准库delay for (volatile unsigned int i = 0; i < 30000; i++); PB0 = ~PB0; // 翻转电平 } }这里有一个很重要的坑：NY8系列没有硬件除法指令，也没有标准的delay库函数，所有延时基本靠循环计数或者定时器。而循环计数的延时时间又和编译器优化等级强相关，volatile关键字不能省，否则优化器看到循环体没有实际输出，直接就把整个延时循环删掉了，程序跑起来LED闪得快到看不清。
3.2 定时器、PWM与ADC例程的代码思路
定时器在八位机上属于“用了就知道效率差距”的外设。NY8的定时器通常是8位的，带有预分频器，一两个定时器要同时承担延时、计数、PWM、唤醒计时等多种任务。例程里我一般会用定时器0做时基，保持一个软件计数器累加，这样主循环和中断都能共享一套时间基准：
volatile unsigned int systemTick = 0; void interrupt(void) { if (T0IF) { T0IF = 0; systemTick++; } }PWM这块，NY8很多型号自带PWM输出模块，但通道数有限，而且引脚复用关系比较复杂，例程里专门做了一个简单的PWM调光案例：通过定时器中断维护一个软件PWM，把硬件PWM留给出声音或者需要更精准频率的场合。这样做的好处是代码可移植性强，换一颗没有硬件PWM的型号也能直接跑；缺点是占CPU，而且LED调光频率低于1kHz时肉眼看得出闪烁。所以实际产品里如果PWM频率需求固定，还是优先用硬件模块。
ADC例程就更有意思了。NY8的AD转换结果寄存器宽度不同型号不太一样，有的10位，有的12位。我用一个结构体把AD相关的寄存器、通道、参考电压配置封装起来，每个型号再单独写适配层，上层调用时就统一用adc_read(channel)这个函数。这就引入了这套例程里最关键的一个设计原则：底层寄存器每家都不同，但给应用层的接口尽量统一。后续换芯片，应用代码改动量能控制在很小的范围。
4. 汇编例程的保留价值与学习路径
4.1 为什么还要保留汇编例程
现在写八位单片机，纯汇编的比例确实越来越低了，但我在整理这套合集时坚持每个型号都配一份汇编例程。原因有三个：第一，NY8这类芯片的C编译器在优化能力上远不如Keil对51的锤炼程度，有些时序敏感的操作，比如读写单总线温湿度传感器、模拟时序去驱动WS2812这类灯带，用C写很容易因为几纳秒级别的时序偏差导致通信失败，汇编则能把每条指令的周期算得明明白白；第二，中断入口、现场保护、启动代码这块，不懂汇编的话连startup文件都不敢动，出问题只能干着急；第三，学习任何一款新架构，汇编例程是最快理解寄存器-硬件-指令集三者关系的捷径。
4.2 中断现场保护与C/汇编混编的注意事项
NY8的中断向量通常就一个入口，这就意味着所有中断源共用一个中断函数。在C语言里写interrupt关键字的函数时编译器会自动生成入栈出栈代码，可一旦涉及汇编和C混编，现场保护就得自己盯着。我例程里专门放了一份纯汇编的中断处理骨架，核心代码大概长这样：
; 中断入口 ORG 0x08 ; 中断向量地址 NOP GOTO ISR_Entry ISR_Entry: MOVAR ACC_SAVE ; 保存累加器到自定义RAM备份区 SWAPR STATUS, 0 MOVAR STATUS_SAVE MOVAR PFLAG_SAVE ; 根据标志位跳转到对应中断处理 BCR INT_FLAG ... ; 恢复现场 MOVR STATUS_SAVE, 0 SWAPR STATUS, 0 MOVR ACC_SAVE, 0 RETIE这里的坑主要在于：不要轻易在中断里调用C函数，因为C函数会假设自己的局部变量空间是干净的，如果中断前主程序正好在运行一个更复杂的表达式，中断里再调用C函数很可能造成变量覆盖或者栈溢出。汇编例程里解决这个问题的方式很粗暴——中断服务程序只做标志位置位、简单的寄存器备份，真正复杂的处理全部放到主循环的轮询里。这个保守策略在资源极小的芯片上是完全正确的，稳定压倒一切。
5. 从安装到烧录的完整环境搭建过程
5.1 工具链选择与工程创建
九齐官方主推的集成开发环境是NYPIDE，也有不少老工程师还在用较早的IDE版本配合第三方插件。我的建议是直接用官方最新的IDE，因为旧版本在Windows 10/11上容易出现驱动签名问题，新版本对汇编器和C编译器的集成更顺滑。安装过程不复杂，一路默认就行，但要注意安装路径最好全英文，不要包含空格和中文，否则后面编译汇编文件经常报找不到文件。
新建工程的时候，IDE会要求选择具体型号，这一步千万别选错。同一系列不同型号的寄存器定义头文件是不同的，选错型号之后编译可能正常通过，但烧进去芯片完全不工作。我刚开始整理例程时就在NY8A051和NY8A050之间栽了一次，两个型号差异非常小，代码烧进NY8A050也能跑，但ADC采集值异常，排查了好几个小时。
工程创建好后，C编译器和汇编器会自动生成启动文件。如果是C工程，默认会带上一个小启动文件，主要做RAM清零、堆栈指针初始化，然后再跳转到main。这个启动文件我不建议去动，除非你已经完全搞懂了芯片的上电复位流程。
5.2 烧录与调试流程
烧录这块，九齐官方烧录器配合上位机软件使用。OTP芯片烧录是一次性的，操作前一定要确认三件事：
- 芯片型号选对，防止烧录器依赖型号信息做烧录时序控制。
- 烧录座引脚接触良好，SOT23-6这类小封装放在烧录座上非常容易虚焊，烧录校验失败多半是接触问题，而不是芯片坏了。
- 配置位设置正确，包括系统时钟、看门狗、低电压复位这些选项。注意，配置位的优先级比程序代码高，代码里初始化得再好，配置位把看门狗设成了永远开启，芯片还是会不停复位。
让我没想到的是，调试过程中用不了在线仿真，因为OTP芯片本来就不支持片上调试。所以我的调试手段非常原始：用LED、用蜂鸣器、用IO口输出方波接示波器，再配合串口或者逻辑分析仪。这套方法虽然土，但在资源极小的八位机上反而最可靠。我最常用的招数是测试点翻IO：怀疑哪段代码没执行，就在那里放一个IO翻转，用示波器一看便知。
6. 整理和移植这些例程时踩过的坑
6.1 高频问题排查速查表
整理这套合集最大的价值，就是把散落在各个项目里的“灵异事件”集中复盘了一遍。下面这张表是我遇到频率最高的问题，直接可以当排查手册用：
| 现象 | 可能原因 | 解决思路 |
|---|---|---|
| 芯片完全没反应，电流几乎为零 | 进入了睡眠模式但唤醒条件不满足 | 检查唤醒引脚配置、看门狗是否关闭、复位脚电平是否被拉死 |
| 程序偶发跑飞，表现是功能突然失效 | 堆栈溢出或中断里调用了重入函数 | 精简中断服务程序，主循环里处理一切非实时逻辑 |
| 定时器时间不准，误差远大于晶振偏差 | 预分频器配置错误或循环延时被优化 | 数一遍指令周期，或用示波器实测翻转频率再校正参数 |
| 端口读到的电平不稳定 | 没有配置上拉电阻，悬空输入 | 设置内部上拉，外部再加一个10k电阻上拉更稳 |
| 烧录完之后校验失败 | 烧录座接触不良或芯片被静电打坏 | 清洁烧录座，加防静电手环，用MTP芯片先验证代码 |
| 上电瞬间IC误动作，比如LED亮一下 | 复位时间不够，IO默认状态是输入高阻 | 增加上电延时，主程序一开始就设好所有IO方向 |
6.2 几个容易翻车、但数据手册不会写的细节
第一个是IO口的复用切换。NY8很多引脚是多功能的，同一个物理引脚，既可以做普通IO，又可以接定时器PWM输出。关键在于配置顺序——必须先切到GPIO模式，再配置方向，否则引脚在切换过程中可能会输出一个意外的电平，直接驱动三极管导通、把负载打开半秒钟。那种“上电瞬间电机抖一下”的现象，十有八九是这个原因。
第二个是掉电模式的唤醒时间。NY8从睡眠到正常运行，内部振荡器需要一段稳定时间，不同型号差别较大，快的几十微秒，慢的可能要一两毫秒。如果唤醒之后立刻去采样ADC或者驱动外部设备，数据大概率是错的。我的做法是唤醒之后先空转一小段时间，让系统时钟稳下来再继续干活。
第三个是编译器版本导致的代码差异。同一份C代码，在不同版本的IDE里编译出来的指令序列完全不同，尤其是涉及到位操作的时候。比如_pb0 = 1这种位操作，有的编译器会编译成BSET这样一条指令，有的编译器会转换成“读-改-写”三条指令。如果这个IO口正好同时作为外部中断输入，那读改写中间的电平抖动就可能造成误触发。针对这类问题，我例程里每条位操作都尽量加注释，标明该操作是否为原子操作，换编译器版本的时候一定要重点回归测试。
最后分享一点个人体会
我在整理这套合集的过程中，最大的感受就是：做小芯片的项目，跟做大芯片完全是两种思路。大芯片可以靠资源换开发效率，随便写写就能跑；而NY8这类单片机更像是在螺蛳壳里做道场，每一步都要精打细算。但也正是因为资源少，逼着你去把每一个寄存器、每一条指令都吃透，写完一个功能之后对整个体系的底层理解会扎实很多。如果你正准备上手九齐NY8系列，我建议先从NY8A的C语言GPIO例程跑通，再用汇编中断例程把现场保护这段吃透，然后挑一个带ADC的B系列型号做一个小项目。等你把这份合集里的代码都过一遍，再回头看数据手册，就会发现那些原本玄乎的寄存器配置，其实都有了清晰的画面感。
本文还有配套的精品资源，点击获取
