espressif/esp_hosted

78 examples

• bluetooth 25
  • bluedroid_uart 2
    • bluedroid_host_only_uart 2
      • cp

        Classic Bluetooth device and service discovery operates using a Bluedroid host stack on a microcontroller with a dedicated UART connection to the Bluetooth controller.

        9.94 KB
      • mcu_host

        Classic Bluetooth (BR/EDR) device and service discovery using the Bluedroid stack with a UART connection to the controller.

        7.70 KB
  • esp_hosted_bluedroid 12
    • ble_advertise_minimal 2
      • cp

        This example demonstrates the smallest Bluedroid setup on an ESP-Hosted co-processor, enabling non-connectable BLE advertising.

        9.41 KB
      • mcu_host

        The smallest Bluedroid + ESP-Hosted example that starts non-connectable BLE advertising using a single setup call.

        4.99 KB
    • ble_compatibility_test 2
      • cp

        A BLE interoperability test app acting as a GATT server to validate BLE behavior against various devices.

        9.44 KB
      • mcu_host

        BLE interoperability test app for validating BLE behavior against devices, running Bluedroid on a host and ESP-Hosted co-processor.

        10.29 KB
    • ble_gatt_server 2
      • cp

        Connectable BLE peripheral with a custom GATT service exposing read/write and notify characteristics.

        9.42 KB
      • mcu_host

        Connectable BLE peripheral with a custom GATT service exposing read/write and notify characteristics.

        5.98 KB
    • bt_hid_mouse 2
      • cp

        This project implements a Bluetooth Classic HID mouse that works with ESP32 as a coprocessor, sending mouse movement reports.

        9.53 KB
      • mcu_host

        Acts as a Bluetooth Classic HID mouse, pairing with a host to send mouse-movement reports.

        7.87 KB
    • classic_bt_discovery 2
      • cp

        Performs a Classic Bluetooth device inquiry, printing every device seen during the discovery window.

        9.50 KB
      • mcu_host

        Performs a Classic Bluetooth (BR/EDR) device inquiry and prints detected devices during discovery.

        5.61 KB
    • controller_mac_addr 2
      • cp

        Reads and optionally overrides the BT controller's MAC address on the co-processor before initialization.

        9.39 KB
      • mcu_host

        This example reads and optionally overrides the BT controller's MAC address before initializing the BT controller.

        5.61 KB
  • esp_hosted_custom 2
    • hci_demo 2
      • cp

        7.96 KB
      • mcu_host

        2.52 KB
  • esp_hosted_nimble 6
    • bleprph_gatt 2
      • cp

        Connectable BLE peripheral exposing a custom 128-bit GATT service with two characteristics (read/write + notify).

        9.47 KB
      • mcu_host

        This project is a connectable BLE peripheral that exposes a custom 128-bit GATT service with read/write and notify characteristics, running NimBLE on the host.

        5.45 KB
    • bleprph_minimal 2
      • cp

        The smallest possible NimBLE BLE peripheral runs NimBLE host code on the ESP-Hosted co-processor, enabling connectable advertising.

        9.46 KB
      • mcu_host

        The smallest possible NimBLE BLE peripheral uses the ESP-Hosted co-processor to run NimBLE host code for BLE connectivity.

        4.63 KB
    • bleprph_wifi_coex 2
      • cp

        This example demonstrates concurrent Wi-Fi and BLE operation on the same co-processor, integrating NimBLE with a hosted HCI setup.

        9.88 KB
      • mcu_host

        This example showcases Wi-Fi STA and BLE peripheral running simultaneously on the same co-processor, using NimBLE over hosted HCI.

        22.60 KB
  • nimble_uart 3
    • bleprph_host_only_uart 3
      • cp

        NimBLE host-only BLE peripheral that communicates HCI over UART to an external BT controller, running in native UART-H4 mode.

        10.52 KB
      • cp_wifi

        NimBLE host-only BLE peripheral communicates HCI over UART with an external BT controller in native mode.

        10.82 KB
      • mcu_host

        NimBLE host-only BLE peripheral communicates via HCI over dedicated UART to an external BT controller, using its own UART transport.

        17.82 KB
• ext_coex 2
  • cp

    Configures the coprocessor's external-coex work mode for shared Wi-Fi/BT radio use with third-party radios.

    10.42 KB
  • mcu_host

    Configures the coprocessor's external-coex work mode for sharing the air with a third-party radio.

    4.93 KB
