1. 项目概述与核心思路最近在创客圈子里合宙的Air001开发板可以说是火得一塌糊涂。包装设计得挺酷价格更是香到没朋友最关键的是它完美支持Arduino IDE开发对于咱们这些习惯了Arduino生态的玩家来说上手门槛几乎为零。我拿到板子后就在琢磨除了跑跑例程点个灯这颗性价比超高的Air001芯片还能玩出什么更有趣的花样直到我看到了社区大佬“灰太狼烤着吃”开源的这个“地球名片”项目瞬间就被吸引了。这不仅仅是一个简单的开发板应用而是一个融合了硬件设计、嵌入式编程和一点艺术创意的完整DIY作品。它的核心构想是打造一张以“地球”为主题的交互式电子卡片。这张“名片”集成了OLED屏幕、多种LED灯效、触摸感应和物理按键能够动态显示地球相关信息、自定义文字并伴有丰富的灯光动画。它更像是一个放在桌面上兼具科技感和观赏性的小摆件或者是一个能让人眼前一亮、展示技术品味的创意礼物。我决定亲手复刻这个项目一方面是想深度体验一下Air001的综合性能另一方面也是被这种将技术融入生活美学的理念所打动。整个复刻过程从读懂原理图、采购物料、焊接调试到代码编写充满了挑战和乐趣。下面我就把这次从零开始制作“地球名片”的完整过程、踩过的坑以及积累的经验毫无保留地分享给大家。无论你是刚接触Arduino的新手还是有一定经验的硬件爱好者相信这份详实的记录都能为你提供清晰的路径和实用的参考。2. 硬件深度解析与物料选型“地球名片”的硬件设计是项目成功的基石。它采用了一块双面贴片的PCB作为载体将所有功能模块紧凑地集成在一张卡片大小的空间里设计非常精巧。2.1 核心主控合宙Air001芯片剖析为什么选择Air001这是项目起点的一个关键决策。Air001是一款基于ARM Cortex-M0内核的微控制器主频最高48MHz拥有64KB Flash和16KB SRAM。对于这个项目而言它的优势非常明显性能足够驱动128x64的OLED屏幕SSD1306、处理多个按键和触摸输入、控制PWM灯光效果这些任务对M0内核来说游刃有余。外设丰富它具备多路GPIO、I2C、SPI、ADC等接口完美契合了本项目需要连接屏幕I2C、检测按键GPIO输入、控制LEDPWM输出以及实现触摸感应ADC检测的所有需求。开发友好官方提供了完善的Arduino核心支持包意味着你可以使用熟悉的Arduino API和海量的开源库进行开发极大地降低了软件层面的难度。成本与尺寸极致的性价比和较小的封装QFN32使其成为此类创意小制作的理想选择。在物料清单中你需要确认购买的是合宙Air001的芯片而非已经焊接在开发板上的模块。因为我们需要将芯片直接焊接在自定义的PCB上。2.2 主要功能模块与物料清单基于开源项目的设计我们需要准备以下核心物料。这里我不仅列出名称还会说明选型要点和备选方案方便你采购时参考。模块名称规格/型号数量关键选型说明与注意事项主控芯片合宙 Air001 (QFN32封装)1务必确认是QFN32封装。焊接需要热风枪新手可购买已植好锡的芯片或寻求帮助。OLED屏幕0.96寸 I2C接口 SSD1306驱动 (128x64)1选择4针VCC, GND, SCL, SDA的版本。注意屏幕尺寸需与PCB开孔匹配。PCB电路板“地球名片”专用双面PCB1项目开源文件包含Gerber制版文件可在嘉立创等平台下单打样。建议选择沉金工艺利于焊接。LED灯珠0805封装贴片LED (多种颜色)若干用于PCB正面的装饰性灯光。注意区分颜色和亮度需根据原理图确定具体位置和数量。陶瓷LED灯5mm直插式 (例如暖白/蓝色)1位于地球图案中心作为主视觉灯。需准备配套的灯座。轻触按键6x6mm 贴片轻触开关4用于模式切换、灯光控制等。注意高度要适中避免与外壳如果有干涉。拨动开关小型贴片拨码开关2分别控制OLED屏幕和地球LED的总电源。电池管理3.7V锂电池 (如602530规格)、充电保护一体模块1套选择带TP4056芯片的微型充放电模块支持USB充电和放电保护。电池容量建议200-300mAh。触摸感应区————PCB上设计有裸露的铜箔区域地球圆环和铭牌利用Air001的ADC功能检测人体触摸无需额外物料。被动元件电阻、电容、电感 (0805封装)1套根据原理图BOM清单采购。电阻值、电容容值必须准确尤其是I2C的上拉电阻。提示第一次制作时强烈建议在立创商城等平台根据开源项目的BOM表物料清单一键配单可以避免漏件或错件。电阻电容等小元件可以多买一些焊接时损耗难免。2.3 电路设计要点解读虽然我们直接使用开源的PCB设计但理解其电路原理对调试和故障排查至关重要。电源管理整个系统由3.7V锂电池供电经过充放电模块后一路直接给LED供电另一路通过一个低压差线性稳压器LDO降至3.3V为Air001芯片和OLED屏幕供电。确保LDO的输出电压稳定在3.3V是系统可靠工作的前提。I2C总线OLED屏幕通过I2C与Air001通信。PCB上通常会在SDA和SCL线上预留4.7kΩ的上拉电阻位置。如果焊接后发现屏幕无法通信首先检查这两个电阻是否已焊上。触摸感应原理这是项目的亮点之一。PCB上的触摸铜箔连接至Air001的ADC引脚。当手指触摸时相当于引入了一个对地的电容会导致ADC读取的电压值发生微小变化。程序通过持续检测这个电压变化来判断触摸事件而非使用专用的触摸芯片节省了成本。LED驱动装饰LED多为直接由GPIO口通过限流电阻驱动。而中心的地球陶瓷LED因其电流可能较大可能会用到三极管或MOS管进行驱动具体需查看原理图。灯光效果呼吸、闪烁则通过GPIO的PWM功能实现。3. 焊接组装全流程实操指南焊接是硬件制作中最考验耐心和细心的环节。“地球名片”采用双面贴片设计有一定难度。我采用的焊接顺序是“先贴片后直插先背面再正面”但根据我的实操经验优化后的流程更稳妥。3.1 焊接前的准备工作工具检查确认所有工具到位电烙铁建议可调温刀头或尖头、热风枪必备、焊锡丝细径含松香、锡膏用于回流焊、镊子尖头、弯头、助焊剂、吸锡带、万用表、放大镜或台灯。PCB与元件检查收到PCB后先用放大镜检查有无断线、短路、氧化。将所有元件按阻值、容值分类摆放并用万用表测量关键阻容元件值是否准确特别是1kΩ、4.7kΩ、10kΩ这几个常用电阻。芯片处理Air001是QFN封装引脚在芯片底部。如果购买的是未植锡的芯片需要先用锡膏和热风枪在底部焊盘上植上薄薄的一层锡球这个过程叫“植球”。新手可以直接购买“已植球”的芯片省去大麻烦。3.2 分步焊接流程详解我的焊接顺序基于“先焊接更脆弱、更怕高温的元件”的原则进行调整第一步焊接背面小贴片元件电阻、电容、电感方法使用热风枪。在PCB背面的焊盘上点上少量锡膏用镊子将元件精准放置。将热风枪温度设定在280-300°C风量调至中低档约3-4档风嘴距离PCB 2-3厘米均匀加热元件区域直到看到锡膏熔化、流动并包裹元件引脚回流过程移开风枪等待冷却。要点一定要先焊完背面所有小贴片再翻过来焊正面。因为正面有更大的LED和开关焊接时对背面的热冲击较小。控制好热风枪温度和时间避免长时间高温导致PCB起泡或元件损坏。第二步焊接正面贴片元件LED、按键、开关方法同样使用热风枪配合锡膏进行回流焊。流程同上。特别注意LED和按键都是有极性的。贴片LED通常有一个绿色标记或缺口对应阴极负极PCB上也会有“”或阴影标记对应阳极。务必对照原理图或丝印方向放置。要点焊接按键时确保其贴合PCB没有歪斜否则会影响手感甚至卡住。拨动开关也要焊正保证拨动顺畅。第三步焊接主控芯片 Air001这是最具挑战性的一步。在PCB背面的芯片焊盘上涂抹少量助焊剂。将已植球的Air001芯片对准方向芯片上通常有一个小圆点对应PCB丝印的1脚标识轻轻放在焊盘上用手或镊子轻微按住。使用热风枪温度300-320°C风量中等围绕芯片四周缓慢均匀加热。你会看到底部的锡球逐渐熔化在助焊剂作用下芯片会轻微下沉并自动对齐这个过程叫“自对齐”。看到芯片位置归正后停止加热。冷却后必须用万用表蜂鸣档检查检查芯片相邻引脚间有无短路检查几个关键电源引脚VDD对地GND是否短路。确认无误后再进行下一步。第四步焊接直插元件OLED屏、陶瓷LED灯座、电池座方法使用电烙铁和焊锡丝。这些元件引脚较粗适合手工焊接。OLED屏幕将屏幕排针插入PCB正面对应的母座从背面焊接固定。确保屏幕与PCB垂直。陶瓷LED灯座注意正负极长脚为正短脚为负PCB孔旁有“”标记。焊好后可以临时接电测试一下是否点亮。电池座焊接时注意不要堵住充电模块的USB口。3.3 焊接后的检查与测试焊接完成后切勿急于上电。必须进行系统性检查目视检查用放大镜仔细查看所有焊点确保饱满、光亮、无虚焊焊点与引脚间有缝隙、无桥接相邻引脚被焊锡连在一起。连通性测试用万用表蜂鸣档对照原理图检查主要电源路径电池正极-开关-LDO-芯片VDD是否导通检查GND网络是否全部连通。短路测试重点测试芯片的3.3V电源与GND之间是否短路。测试电池输入正负极之间是否短路。初次上电接上电池先不按开关。用手触摸主控芯片和LDO感受是否有异常发热。若无打开OLED电源开关用万用表测量LDO输出端确认是否为稳定的3.3V。如果电压正常且无发热恭喜你硬件焊接基本成功注意焊接过程中最常出现的问题是LED焊反、芯片引脚短路或虚焊。虚焊尤其隐蔽可能导致功能时好时坏。对于可疑焊点可以适当补一点助焊剂和焊锡用烙铁重新拖焊一次。4. 软件开发与环境搭建硬件准备就绪后我们就要让“名片”的大脑——Air001运行起来。整个软件开发流程在Arduino IDE中进行非常标准化。4.1 开发环境配置安装Arduino IDE从Arduino官网下载并安装最新版IDE。添加Air001开发板支持打开IDE点击文件-首选项在“附加开发板管理器网址”中输入合宙的板卡支持地址https://github.com/openLuat/Arduino_Air001/raw/main/package_air001_index.json点击工具-开发板-开发板管理器搜索“Air001”找到并安装“Air001 by OpenLuat”平台。安装必要的库本项目需要两个核心库U8g2库用于驱动OLED屏幕。在IDE的库管理器中搜索“U8g2”选择由olikraus开发的版本进行安装。这是一个功能极其强大的单色屏驱动库支持多种字体和图形绘制。Arduino Touch可选如果原项目代码使用了专门的触摸库可能需要安装。但更常见的做法是直接使用ADC读取代码中自己实现判断逻辑。4.2 项目代码结构与核心逻辑解析拿到开源代码后不要急于上传。先浏览主要文件理解程序框架。一个典型的“地球名片”代码会包含以下部分Earth_Business_Card.ino主程序文件。display.ino或oled.cpp/.hOLED屏幕显示相关函数负责绘制地球、文字、动画帧。led.ino或light.cpp/.hLED灯光控制函数实现呼吸、闪烁、流水等效果。input.ino或button.cpp/.h按键和触摸检测函数。主程序逻辑循环main loop通常如下void loop() { // 1. 扫描按键状态 scanButtons(); // 2. 检测触摸输入 checkTouch(); // 3. 根据当前模式更新显示内容 updateDisplay(); // 4. 根据当前模式更新灯光效果 updateLights(); // 5. 处理可能的模式切换逻辑 handleModeChange(); // 短暂延时控制循环频率 delay(10); }4.3 核心功能代码实现要点1. OLED显示控制使用U8g2库初始化通常如下#include U8g2lib.h U8G2_SSD1306_128X64_NONAME_F_HW_I2C u8g2(U8G2_R0, /* reset*/ U8X8_PIN_NONE);在setup()中调用u8g2.begin()。显示内容时遵循firstPage()和nextPage()的循环结构来绘制图形和文字。例如绘制一个简单的圆代表地球u8g2.firstPage(); do { u8g2.drawDisc(64, 32, 20); // 在屏幕中心(64,32)画一个半径20的实心圆 u8g2.setFont(u8g2_font_ncenB08_tr); u8g2.drawStr(40, 60, Hello Earth!); } while (u8g2.nextPage());切换不同显示页面可以通过一个displayPage变量来索引在按键事件中改变这个变量即可。2. 按键检测使用简单的digitalRead()配合状态机来区分单击和长按。这是嵌入式开发中非常经典的消抖和识别逻辑。// 伪代码示例 int buttonState digitalRead(BUTTON_PIN); if (buttonState LOW) { // 按键按下 if (!buttonPressed) { // 第一次检测到按下 buttonPressTime millis(); buttonPressed true; } else { // 持续按下计算长按时间 if (millis() - buttonPressTime LONG_PRESS_MS) { // 触发长按动作 triggerLongPressAction(); } } } else { if (buttonPressed) { // 按键释放 if (millis() - buttonPressTime LONG_PRESS_MS) { // 触发单击动作 triggerClickAction(); } buttonPressed false; } }3. 触摸感应实现利用Air001的ADC读取触摸铜箔连接的引脚电压。int touchValue analogRead(TOUCH_PIN); // 无触摸时ADC会读取到一个基准值例如 512 // 当手指触摸时电容效应会导致这个值显著下降例如降到 300 if (touchValue TOUCH_THRESHOLD) { // 检测到触摸 if (!touchDetected) { triggerTouchAction(); touchDetected true; } } else { touchDetected false; }难点在于TOUCH_THRESHOLD阈值的确定它受PCB布局、环境湿度影响。通常需要在setup()中采样一个初始基准值然后在运行中动态调整阈值或采用更复杂的滤波和差分算法来提高稳定性。4. PWM灯光控制使用analogWrite()函数控制LED亮度实现呼吸灯效果。int brightness 0; int fadeAmount 5; void updateBreathingLED() { analogWrite(LED_PIN, brightness); // LED_PIN必须是支持PWM的引脚 brightness fadeAmount; if (brightness 0 || brightness 255) { fadeAmount -fadeAmount; // 到达边界时反转渐变方向 } }4.4 代码编译与烧录选择开发板与端口在工具菜单下选择开发板为“Air001”并选择正确的串行端口。编译点击“验证”对勾图标。首次编译会较慢需要下载核心工具链。确保所有库已正确安装无编译错误。烧录Air001需要通过串口烧录。确保PCB上的串口引脚TX/RX通过USB转TTL模块与电脑连接或者板载了CH340这类USB转串口芯片。点击“上传”右箭头图标。烧录时有时需要手动触发芯片的Bootloader模式具体方法可能需短接PCB上的某个触点或按键请参考合宙官方文档或项目说明。观察结果烧录成功后系统会自动复位运行。此时你可以操作按键和触摸观察屏幕和灯光的变化是否符合预期。5. 系统调试与功能验证烧录程序后才是真正“见证奇迹”的时刻但也往往是问题开始浮现的时候。我们需要系统地验证每一项功能。5.1 分模块功能测试流程遵循“由简到繁电源优先”的原则电源测试上电后首先用万用表测量3.3V LDO输出是否稳定。然后触摸主控芯片和主要IC应仅有微温如果烫手立即断电。基础IO测试LED可以编写一个简单的测试程序让所有LED依次点亮、熄灭检查是否有不亮或常亮的。这能快速验证GPIO输出电路和LED本身是否正常。OLED屏幕测试运行一个简单的U8g2例程如显示“Hello World”。如果屏幕不亮检查电源开关是否打开。I2C上拉电阻是否焊上通常4.7kΩ。屏幕排线是否插反、虚接。代码中I2C地址是否正确SSD1306常用0x3C。按键测试编写一个串口打印程序按下每个按键时在Arduino IDE的串口监视器中查看对应的日志输出确认每个按键的GPIO引脚定义是否正确消抖逻辑是否工作。触摸功能测试这是调试的难点。打开串口监视器持续打印触摸引脚的ADC原始值。观察无触摸时的基准值然后用手触摸看数值变化是否明显通常应有数百的差值。如果变化很小可能是触摸铜箔面积太小或手指不干净。ADC参考电压不稳。程序中的阈值设置不合理。需要根据打印的数值动态调整阈值。综合功能测试运行完整的项目代码按照设计说明书逐一测试所有模式切换、动画播放、灯光联动功能。5.2 常见问题与排查实录在复刻过程中我遇到了几个典型问题这里分享排查思路问题一OLED屏幕闪烁后白屏或完全不显示。排查检查电源用万用表测量屏幕VCC引脚是否为3.3V。检查I2C通信用逻辑分析仪或示波器抓取SDA/SCL波形是最直接的方法。如果没有仪器可以尝试用Arduino的Wire库扫描I2C设备地址看能否找到0x3C的设备。我的案例扫描不到地址。最终发现是I2C上拉电阻未焊接。补焊两个4.7kΩ电阻到VCC后问题解决。原因是PCB设计时可能将上拉电阻设为可选BOM表里容易遗漏。问题二某个按键失灵或触发不灵敏。排查检查硬件用万用表通断档测量按键按下时两端是否导通。检查按键焊点是否有虚焊。检查软件确认代码中该按键对应的引脚编号与PCB设计一致。检查内部上拉是否启用pinMode(pin, INPUT_PULLUP)。我的案例一个按键长按无效。发现是代码中长按判断的阈值LONG_PRESS_MS设置得太短只有300ms导致很难触发。调整为800ms后恢复正常。问题三触摸感应时灵时不灵或极易误触发。排查硬件检查触摸铜箔到ADC引脚的走线是否靠近其他高频或大电流线路可能引入干扰。可以在ADC引脚到地之间加一个10-100pF的小电容滤波。软件这是主要优化点。原始代码可能只是简单的一次采样比较。增加软件滤波采用连续采样N次如10次取平均值或中位值能有效滤除毛刺。动态阈值在setup()中采样一段时间的ADC值作为初始基准。在运行中无触摸时缓慢跟随这个基准低通滤波触摸阈值设为基准值的一个固定比例如70%。差分判断判断当前值与动态基准的差值是否超过一个门限而不是与固定值比较。延时消抖检测到触摸后延时几十毫秒再次确认避免抖动误触发。我的优化代码片段#define TOUCH_SAMPLES 10 #define TOUCH_THRESHOLD_RATIO 0.7 // 触摸阈值为基准值的70% #define BASELINE_ALPHA 0.01 // 基准值跟随系数 int touchBaseline 512; // 初始估计值 int touchCurrent 0; void updateTouch() { // 1. 采样 int sum 0; for(int i0; iTOUCH_SAMPLES; i) { sum analogRead(TOUCH_PIN); } touchCurrent sum / TOUCH_SAMPLES; // 2. 更新动态基准无触摸时 if(!touchDetected) { touchBaseline touchBaseline * (1-BASELINE_ALPHA) touchCurrent * BASELINE_ALPHA; } // 3. 判断触摸 if(touchCurrent (touchBaseline * TOUCH_THRESHOLD_RATIO)) { // 触发触摸并加入时间戳和状态机防止重复触发 if(!touchDetected (millis() - lastTouchTime 200)) { triggerTouch(); touchDetected true; lastTouchTime millis(); } } else { touchDetected false; } }问题四电池续航时间远短于预期。排查测量整机电流使用万用表电流档串联在电池回路中分别测量屏幕点亮、LED全亮、待机等不同模式下的工作电流。分析耗电大户OLED屏幕是全屏点亮时耗电较大的部件。LED数量多、亮度高也是主要原因。软件优化睡眠模式在无操作一段时间后让Air001进入深度睡眠Deep Sleep仅保留RTC和外部中断唤醒功能。此时电流可降至微安级别。通过按键或触摸中断唤醒。优化显示减少全屏高亮度显示的时间或采用局部刷新、降低屏幕亮度通过I2C命令调节SSD1306对比度。优化灯光使用更低的PWM占空比来驱动LED在满足视觉效果的前提下降低亮度。我的改进增加了5分钟无操作进入深度睡眠的逻辑唤醒后恢复状态。整机待机电流从~20mA降到了~50μA续航提升显著。6. 效果优化与个性化定制当基本功能全部跑通后你就可以发挥创意打造属于自己独一无二的“地球名片”了。6.1 显示内容自定义这是最具可玩性的部分。U8g2库支持绘制点、线、圆、矩形也能显示各种字体。修改或添加显示页面在display.ino文件中找到负责不同页面绘制的函数如drawPage1(),drawPage2()。你可以修改其中的绘图指令和文字。例如将显示的地理信息改成你所在城市的坐标和气候。绘制不同的简笔画或图案如航天器、树木等。添加新字体U8g2库内置了多种字体也可以使用其自带的fonttool工具转换少量自定义字体。在代码中调用setFont()函数切换。创建简单动画通过连续切换不同的图形或文字位置可以形成动画。例如让一个代表卫星的小圆点围绕地球旋转。这需要在一个页面内多次调用firstPage()/nextPage()循环并每次更新绘制坐标。6.2 灯光效果编程除了简单的闪烁和呼吸可以尝试更复杂的灯光模式。彩虹渐变如果有多颗RGB LED可以通过HSV色彩空间转换到RGB实现平滑的彩虹渐变效果。音频可视化进阶如果未来扩展麦克风模块可以采集环境声音强度映射到LED的亮度或闪烁频率上。联动效果让灯光效果与显示内容或触摸事件强关联。例如触摸“地球”时地球中心的LED呈现脉冲式的呼吸光仿佛被激活切换显示模式时装饰LED来一个流水灯效果作为过渡。6.3 结构外观美化开源项目通常提供了PCB的丝印层文件你甚至可以在此基础上进行修改。定制PCB颜色在打样时选择黑色、蓝色、紫色等沉金PCB会比常规绿色更有个性。添加外壳使用3D打印或亚克力激光切割为“地球名片”制作一个透明或半透明的前盖既能保护元件又能提升质感。设计时需为按键、触摸区、USB口开孔。表面处理对PCB上裸露的铜箔区域触摸区可以涂刷透明的绝缘保护漆俗称“三防漆”既能防止氧化保持良好接触又看不到漆层。6.4 功能扩展设想基于Air001的剩余IO口和性能这个项目还有很大扩展空间增加传感器接入一个温湿度传感器如DHT11让名片可以显示实时环境数据。无线连接虽然Air001本身不带无线但可以通过I2C或SPI接口连接一个低功耗蓝牙BLE模块如JDY-31。这样就能用手机APP来切换名片内容、编辑显示文字可玩性大大增加。增加存储接入一个小容量的SPI Flash芯片用于存储更多的图片、动画帧或文本信息摆脱代码存储空间的限制。复刻“地球名片”的整个过程是一次非常充实的全栈式硬件开发体验。从电路理解、精密焊接到嵌入式编程和调试优化每一个环节都充满了挑战和收获。它完美地展示了像Air001这样一颗小巧而强大的MCU如何通过创意和设计变身为一款触手可及、趣味盎然的科技艺术品。最让我满意的不是最终成品按下了哪个按键会亮什么灯而是在解决每一个具体问题——比如那个飘忽不定的触摸检测——的过程中所积累下的对硬件底层更深刻的理解。这些经验远比单纯复制一个作品更有价值。希望这份超详细的记录能帮你少走弯路更顺利地创造出属于自己的那颗“电子地球”。