❮ 选择控制器连接方式：BLE（蓝牙）

BLE 开启控制器

挑一个现成模块，或者用几个零件搭一个控制器，设几项参数，然后直接从浏览器把做好的程序传进去。

这套固件做什么

当您靠近控制器时，手机——所有者的手机，或持有效密钥的访客手机——会通过蓝牙直接发出「开」指令。控制器把驱动装置的一对触点短暂闭合（默认一秒），就像按了一下普通按钮，然后再断开；它并不通断电源。对于双稳态驱动装置和门锁，可以在下面的设置里启用分开的开／关并带状态跟踪的模式。开启靠在应用里点一下；也支持靠近时自动开启。

里面是什么

手机与控制器之间的连接经过严密加密——既伪造不了，也截不走。没有什么要配置的，保护已经内建好了。两次开启之间控制器处于休眠，几乎不耗电。

1. 选择开发板

先决定用什么来做：要么拿一个 现成模块（控制器和继电器已经焊在一起），要么 用零件自己搭 （一块单独的 ESP32 板加一个继电器模块）。点一下您的板子，我们会给出接线方法，同时把对应的设置填进下面的表单。最后一步，把做好的程序——也就是固件——传进控制器。

控制器板

ESP32 与继电器同板

ESP32 与继电器已经焊在一起的成品板——不需要另配模块。

成品 Wi-Fi 继电器（更换程序）

如果您想要规整的原厂外壳和有认证的继电器，就买一个成品设备，把我们的程序刷进去替换它原本的程序。里面仍旧是一个普通继电器：一对触点短暂闭合，替您按下开门按钮。这类设备不需要自己的 Wi-Fi——Entrixy 直接和手机对话。

还需要什么

这些图片不可点击——只是让您看看这些元件长什么样。

继电器模块板子上没有继电器时就需要它。三根线接到 ESP32：控制、供电和地（GND）。继电器输出接到驱动装置

带插座的编程器把裸的 ESP32 或 ESP32-S3 模块插进这个插座，就能给它烧录程序

USB 转 UART 适配器用于给继电器板和 Shelly 烧录程序——只需接几个引脚

智能插座和 Wi-Fi 开关在这里派不上用场。 Athom Plug、Shelly Plus Plug S 之类的设备只是把市电切给负载——它们没有无源 NO/COM 输出，只有一个插孔。要驱动大门电机，需要 Plus 1 或 Plus 1PM 继电器，或者自制的带继电器模块的板子。

在给成品设备烧录程序之前，先确认各个引脚的对应关系。厂商有时会在同一型号内调整引脚位置。我们的图取自公开资料，并在自己手上的样机上验证过——您的板子可能略有差别。以板子上的丝印标注为准。

2. 开发板

板子选哪种 ESP32 型号——它决定了可用的引脚

不确定自己用的是哪颗芯片？用 USB 线把板子连到电脑（裸模块需经编程器），然后点这个按钮——浏览器会识别芯片并在上面的列表中选中它。桌面版 Chrome 或 Edge 可用。

3. 锁与继电器

锁的类型

开启继电器引脚（PIN_RELAY）接继电器线圈的输出；NO/COM 接到驱动装置的 Open 端子

继电器极性

关闭继电器引脚（PIN_CLOSE）双线圈门锁或带有独立“开启”和“关闭”端子的驱动器：关闭脉冲接到这里，开启脉冲仍在上面的继电器引脚。-1 表示只有一个按钮、依次开启 / 停止 / 关闭的驱动器（平移门常见）

“关闭”继电器极性

脉冲时长，毫秒继电器闭合保持多久，两个继电器使用同一时长；大门电机常用 500–2000 毫秒，电机锁或双稳态继电器线圈按其说明书，通常 50–500 毫秒

控制器和继电器模块的地线（GND）必须连在一起——没有共地，继电器无法工作。

4. 出门按钮与自动关闭