• gpio_expander 2
  • cp

    Drives CP-side GPIOs from the host as if the coprocessor were a remote GPIO expander using RPC calls.

    10.35 KB
  • mcu_host

    Drives CP-side GPIOs from the host, enabling remote GPIO expansion when the host MCU runs out of pins.

    3.47 KB
• mcu_hosted_sdio_sdmmc_combined 2
  • cp

    This example demonstrates running ESP-Hosted's SDIO transport on the SDMMC controller, sharing the bus driver while operating an external SD card.

    10.17 KB
  • mcu_host

    Demonstrates running ESP-Hosted's SDIO transport on an SDMMC controller, sharing it with an external SD card.

    10.90 KB
• mem_monitor 2
  • cp

    Subscribes the host to periodic heap/task-stat reports from the coprocessor for monitoring performance.

    10.25 KB
  • mcu_host

    Subscribes the host to periodic heap/task-stat reports from the coprocessor to monitor memory usage.

    11.59 KB
• network_split 4
  • iperf 2
    • cp

      This example demonstrates iperf3 on a network split system where the coprocessor handles Wi-Fi and the host runs its own TCP/IP stack.

      23.60 KB
    • mcu_host

      This example uses iperf3 to measure end-to-end throughput in a split network setup with host and coprocessor.

      35.26 KB
  • station 2
    • cp

      Bare-bones Wi-Fi station with a network-split netif backend, allowing host and co-processor to share one IP.

      23.22 KB
    • mcu_host

      Bare-bones Wi-Fi station with network-split netif backend; shares one IP with the co-processor.

      30.43 KB
• openthread 4
  • border_router 2
    • cp

      OpenThread Border Router enables a single ESP-Hosted co-processor to function as both an 802.15.4 RCP and Wi-Fi backhaul.

      5.04 KB
    • esp_host

      The OpenThread Border Router enables a single ESP-Hosted co-processor to function as both a Wi-Fi CP and an 802.15.4 RCP, bridging a Thread mesh to a Wi-Fi LAN.

      8.13 KB
  • cli 2
    • cp

      Runs a full OpenThread CLI on the host, using an 802.15.4 Radio Co-Processor (RCP) over UART.

      4.78 KB
    • esp_host

      Runs a full OpenThread CLI on the host using an ESP32 co-processor, managing 802.15.4 traffic over UART.

      7.12 KB
• ota 2
  • coprocessor_ota 2
    • cp

      The coprocessor OTA allows the host to push new firmware images through an OTA RPC chain using various sources.

      10.42 KB
    • mcu_host

      This module allows the host to push new CP firmware images via an OTA RPC chain, sourcing from HTTPS, LittleFS, or raw flash.

      35.69 KB
• peer_data_transfer 2
  • cp

    Demonstrates the peer_data custom-RPC channel where the host sends application-defined messages to the co-processor, which echoes them back for verification.

    10.77 KB
  • mcu_host

    Demonstrates the peer_data custom-RPC channel where the host sends and receives application-defined messages.

    11.12 KB
• power_save 6
  • cp 2
    • shut_down_cp_when_unused 2
      • cp

        This example demonstrates how to shut down the co-processor when unused to conserve power, utilizing a full CP cold-boot on wake-up.

        3.71 KB
      • mcu_host

        The host manages the co-processor by holding it in reset when idle, cutting power usage, and fully re-initializing on wake.

        10.85 KB
  • host 2
    • network_split__host_deep_sleep 2
      • cp

        Network split allows the coprocessor to maintain Wi-Fi connectivity while the host goes into deep sleep.

        22.49 KB
      • esp_host

        Network split allows the coprocessor to maintain Wi-Fi while the host enters deep sleep, waking only for specific packet traffic.

        16.84 KB
  • host+cp 2
    • network_split__host_deep_sleep_cp_light_sleep 2
      • cp

        This example demonstrates a power-saving method where the host is in deep sleep and the coprocessor is in light sleep, while maintaining an active Wi-Fi connection.

        28.48 KB
      • esp_host

        This project enables both host deep sleep and co-processor light sleep while keeping Wi-Fi alive for efficient power management.

        16.78 KB
