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

BLE 开启控制器

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

这套固件做什么

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

里面是什么

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

1. 选择开发板

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

控制器板

ESP32 与继电器同板

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

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

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

还需要什么

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

继电器模块 继电器模块 板子上没有继电器时就需要它。三根线接到 ESP32：控制、供电和地（GND）。继电器输出接到驱动装置
带插座的编程器 带插座的编程器 把裸的 ESP32 或 ESP32-S3 模块插进这个插座，就能给它烧录程序
USB 转 UART 适配器 USB 转 UART 适配器 用于给继电器板和 Shelly 烧录程序——只需接几个引脚
智能插座和 Wi-Fi 开关在这里派不上用场。 Athom Plug、Shelly Plus Plug S 之类的设备只是把市电切给负载——它们没有无源 NO/COM 输出，只有一个插孔。要驱动大门电机，需要 Plus 1 或 Plus 1PM 继电器，或者自制的带继电器模块的板子。
在给成品设备烧录程序之前，先确认各个引脚的对应关系。厂商有时会在同一型号内调整引脚位置。我们的图取自公开资料，并在自己手上的样机上验证过——您的板子可能略有差别。以板子上的丝印标注为准。

2. 开发板

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

3. 锁的类型

最主要的选择：它决定继电器的行为方式。点动：只有一个「开」脉冲。双稳态：两种位置，开与关分处不同引脚；状态会被记录并显示在应用里。

双稳态模式：控制器会记住当前位置（已开或已关）， 每次动作时切换一次。该位置会显示在应用的对象图标上， 所有者和访客都看得到。「关」指令所用的引脚在下面的「引脚」一节设置。

4. 引脚与极性

继电器与门锁

HIGH 脉冲适合直接用三极管开关的电路；LOW 脉冲（脉冲＝LOW，静默＝HIGH）适合大多数成品继电器模块和 Shelly。静默电平通常与脉冲电平相反。

指示灯
配对按钮
诊断

5. 供电与省电

6. 外部时钟（可选）

一个自带纽扣电池的小时钟模块（DS3231、DS1307 或 PCF8563）能把时间准确保持数年。没有它，控制器内部时钟会明显走偏，每小时约 5%。只有在给访客发放限时密钥时，准确时间才有意义——否则可跳过本节。

保存此配置

构建并上传程序

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



      
    

  










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


上传完成后，控制器会在配对模式下等待主人 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 烧录（浏览器方式行不通时）


    

  1. 下载 .bin （在上方）。
    2. 

  2. 安装 esptool： pip install esptool
    3. 

  3. 用 USB 连接 ESP。
    4. 

  4. 烧录： esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
    5. 

  5. 在 Windows 上，端口通常是 COM3 或 COM4.
    6. 








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


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



通用接线




USB 转串口适配器板上的 ESP32


GNDGND


3.3V3V3（仅当您打算用适配器供电时才接；否则让设备用它自己的电源）


TXRX


RXTX


—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 继电器，请使用 联网版配置器 ——那边走的是互联网连接。









如果您不想自己烧录程序


有三种绕开的办法：


    

  1. 自己动手做 ——买一块 ESP32 DevKit 板（约 5 美元）和任意一个 3.3 V 继电器模块（约 2 美元）。用接线盒当外壳。接到驱动装置上的方式和工业继电器一样。这是多数自制场景下推荐的路线。
    2. 

  2. 联网设备 ——在下述配置器里，把带干接点的成品 Wi-Fi 继电器（Shelly Plus 1）刷成我们的程序： 联网版配置器；也可以保留它原本的固件，改用以下方式开启： 用 Webhook。驱动装置旁需要 Wi-Fi 和市电。
    3. 

  3. 开箱即用的现成固件 ——Tasmota 或 ESPHome。在应用里建一个 Webhook 对象，填上设备地址。如果您根本不想把我们的程序装进设备，这个方式合适。
    4. 






点下按钮后稍等片刻——文件通常一分钟内就能准备好。程序构建完成后会出现下载按钮。