出门按钮引脚室内按钮无需应用即可开启；对于双稳态门锁，它在开启 / 关闭之间切换。接在引脚与 GND 之间；-1 表示没有

自动关闭（秒）任何一次开启之后——无论来自应用、访客还是按钮；0 表示保持开启，直到被关闭

限位开关引脚报告实际状态，即使门是手动关上的。接在引脚与 GND 之间；-1 表示没有

限位开关的位置

限位开关被压下时，引脚

行程时间，秒门从一端到另一端所需的时间，再加几秒。限位开关在此时间内未确认 — “Did not open” 或 “Did not close”。限位开关装在打开位置时，卡在半途的门仍会显示为已关闭

电池供电时，出门按钮可立即唤醒 ESP32-S3（GPIO 0–21）或 ESP32-C3（GPIO 0–5）上的控制器；经典 ESP32 在下次唤醒时响应，在休眠间隔之内。限位开关在每次唤醒时读取。电池供电时请在按钮引脚和 3.3 V 之间接一个 10 kΩ 电阻。

5. 指示灯（可选）

最多三个指示灯：状态（配对和脉冲）、“开”，以及双稳态锁的“关”。电池供电时指示灯只随脉冲闪一下；位置和运行状态在市电供电（休眠 0）时显示。不需要就保持 -1。

状态指示灯（板载）板载指示灯的引脚。因型号而异：ESP32-S3 一般是 GPIO48，ESP32-C3 是 GPIO8，经典 ESP32（WROOM）是 GPIO2。默认值跟随上面所选芯片，可以修改。没有这颗灯就填 -1。

状态指示灯的极性

开启指示灯引脚弹簧锁：在继电器脉冲期间点亮；双稳态：门锁开启时一直点亮；-1 表示没有

开启指示灯的极性

“关闭”指示灯引脚门锁关闭时一直点亮；-1 表示没有

“关闭”指示灯极性

电机运行时的指示灯仅限有限位开关时：从脉冲开始，直到限位开关确认位置

闪烁周期，毫秒 10 到 2000；0 表示两灯常亮

6. 配对按钮与诊断

配对按钮引脚（PIN_PAIR_BTN）板上物理按键的引脚。控制器尚未配对时，短按即开始与手机配对。长按则把配对关系恢复到出厂状态。多数板子上这就是板载的 BOOT 键，GPIO0。

复位所需的长按时长，毫秒按键要按住多少毫秒才会触发配对复位。为防误触，通常设为 5000 毫秒，也就是五秒。

调试输出（UART）输出到串口的技术日志，只有调试时才需要。在 ESP32-S3 上，该串口会占用 GPIO43 和 GPIO44。正常运行时最好关掉：不写日志，这两个引脚也能腾给继电器用。

7. 供电与省电

广播周期，毫秒控制器每隔多久醒来广播一次——包含广播和休眠的完整周期。数值越小，手机越快发现设备，但电池也更快耗尽；数值越大越省电，代价是响应稍慢。

广播窗口时长，毫秒每个周期里控制器主动广播多少毫秒，然后进入休眠。这段时间要足够让手机捕捉到设备并建立连接——通常是 1500–2000 毫秒。

连接保持时长，毫秒如果有手机成功连上，控制器会再多醒这么多毫秒，以便接收指令并作出回应。

配对窗口，毫秒在进入休眠之前，控制器在配对模式下等待手机多久。九十秒对再慢的手机也绰绰有余。

周期之间的休眠，秒两次广播周期之间控制器休眠多少秒。填 0 表示完全不休眠，适用于市电或 USB 供电。用电池时，10–20 秒是最合适的：两节 AA 能撑几个月。

8. 外部时钟（可选）

小型时钟模块（DS3231、DS1307 或 PCF8563）自带纽扣电池，可多年保持准确时间。没有它，控制器内部时钟会明显漂移，每小时约 5%。只有时钟准确，控制器上的访客通行凭证才会按时到期。该模块为可选项，可以跳过本节。

