--- title: ESPHome Zone to GPIO Pin Mapping description: Internally, the Konnected application references pins instead of zone numbers. Zone numbers are labeled sequentially for user-friendliness, --- [Skip to content](https://support.konnected.io/zone-to-gpio-pin-mapping#main-content) English Show submenu for translations [Submit a Ticket](https://support.konnected.io/kb-tickets/new?hsLang=en) [Customer portal](https://support.konnected.io/tickets-view?hsLang=en) ![Refreshed Logo Blue (HQ)](https://support.konnected.io/hs-fs/hubfs/Refreshed%20Logo%20Blue%20(HQ).png?width=250&height=45&name=Refreshed%20Logo%20Blue%20(HQ).png) - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) Open main navigation Close main navigation - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) - English Show submenu for translations - [Submit a Ticket](https://support.konnected.io/kb-tickets/new) - [Customer portal](https://support.konnected.io/tickets-view) - [Shop Now](https://konnected.io/collections/shop-now) [Shop Now](https://konnected.io/collections/shop-now) Konnected Knowledge Base - There are no suggestions because the search field is empty. 1. [Help & Support](https://support.konnected.io/?hsLang=en) 2. [ESPHome](https://support.konnected.io/esphome?hsLang=en) 3. [Konnected Device API](https://support.konnected.io/esphome?hsLang=en#konnected-device-api) # ESPHome Zone to GPIO Pin Mapping Internally, the Konnected application references *pins* instead of zone numbers. Zone numbers are labeled sequentially for user-friendliness, but the internal pin numbers map to the GPIO index of each I/O port on the ESP chip.  Konnected's ESPHome *base packages* set [substitutions](https://esphome.io/guides/configuration-types.html#substitutions) or variables that make it simpler for you to reference zones or outputs in your ESPHome configuration. ### Konnected Alarm Panel (ESP8266) Zone to Pin Mapping Used for the original NodeMCU based Konnected Alarm Panel, Konnected Alarm Panel v2 and other products using the ESP8266 based WiFi chip. | **Zone #** | **ESPHome variable** | **NodeMCU Pin #** | **GPIO #** | | --- | --- | --- | --- | | 1 | $zone1 | D1 | GPIO5 | | 2 | $zone2 | D2 | GPIO4 | | 3 | $zone3 | D5 | GPIO14 | | 4 | $zone4 | D6 | GPIO12 | | 5 | $zone5 | D7 | GPIO13 | | 6 | $zone6 | RX or D9 | GPIO3 | | OUT or ALARM | $out or $alarm | D8 | GPIO15 | ### Alarm Panel Pro (ESP32) Zone to GPIO Mapping The Alarm Panel Pro uses the ESP32­-WROOM­-32D chip from Espressif and the following zone to GPIO mapping. | **Zone #** | **ESPHome variable** | **GPIO #** | | --- | --- | --- | | 1 | $zone1 | GPIO4 | | 2 | $zone2 | GPIO2 | | 3 | $zone3 | GPIO15 | | 4 | $zone4 | GPIO13 | | 5 | $zone5 | GPIO18 | | 6 | $zone6 | GPIO14 | | 7 | $zone7 | GPIO33 | | 8 | $zone8 | GPIO32 | | 9 | $zone9 | GPIO36 | | 10 | $zone10 | GPIO39 | | 11 | $zone11 | GPIO34 | | 12 | $zone12 | GPIO35 | | ALARM1 | $alarm1 | GPIO12 | | OUT1 | $out1 | GPIO23 | | ALARM2 or OUT2 | $alarm2 or $out2 | GPIO5 | - [Konnected Devices in General](https://support.konnected.io/konnected-devices-in-general?hsLang=en#main-content) - [Intro to Konnected](https://support.konnected.io/konnected-devices-in-general?hsLang=en#intro-to-konnected) - [Power](https://support.konnected.io/konnected-devices-in-general?hsLang=en#power) - [WiFi and Networking](https://support.konnected.io/konnected-devices-in-general?hsLang=en#wifi-and-networking) - [Firmware and Updates](https://support.konnected.io/konnected-devices-in-general?hsLang=en#firmware-and-updates) - [Security Best Practices](https://support.konnected.io/konnected-devices-in-general?hsLang=en#security-best-practices) - [Alarm Panel](https://support.konnected.io/alarm-panel?hsLang=en#main-content) - [Installation Guide Table of Contents](https://support.konnected.io/alarm-panel?hsLang=en#installation-guide-table-of-contents) - [Wiring and Connection Guides](https://support.konnected.io/alarm-panel?hsLang=en#wiring-and-connection-guides) - [Interfacing In-parallel with a Traditional Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#interfacing-in-parallel-with-a-traditional-alarm-system) - [Alarm Panel Pro](https://support.konnected.io/alarm-panel?hsLang=en#alarm-panel-pro) - [6-Zone Alarm Panel & Alarm Panel Add-on (discontinued)](https://support.konnected.io/alarm-panel?hsLang=en#6-zone-alarm-panel-alarm-panel-add-on-discontinued) - [Standalone Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#standalone-alarm-system) - [GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#main-content) - [Getting Started with the GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#getting-started-with-the-gdo-blaq) - [Platform Integrations](https://support.konnected.io/gdo-blaq?hsLang=en#platform-integrations) - [Device Features](https://support.konnected.io/gdo-blaq?hsLang=en#device-features) - [GDO White](https://support.konnected.io/gdo-white?hsLang=en#main-content) - [Garage Door Opener White Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-white-installation-and-setup-guide) - [Detailed Wiring Guide](https://support.konnected.io/gdo-white?hsLang=en#detailed-wiring-guide) - [Garage Door Opener v1 Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-v1-installation-and-setup-guide) - [Accessories](https://support.konnected.io/accessories?hsLang=en#main-content) - [Backup Batteries](https://support.konnected.io/accessories?hsLang=en#backup-batteries) - [Sensors](https://support.konnected.io/accessories?hsLang=en#sensors) - [SmartThings](https://support.konnected.io/smartthings?hsLang=en) - [Home Assistant](https://support.konnected.io/home-assistant?hsLang=en) - [Hubitat](https://support.konnected.io/hubitat?hsLang=en#main-content) - [GDO White](https://support.konnected.io/hubitat?hsLang=en#gdo-white) - [Legacy drivers](https://support.konnected.io/hubitat?hsLang=en#legacy-drivers) - [Alarm Panels](https://support.konnected.io/hubitat?hsLang=en#alarm-panels) - [Troubleshooting](https://support.konnected.io/hubitat?hsLang=en#troubleshooting) - [Control4](https://support.konnected.io/control4?hsLang=en) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#main-content) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#esphome) - [Konnected Device API](https://support.konnected.io/esphome?hsLang=en#konnected-device-api) - [openHAB](https://support.konnected.io/esphome?hsLang=en#openhab) - [Matter](https://support.konnected.io/matter?hsLang=en) - [Frequently Asked Questions (FAQ)](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#main-content) - [Garage Door Opener](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#garage-door-opener) - [General](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#general) - [Pre-Purchase Guides](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#pre-purchase-guides) - [Troubleshooting](https://support.konnected.io/troubleshooting?hsLang=en#main-content) - [Hardware issues](https://support.konnected.io/troubleshooting?hsLang=en#hardware-issues) - [Frequently Asked Questions (FAQs)](https://support.konnected.io/troubleshooting?hsLang=en#frequently-asked-questions-faqs) - [Device Discovery](https://support.konnected.io/troubleshooting?hsLang=en#device-discovery) - [Konnected Device Firmware & Software](https://support.konnected.io/troubleshooting?hsLang=en#konnected-device-firmware-software) - [Legacy: HASS Install](https://support.konnected.io/troubleshooting?hsLang=en#legacy-hass-install) - [Legacy: Wiring Info](https://support.konnected.io/troubleshooting?hsLang=en#legacy-wiring-info) - [Garage Door Opener](https://support.konnected.io/troubleshooting?hsLang=en#garage-door-opener) - [Orders, Shipping & Returns](https://support.konnected.io/orders-shipping-returns?hsLang=en#main-content) - [Refund and Return Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#refund-and-return-policies) - [Shipping Information and Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#shipping-information-and-policies) - [Safety Information](https://support.konnected.io/safety-information?hsLang=en#main-content) - [Standards & Certifications](https://support.konnected.io/safety-information?hsLang=en#standards-certifications) - [Warnings & Disclosures](https://support.konnected.io/safety-information?hsLang=en#warnings-disclosures) - [Products](https://support.konnected.io/products?hsLang=en#main-content) - [Depreciated Support Articles](https://support.konnected.io/products?hsLang=en#depreciated-support-articles) - [FAQs](https://support.konnected.io/faqs?hsLang=en#main-content) - [Additional Wiring Guides](https://support.konnected.io/faqs?hsLang=en#additional-wiring-guides) - [SmartThings Steps](https://support.konnected.io/smartthings-steps?hsLang=en) - [Noonlight](https://support.konnected.io/noonlight?hsLang=en) - [Alexa](https://support.konnected.io/alexa?hsLang=en) - [Google Home](https://support.konnected.io/google-home?hsLang=en) [![Konnected](https://support.konnected.io/hubfs/konnected-logo-white.svg "Konnected")](http://konnected.io) [mailto:help@konnected.io](mailto:help@konnected.io) Copyright © 2025, Konnected Inc.