2块钱的开发板,一条命令全搞定:ESP32-C3 新手第一课,彻底告别串口黑屏
2块钱的开发板,一条命令全搞定:ESP32-C3 新手第一课,彻底告别串口黑屏
你有没有过这种崩溃瞬间:板子买回来了,教程照着敲,固件也算烧进去了,结果一按"监视",串口窗口黑屏一片,一个字都不吐。
别急着骂板子坏了,也别怀疑自己烧错砖。
最近 GitHub 上有个叫 esp32-c3-adblock 的开源项目特别火——一块两美元的 ESP32-C3 小板,硬是塞进了五十多万个广告黑名单域名,还能给全家网络挡住广告。Tom's Hardware、XDA 这些海外科技媒体都专门给它写了报道,国内技术社区也跟风出了一整套解析文章。
但真正让新手们集体"破防"的,不是它有多神,而是第一节课:怎么把固件烧进去、怎么让串口正常说话。
这篇就带你把这第一课走通,一次过。
一、它到底是个啥?
先打个比方。
你家里每个设备——电视、手机、智能音箱——上网前都得先"查号":把网站域名翻译成网络地址。这个项目就是在你家路由器后面加了一个"查号台",它手里攥着一本五十多万个"骚扰电话"名单(广告和追踪器域名)。
谁要来查这些"骚扰电话",它直接回一句"查无此人";查正经网站的,它原样转交给外面的运营商。
就这么点事,但它牛在三个数字上:成本约2美元、只吃约50KB内存、判断快得只要10毫秒左右。同样的活儿,以前的方案要么得用树莓派,要么得买带 PSRAM 的贵板子,它直接让最便宜的 C3 小板干翻全场。
作者本人还把它插在光纤猫背后的 USB 口上取电,小得几乎隐形——这就是它能上 Tom's Hardware 头条的原因。
二、为什么它能火?全网怎么说
海外媒体夸得最狠的一点是"数学玩得漂亮":域名不存原样,而是每个压缩成一个5字节的"编号"存进芯片闪存,查询时现场算编号再翻一本排好序的"电话簿"。五十多万个域名,就这么被装进了一块四块钱的存储里。
国内 CSDN 上更热闹,一连串深度文章追着写:怎么封禁某台设备、怎么定时暂停拦截、仪表盘上六个指标怎么看、用两条命令验证拦截有没有生效……还有一篇专讲"串口输出黑屏坑点全排查"——看来被黑屏坑过的人,真不少。
海外论坛的评论区也挺有意思,有人抬杠"还得3D打印外壳,哪算便宜",也有人反驳"图书馆和创客空间都能免费打印"。还有人问"浏览器装个插件不就行了?"——没错,插件只能管住一台电脑,管不住家里那台天天给你推广告的电视盒子。
三、新手第一课:一条命令烧录,全程点按钮
这个项目用的是现在嵌入式圈最流行的工具 PlatformIO,你可以把它理解成"给程序员备好了全套调料包的厨房":板子型号、芯片工具链、编译参数,全写死在项目的配置文件里,你什么都不用懂。
上手就这么几步,全是"点点点":
第一步,装工具。 电脑装一个 VS Code,再装它的 PlatformIO 插件。装好之后它会自己在后台把 ESP32-C3 需要的编译工具链下载配齐,第一次稍慢,之后就快了。
第二步,打开项目。 把仓库拉下来,用 VS Code 直接打开整个文件夹,插件会自动识别这是个 PlatformIO 项目。
第三步,烧录。 侧边栏里有两个大按钮,一个编译、一个上传(相当于"一键编译烧录")。点上传,USB 线连着板子,等它跑完就行。整个项目里真正需要插 USB 的,只有这一次——之后升级固件、更新黑名单,全走 WiFi 空中升级,线都不用碰。
第四步,连 WiFi。 最省事的地方:你完全不用把 WiFi 密码写进代码。第一次通电如果没连上网,板子自己会发一个免费热点(名字带 C3-AdBlock 字样),手机一连上去,自动弹出一个网页,选你的路由器、输密码,搞定。以后搬家换网,按一下面板上的"忘记WiFi"按钮再来一遍就行。
第五步,看效果。 浏览器打开 c3adblock.local,一个网页仪表盘就出来了:谁在上网、谁被拦了多少次、实时温度、空闲内存,一目了然。想临时看直播怕被误拦?面板上点个"暂停拦截",过会儿自动恢复。
对了,仓库里还带了一个专门给这块板子量身的 3D 打印外壳文件,有打印机的可以直接打,没打印机的裸板插路由器背后也完全能活。
四、串口还是黑屏?对照这张表排查
烧完录完,打开串口监视器还是黑屏?大概率是下面这几个坑之一,按顺序对:
坑一:Linux 下 ModemManager 抢线。 用 Linux 的伙伴注意,系统里默认有个"调制解调器管理器",会把这块板子的 USB 口当成手机去抓,还顺手复位它,结果串口被它占住、板子被反复重启。解法一句话:停掉这个服务,并加一条规则让它"无视"乐鑫家的设备。这是国内社区踩坑率最高的一条。
坑二:监视器选错了口。 C3 这块板子的串口是芯片自带的能力,设备名通常是 ACM 开头而不是 COM 开头(Windows)或者别的常见命名。如果监视器盯着一个空口等,当然一个字都没有。打开设备管理器看一眼实际口名,照着填。
坑三:波特率没对上。 这个项目里串口速度是 115200,监视器默认值经常是 9600。差一个数量级,输出出来就是一堆乱码或者干脆没有。
坑四:线不行,或者电不够。 便宜的短线、松动的 USB-C 转接头,供电一抖,WiFi 一发射就重启。作者专门写了提醒:用手机原装充电头或者路由器背后的 USB 口供电,比什么都靠谱。
坑五:启动瞬间的输出被吞了。 C3 的串口在电脑"还没连上来"时,最早那几行启动日志可能不往外发。如果你只看到一半日志,按一下复位(BOOT 键)重新看一遍就好,或者干脆别纠结——以仪表盘网页为准。
还有一个大前提:工具版本要新。老版本(比如系统仓库里自带的 4.x)会直接报奇怪的错误,换成 VS Code 插件自带的新版就消失。这不是玄学,是社区 issue 里真实记录的坑。
五、写在最后
其实这个项目最打动人的地方,不是两美元,而是一种思路:以前做网络去广告,默认答案都是"再买台树莓派",而有人盯着最便宜的芯片算了笔账,发现"内存不够?那就换个存法",硬是把专业级方案塞进了一块薯片大小的小板子里。
对新手来说,它也是难得的"友好第一课":工具链全自动、WiFi 配置靠手机网页、烧录只需一次、黑屏有明确的排查路径。你把这一课走通了,后面玩任何 ESP32 项目都是顺水推舟。
说个题外话:你家里最让你烦的广告来自哪个设备?是半夜自己醒来的智能电视,还是怎么关都关不掉的手机推送?
评论区聊聊,说不定你的那块 C3 小板,就是为它准备的。