固件启动¶

项目框架完全模仿加热柜示例中的章节：PlatformIO、lib/中的idryer-core，同样的platformio.ini（只需将环境名改为filter）。这里只讲不同的部分。

本章的现成项目——教程仓库中的 example/10-filter：platformio.ini 和后面逐段拆解的全部代码都取自那里。核心库——idryer-core。

日志输出到端口：两个编译标志

ESP32-C3 的 Serial 输出默认走 UART0 的引脚，而不是板子的 USB 口——Serial Monitor 里一片空白。要看到日志，build_flags 中需要两行：

-DARDUINO_USB_MODE=1
-DARDUINO_USB_CDC_ON_BOOT=1

ESP-IDF 自身的消息（mDNS 错误之类）没有这两行也会走 USB，所以"有东西在打印，但我的行没有"恰恰是缺少这两个标志的迹象。

Config：非标设备类型¶

过滤器既没有加热器，也没有生态系统字典中的气候传感器。从字典功能中它只有风机。在src/main.cpp中：

#include <iDryer.h>

static const iDryer::Config CFG = {
    .deviceType        = iDryer::DeviceType::Unknown, // 非标设备
    .unitsCount        = 1,
    // 外围设备：字典中只有风机。
    .hasFan            = true,
    // 自动发布周期：
    .telemetryPeriodMs = 5000,
    .statusPeriodMs    = 10000,
    // 门户识别：
    .hardwareVersion   = "1.0",
    .firmwareVersion   = "0.1.0",
    .model             = "DIY Air Filter",
};

static iDryer::Link s_link(CFG);

void setup() {
    Serial.begin(115200);
    s_link.begin();
    // 设备在门户上被解绑：清除密钥，等待重新绑定。
    s_link.onCommand("revoke", [](JsonObjectConst) { s_link.handleRevoke(); });
}

void loop() {
    s_link.loop();
}

DeviceType::Unknown是正常的

类型Unknown意思是"门户不知道这个产品"。从前这是个问题：门户没有未知类型的卡片。现在这是标准做法：设备的整个界面由卡片清单描述（第6章），门户根据清单构建卡片。类型只对iDryer自己的产品需要，那些有官方卡片的。

hasFan = true标志给我们免费得到：遥测中的fanStatus字段、卡片上的"风机"单元、以及清单中的实体——全部来自生态系统字典。

Config中没有VOC传感器——这是应该的¶

注意：Config中没有hasVoc标志。has*字典描述生态系统知道的外围设备。你的自定义传感器用另外两种机制加入：在遥测中加入它的读数（你自己的字段）并在卡片清单中声明它——这是接下来的两章。这正是这种方法的精妙之处：不需要为每个新设备扩展字典。

首次启动和绑定¶

步骤与储料柜相同：

烧录开发板并打开串口监视器：设备连上 Wi-Fi 之前，日志不会输出。
在 iDryer 应用中：连接新设备 → Wi-Fi 步骤（网络和密码，连接设备）→ 绑定步骤 → 绑定。
显示 设备已绑定 后，设备已绑定到你的账户，并在门户上变为 Online；日志中出现 MQTT: Connected!。

详细说明、可能的错误和重新绑定——见储料柜示例的章节。

门户上的设备：名称、Idle 状态、连接图标。图表是空的，菜单也没有到达——设备没有声明过它们。

设备已在门户上可见，但卡片还几乎是空的——还没有数据。继续连接传感器。