1. 平台
选择平台——后面的字段取决于它。
2. 现成预设
点一下预设，它的参数就会填进下面的表单。之后仍可手动调整。
成品 Wi-Fi 继电器（更换程序）
用 ESP32 自己搭
ESP8266 控制器板
基于 ESP8266 的成品 Wi-Fi 继电器（Sonoff 之类）带不动大门：它们切的是市电，没有干接点。您需要一块普通板子外加一个独立的继电器模块（见下文「还需要什么」）——只有这样才能得到一对可当按钮用的空触点。
Raspberry Pi
在普通树莓派上，继电器挂在 GPIO 上——和 ESP 用的是同一种继电器模块（见下文「还需要什么」）。也可以选一块直接插在 Pi 排针上的继电器扩展板。
还需要什么
这些图片不可点击——只是让您看看这些元件长什么样。
继电器模块
ESP32、ESP8266 或树莓派通用——凡是没有板载继电器的板子都适用。三根线接到控制器：控制、供电和地（GND）。继电器输出接到驱动装置
USB 转 UART 适配器
当设备自身没有 USB 时才需要：成品 Shelly 和裸的 ESP32／ESP8266 模块。带 USB 的板子（DevKit、Wemos）用不着它
3. WiFi
网络名称和密码会写进设备的程序里。如果日后换了 Wi-Fi，就得用新信息重新构建并烧录程序。
3. 网络
树莓派通过操作系统联网——Wi-Fi 或以太网用常规的 raspi-config、NetworkManager 或 /etc/wpa_supplicant/wpa_supplicant.conf来配置。脚本本身不需要 Wi-Fi 凭据。
第一次配置吗？在 Pi Zero W 上，最省事的做法是把 SSID 和密码写进 SD 卡引导分区里的这个文件： wpa_supplicant.conf。在 Pi 4 或 5 上，用这个更简单： raspi-config nonint do_wifi_country RU 与 raspi-config nonint do_wifi_ssid_passphrase MyHomeWiFi secret.
4. 设备凭据
在应用里添加一个类型为 「设备」 的对象——注册完成后，应用会显示 设备码。把它粘到下面的字段里：固件靠它连接服务器。
5. 继电器
6. 指示灯（可选）
可以驱动两个指示灯：服务器连接状态和继电器动作。不需要就保持 -1。
保存此配置
如果您想读读源码、手动改一改、下载 .ino 或分享链接，请点「在编辑器中打开」。这正是服务器用来编译出 .bin.
与应用绑定
在应用里打开「设备」对象 →「与应用绑定」，复制那串码（它以 ENTX-BIND:开头），粘到下面，然后点「写入控制器」。此后控制器只接受来自您应用的指令——密钥经 USB 送达，绕开网络和服务器。
控制器必须已经刷好固件并通过 USB 连接。如果应用重新签发了密钥，请用新码再绑定一次。
在树莓派上安装
下载好配置完成的 entrixy.py:
- 把文件放到
/opt/entrixy/entrixy.py（在 Pi 上；可以用scp). - 安装依赖：
sudo pip install websockets RPi.GPIO（在 Pi 5 上请用gpiod). - 下载 systemd 服务单元： entrixy.service，放到
/etc/systemd/system/. - 设为开机启动：
sudo systemctl enable --now entrixy. - 检查一下：
sudo journalctl -u entrixy -f→ 您应当看到[entrixy] auth OK.
连接断开时脚本会自行重连，Pi 重启后也会自动恢复。
继电器与驱动装置的接线
用到设备输出上的两个触点： NO （常开）和 COM （公共端）。这两根线接到驱动装置控制板上的「开门按钮」端子。
| 驱动装置 | NO/COM 接到哪里 |
|---|---|
| BFT (Phobos, Deimos, Ares) | 端子 START 或 OPEN （在接线图上通常编号为 21–22） |
| CAME (BX, ATI, BK) | 端子 2–7 （开），若是步行小门则用 PED |
| NICE (Robus, Run, Spin) | 端子 1–3 （逐步） |
| FAAC (740, 844, 391) | 端子 OPEN A （完全打开） |
| DoorHan (Sliding, Arm) | 端子 CMD + GND |
| 道闸 | 带「开」按钮的立柱——与它的触点并联 |
| 对讲机（Cyfral、Vizit、Eltis） | 把继电器与话机上的开门按钮并联，或者直接接到磁力锁的端子上 |
确切的端子标注请查阅您控制板的说明书。如果板子已经接好并在正常工作，找到从「开」按钮立柱引来的那两根线，把 NO/COM 与它们并联即可。
成品 Wi-Fi 继电器的 UART 接入
成品的 Shelly Plus 1 没有对外的 USB。必须打开外壳，用 USB 转串口适配器接到 UART 引脚——CP2102、CH340 或 FTDI 都行。
通用接线
| USB 转串口适配器 | 设备 |
|---|---|
| GND | GND |
| 3.3V | 3V3 |
| TX | RX |
| RX | TX |
| — | EN/RESET——短暂接地，以便重启进入引导加载模式 |
| — | GPIO0——上电时接地，以进入引导加载模式 |
各型号的引脚定义
| 设备 | UART 在哪里 | 进入引导加载模式 |
|---|---|---|
| Shelly Plus 1 / 1PM (ESP32) | 外壳内部、ESP32 模块旁边的焊盘 | 把 GPIO0 接到 GND，再把 EN 短暂拉到 GND |
用 esptool 烧录（浏览器方式行不通时）
- 下载
.bin（在上方）。 - 安装 esptool：
pip install esptool - 把设备接到 USB，或接到 USB 转串口适配器上。
- 烧录：
esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ws.bin - 在 Windows 上，端口通常是
COM3或COM4.