• system 8
  • api_exerciser 2
    • cp

      3.19 KB
    • mcu_host

      A host+CP example that exposes the `eh_host_*` API as console commands for functional API coverage.

      3.79 KB
  • get_cp_fw_version 2
    • cp

      The get_cp_fw_version example demonstrates the simplest end-to-end ESP-Hosted scenario by fetching the coprocessor firmware version.

      10.26 KB
    • mcu_host

      The smallest end-to-end ESP-Hosted scenario to fetch and print the CP firmware version as a smoke test for new ports.

      5.63 KB
  • hosted_events 2
    • cp

      Wires the host's ESP-IDF event loop to ESP-Hosted's lifecycle events for coprocessor state changes without polling.

      10.25 KB
    • mcu_host

      Wires the host's ESP-IDF event loop to ESP-Hosted's lifecycle events to react to coprocessor state changes without polling.

      12.57 KB
  • mcu_transport_config 2
    • cp

      Configures the host-side transport programmatically at runtime before esp_hosted_init(). This example demonstrates how to override Kconfig defaults in code.

      10.15 KB
    • mcu_host

      Configures the host-side transport programmatically at runtime before esp_hosted_init(). It allows overriding Kconfig defaults for bus pins or clock from application settings.

      7.08 KB
• wifi 17
  • apsta 2
    • cp

      Run Wi-Fi in AP + STA concurrent mode, connecting to an AP while serving a SoftAP via coprocessor.

      10.00 KB
    • mcu_host

      Run Wi-Fi in AP + STA concurrent mode—connect to an upstream AP as a station while serving a SoftAP.

      6.56 KB
  • dpp 2
    • cp

      Wi-Fi Easy-Connect enrollee allows devices to join Wi-Fi networks by scanning a QR code, enabling seamless credential transfer.

      10.24 KB
    • mcu_host

      Wi-Fi Easy-Connect enrollee allows scanning a QR code to push Wi-Fi credentials, enabling seamless AP joining.

      6.54 KB
  • enterprise 2
    • cp

      Wi-Fi station bring-up against enterprise APs using EAP authentication, with the radio on the coprocessor and the application on the host.

      10.29 KB
    • mcu_host

      Wi-Fi station bring-up against an enterprise AP, allowing clients to authenticate using certificates or per-user credentials.

      3.85 KB
  • iperf 2
    • cp

      Wi-Fi throughput benchmark using a coprocessor, enabling TCP/UDP iperf testing across the hosted transport.

      10.28 KB
    • mcu_host

      Wi-Fi throughput benchmark where the host runs the IDF `wifi/iperf` app to measure end-to-end throughput.

      5.18 KB
  • itwt 2
    • cp

      The Wi-Fi iTWT coprocessor enables a periodic wake schedule for Wi-Fi 6 devices, reducing power consumption.

      10.22 KB
    • mcu_host

      Wi-Fi iTWT facilitates individual Target Wake Time scheduling for Wi-Fi 6 devices, enhancing power efficiency by managing wake-up periods.

      16.71 KB
  • scan 2
    • cp

      This example scans for nearby Wi-Fi access points, printing their SSID, RSSI, channel, and auth mode.

      10.15 KB
    • mcu_host

      Scan for nearby Wi-Fi access points and print SSID, RSSI, channel, and auth mode for each.

      4.79 KB
  • softap 2
    • cp

      Run a Wi-Fi SoftAP using the coprocessor's radio while the application runs on the host, automatically spawning a DHCP server.

      10.19 KB
    • mcu_host

      Run a Wi-Fi SoftAP with the radio on the coprocessor and application on the host, enabling clients to connect easily.

      4.70 KB
  • sta 3
    • cp

      Connect to an AP as a Wi-Fi station using the coprocessor for radio and the host for the application.

      10.27 KB
    • cp_streaming

      Connect to an AP as a Wi-Fi station with the radio on the coprocessor and the application on the host.

      10.28 KB
    • mcu_host

      Connect to an AP as a Wi-Fi station with the radio on the coprocessor and the application on the host.

      6.41 KB
• zigbee 2
  • thermostat 2
    • cp

      Runs a Zigbee Home Automation Thermostat using an ESP32 co-processor for controlling 802.15.4 radio communication.

      4.91 KB
    • esp_host

      Runs a Zigbee Home Automation Thermostat on the host using an 802.15.4 Radio Co-Processor.

      15.40 KB