外置 RTC 类型

构建并上传程序

服务器会完全按照您的设置构建程序（也就是固件）。您可以下载文件，也可以直接从浏览器把它传进控制器。

下载文件

保留与应用的配对（更新固件但不清除设置）

如果您想看看它、手动改一改、下载 .ino 或分享链接，请点「在编辑器中打开」。这正是服务器用来编译出 .bin。

下一步：在应用里配对控制器

上传完成后，控制器会在配对模式下等待主人 90 秒。以「所有者」身份打开 Entrixy 应用 → 添加对象 → BLE ——控制器会出现在列表里，选中它即可。如果没出现，就按一下板上的配对键，指示灯开始闪烁，列表随之刷新。应用完成密钥交换，控制器就归您了。详情见指南的「配对」一节。

继电器与驱动装置的接线

继电器上用到两个触点： 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 与它们并联即可。

用 esptool 烧录（浏览器方式行不通时）

下载 .bin （在上方）。
安装 esptool： pip install esptool
用 USB 连接 ESP。
烧录： esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
在 Windows 上，端口通常是 COM3 或 COM4。

成品 Wi-Fi 继电器的 UART 接入

成品设备（Shelly Plus 1、Plus 1PM）没有对外的 USB。必须打开外壳，用 USB 转串口适配器接到 ESP32 的 UART 引脚——CP2102、CH340 或 FTDI 都行。

通用接线

USB 转串口适配器	板上的 ESP32
GND	GND
3.3V	3V3（仅当您打算用适配器供电时才接；否则让设备用它自己的电源）
TX	RX
RX	TX
—	EN（RESET）——短暂接地，以便重启进入引导加载模式
—	GPIO0——上电时接地，以进入引导加载模式

不要给市电 在 USB 适配器接着的情况下接到设备的市电端子上。要么用适配器的 3.3 V 供电，要么把市电完全断开。否则 USB 与市电的地可能处在不同电位，您电脑的 USB 口会被烧毁。

各型号的引脚定义

设备	UART 在哪里	进入引导加载模式
Shelly Plus 1 / Plus 1PM	在外壳内部、ESP32 模块旁边。焊盘上的标注为 `3V3 GND TX RX GPIO0`。取下前盖（两三个卡扣），电路板就在上面。	把 GPIO0 接到 GND，再把 EN 短暂拉到 GND

如果这里没有列出您的型号：

templates.blakadder.com ——一个开放的 Tasmota 模板数据库，收录了各型号的 GPIO。它与我们设置的对应关系是： Relay1 → 继电器引脚， Button1 → 按钮引脚， Led1 → 状态指示灯。
devices.esphome.io ——ESPHome 的设备库。
如果哪里都查不到这个型号，就拿万用表：从继电器线圈一路量到 ESP32 的某个 GPIO。那就是您的 PIN_RELAY。

BLE 只在 ESP32 上可用。若用 ESP8266（Wemos D1、NodeMCU）或成品 Wi-Fi 继电器，请使用联网版配置器 ——那边走的是互联网连接。

如果您不想自己烧录程序

有三种绕开的办法：

自己动手做 ——买一块 ESP32 DevKit 板（约 5 美元）和任意一个 3.3 V 继电器模块（约 2 美元）。用接线盒当外壳。接到驱动装置上的方式和工业继电器一样。这是多数自制场景下推荐的路线。
联网设备 ——在下述配置器里，把带干接点的成品 Wi-Fi 继电器（Shelly Plus 1）刷成我们的程序：联网版配置器；也可以保留它原本的固件，改用以下方式开启：用 Webhook。驱动装置旁需要 Wi-Fi 和市电。
开箱即用的现成固件 ——Tasmota 或 ESPHome。在应用里建一个 Webhook 对象，填上设备地址。如果您根本不想把我们的程序装进设备，这个方式合适。