--- title: iButton slug: zero/zh/ibutton description: iButton 模块的功能与硬件 image: https://archbee-image-uploads.s3.amazonaws.com/3StCFqarJkJQZV-7N79yY/kxsGC_NM-WSR-fkouYYGK_ibutton.png docTags: createdAt: 2022-09-19T13:49:38.000Z --- ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/43zC1a3nekm0X-fUIxa32_open-sign-zh-1.png) Flipper Zero 支持 1-Wire 设备通信协议，这种协议应用在被称为 iButton 钥匙的小型电子钥匙中。这类钥匙用于门禁、温度测量、湿度测量、存储密钥等场景。 借助内置的 iButton 模块，Flipper Zero 可以读取、写入和模拟 iButton 门禁钥匙。该模块支持 Dallas、Cyfral 和 Metakom 钥匙协议。 :::Iframe{iframeHeight="0" code="
使用 iButton 应用前请插入 microSD 卡
使用 iButton 应用前，请确保在插入 microSD 卡的状态下更新 Flipper Zero 固件，因为 Flipper Zero 会将数据库存储在 microSD 卡上。要了解更新流程的更多信息，请参阅 固件更新页面。
"} ::: 本页将概要介绍 iButton 应用，并说明 iButton 模块背后的硬件。 *** # iButton 菜单 你可以从 Main Menu 打开 iButton 应用。在该应用中，你可以读取、保存、编辑、写入和模拟 iButton 钥匙。 ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/MM10X1ylV6rdJMw31vQ4j_ibutton-menu.jpg "iButton 应用菜单") - [Read](https://docs.flipper.net/zero/zh/ibutton/read)**：**检测钥匙类型，读取并保存钥匙的唯一编号。 - **Saved：**模拟、编辑和写入已保存的钥匙。 - [Add Manually](https://docs.flipper.net/zero/zh/ibutton/add-manually)**：**生成带唯一编号、可用于模拟的钥匙。 *** # iButton 硬件 :::Iframe{code="
并非所有 iButton 设备都能被 Flipper Zero 识别
不同的 iButton 设备可能有相同的外形，但 Flipper Zero 只能识别门禁钥匙。
" iframeHeight="0"} ::: Flipper Zero 内置的 iButton 模块由一个 iButton 触点板和三根[弹簧探针](https://www.digikey.cn/zh/articles/the-basics-of-pogo-pin-connectors)组成，探针位于 iButton 电路板上。 ![](https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/ZcTcKHLn4AAr23Uggfl6W_ibutton-hardware.jpg "iButton 模块的引脚") 其中两根探针用于数据传输，并引出到 GPIO 引脚 17。剩下的中间那根是接地。 ::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/A0zTr_tYynrUPjkYnxgTQ_ibutton-wiring.jpg" size="90" width="2787" height="1434" caption="iButton 数据引脚引出到 GPIO 引脚 17" position="center" darkWidth="2787" darkHeight="1434" showCaption="true"} 触点板的平坦部分用于把 iButton 钥匙（从设备）连接到 Flipper Zero（主设备）。读取和写入 iButton 钥匙时，使用左侧的数据引脚和中间的接地引脚。 ::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/MqVzWFOSsqLO2zcSiwmCr_ibutton-reading-writing.jpg" size="90" width="2939" height="1360" caption="用于读取和写入的引脚" position="center" darkWidth="2939" darkHeight="1360" showCaption="true"} 触点板的凸起部分用于把 Flipper Zero（从设备）连接到 iButton 读头（主设备）。模拟 iButton 钥匙时，使用右侧的数据引脚和中间的接地引脚。 ::Image[]{src="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/h4zNH2ma1GF_iFSrpKPnJ_ibutton-emulation.jpg" size="90" width="2849" height="1403" caption="用于模拟的引脚" position="center" showCaption="true" darkWidth="2849" darkHeight="1403"} *** ::::LinkArray{contentSource="CUSTOM"} :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/kxtsdU0BA4TeD_rPB0DzR_reading-ibutton-keys-block.png"} [读取 iButton 钥匙](https://docs.flipper.net/zero/zh/ibutton/read) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/auVfSh9O_eunQEFC421NT_adding-ibutton-keys-manually-block.png"} [手动添加 iButton 钥匙](https://docs.flipper.net/zero/zh/ibutton/add-manually) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/0ZDwjHr-UPSLC8FcHihOc_writing-data-to-ibutton-blanks-block.png"} [向 iButton 钥匙写入数据](https://docs.flipper.net/zero/zh/ibutton/write) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/FaM11lt8jMe1TQWYp52A6_pflnlgh9s-xtykklkskb1-monosnap-miro-2022-10-25-19-39-43.webp"} [Flipper Zero 电路原理图](https://docs.flipper.net/zero/zh/development/hardware/schematic) ::: :::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/3StCFqarJkJQZV-7N79yY/7_VPROKgReSBtiBsWiw5z_qk2fdzhhnl66ou16o74iw-monosnap-miro-2022-10-25-19-31-25.webp"} [iButton 应用源代码](https://github.com/flipperdevices/flipperzero-firmware/tree/dev/applications/main/ibutton) ::: ::::