esp8266-rtos-sdk-skill

Generates ESP8266_RTOS_SDK firmware code with verified APIs, recipes, and build workflows.

28|3|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/JasonYANG170/esp-dev-skill --skill esp8266-rtos-sdk-skill-jasonyang170
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: esp8266-rtos-sdk-skill
Source: https://github.com/JasonYANG170/esp-dev-skill/tree/main/repos/ESP8266_RTOS_SDK
Command: npx skills add https://github.com/JasonYANG170/esp-dev-skill --skill esp8266-rtos-sdk-skill-jasonyang170

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing firmware for the ESP8266EX with ESP8266_RTOS_SDK requires exact initialization sequences, correct Kconfig symbols, and awareness of chip-specific pitfalls (GPIO6-11 flash pins, NVS-before-WiFi, partition table constraints). This Skill grounds AI code generation in the real SDK headers, examples, and docs so generated code compiles and runs without invented APIs. ## Core Features & Use Cases - Scenario recipes: Step-by-step guides for WiFi Station/SoftAP/SmartConfig/ESPNOW, GPIO/UART/PWM/I2C peripherals, sockets/HTTP/MQTT/SNTP networking, SPIFFS storage, OTA upgrades, and deep sleep power management, each with real code and common-error tables. - Verified API and config references: Function signatures, structs, enums, and Kconfig symbols extracted from actual SDK headers, plus a full example index and a 14-item critical pitfalls list with wrong/correct code pairs. - Use Case: Ask the AI to build a WiFi station project that connects to an AP and publishes sensor data over MQTT; the Skill supplies the correct init order (nvs_flash_init → tcpip_adapter_init → event loop → esp_wifi_init), reconnection logic, and make/idf.py build commands. ## Quick Start Ask the AI to create a new ESP8266_RTOS_SDK WiFi station project based on the station example and explain the build and flash commands.

Frequently Asked Questions about esp8266-rtos-sdk-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new ESP8266_RTOS_SDK project?

Copy the examples/get-started/hello_world directory, set IDF_PATH to the SDK root, add the xtensa-lx106-elf toolchain to PATH, then run make menuconfig, make -j5, and make flash monitor. The entry point is app_main(), not user_init.

How do I connect ESP8266 to WiFi in station mode?

Initialize NVS first, then tcpip_adapter_init (or esp_netif_init), create the default event loop, call esp_wifi_init, register handlers, set mode and config, then esp_wifi_start. Reconnect inside WIFI_EVENT_STA_DISCONNECTED and wait for IP_EVENT_STA_GOT_IP before sending data.

Does ESP8266_RTOS_SDK work with ESP32 chips or Arduino?

No. This SDK targets only the ESP8266EX single-core chip. ESP32 series chips require esp-idf, and Arduino-ESP8266 uses a different setup()/loop() framework, so the APIs and initialization flows are not interchangeable.

Why does esp_wifi_init fail or abort on ESP8266?

The most common cause is a missing nvs_flash_init() call before WiFi initialization, since WiFi stores calibration data in NVS. Initialize NVS first, erasing and retrying if ESP_ERR_NVS_NO_FREE_PAGES or ESP_ERR_NVS_NEW_VERSION_FOUND is returned.

Which GPIO pins are safe to use on ESP8266?

Only GPIO0 through GPIO16 exist, and GPIO6-GPIO11 are connected to flash and must not be used. GPIO16 has no internal pull-up (pull-down only), and GPIO0/2/15 have boot-mode strapping constraints.

Why does ESP8266 OTA not boot the new firmware?

After esp_ota_end succeeds you must call esp_ota_set_boot_partition and then esp_restart, otherwise the old image boots. The partition table must also use the Two OTA app layout with ota_0, ota_1, and otadata partitions.