New Device

Device Name

Enter a name for the device that clearly identifies it. Typically this would include the manufacturer name and model.

Examples:

• Acme ESP32-S3-Mini Development Board
• Opticorp LED Strip Controller

Slug

A URL-friendly version of the device name. This will be used in URLs and file names.

Rules:

• Use only lowercase letters, numbers, dots, and hyphens
• No spaces or special characters
• Should be unique across all devices

This field is auto-generated from the device name but can be customized if needed.

Device Description

Provide a clear and detailed description of the device, including:

• Main features and capabilities
• What makes it unique or useful
• Any special requirements or considerations
• Target use cases or applications

Chip Type

Select the microcontroller chip used in the device. Each chip has different capabilities:

• ESP32: Dual-core, Wi-Fi + Bluetooth
• ESP32-S2: Single-core, Wi-Fi, USB-OTG
• ESP32-S3: Dual-core, Wi-Fi + Bluetooth LE, AI acceleration
• ESP32-C3: RISC-V, Wi-Fi + Bluetooth LE
• RP2040: Dual-core ARM Cortex-M0+
• RTL8710/8720: ARM Cortex-M3, Wi-Fi
• BK7231/T: ARM Cortex-M4, Wi-Fi

Difficulty Rating

Indicate how difficult it is to set up this device with ESPHome:

• 1 - Comes with ESPHome: Device ships with ESPHome pre-installed
• 2 - Plug-n-flash: Just connect and flash, no hardware modifications needed
• 3 - Disassembly required: Need to open the device to access flash points
• 4 - Soldering required: Need to solder wires or components
• 5 - Chip needs replacing: Original chip must be replaced with a compatible one

Product Page URL

Link to where the device can be purchased. This helps others find and buy the same device.

Guidelines:

• Use the official product page when possible
• Ensure the link is stable and likely to remain active
• Avoid affiliate links or temporary sale pages

Feature Tags

Tags help categorize your device. Select all that apply to your device. At least one must be selected.

Electrical Standards

For devices that are powered by or control a mains power supply, select the electrical standards that your device is compatible with. Multiple selections allowed. For devices not connected to the mains, leave this field empty.

Made for ESPHome

Is this device specifically designed to work with ESPHome? It must meet these requirements

GPIO Pin Configuration

Specify which GPIO pins on the device are used. For each pin that is used on the device, provide a label to identify its function, e.g. “LCD_CS” for the chip select pin of a display, or “UART_TX” for the UART transmit pin.

GPIO0 is often used for a boot button and if so should be labeled “BOOT”.

At least one pin must be specified.

Select a chip type to see the available pins for the device.

YAML Configuration

Provide a sample YAML configuration that demonstrates how to use the device with ESPHome.

Include:

• Essential device-specific configuration
• Pin assignments and component setups
• Required features and customizations

Do not include:

• External components
• !include statements
• Generic configurations (API, Bluetooth, etc.)
• Secrets or sensitive data
• Optional features not core to the device

If a Wi-Fi configuration is required, include only the ssid and password fields like this:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

For guidance, see the ESPHome documentation.

Device Images

Upload at least one and up to 3 images of the device to help others identify it.