espressif/esp_hosted

3.0.10

Latest
uploaded 5 hours ago
ESP-Hosted - Unified coprocessor connectivity
Readme Dependencies 1 Dependents 13 Examples 80 Versions 123

80 examples

  • bluetooth 25
    • bluedroid_uart 2
      • bluedroid_host_only_uart 2
        • cp
          Classic Bluetooth device and service discovery using a Bluedroid host over a dedicated HCI UART-connected coprocessor.
          9.94 KB
        • mcu_host
          Discovers Classic Bluetooth devices and services using a Bluedroid host over a dedicated H4 UART.
          7.70 KB
    • esp_hosted_bluedroid 12
      • ble_advertise_minimal 2
        • cp
          This example runs Bluedroid on the host and starts non-connectable BLE advertising via an ESP-Hosted co-processor.
          9.41 KB
        • mcu_host
          Minimal ESP-Hosted Bluedroid example running the controller on a co-processor and starting BLE advertising.
          4.99 KB
      • ble_compatibility_test 2
        • cp
          BLE interoperability test app with a GATT server for validating behavior against phones and other centrals.
          9.45 KB
        • mcu_host
          BLE compatibility test app with a GATT server testing characteristics, MTU sizes, notifications, and connection parameters.
          10.29 KB
      • ble_gatt_server 2
        • cp
          A connectable BLE peripheral exposes custom read/write and notify characteristics using Bluedroid over hosted HCI.
          9.42 KB
        • mcu_host
          Connectable BLE peripheral with a custom GATT service, read/write characteristic, and notify characteristic.
          5.98 KB
      • bt_hid_mouse 2
        • cp
          Acts as a Bluetooth Classic HID mouse that pairs with a host and sends mouse-movement reports.
          9.53 KB
        • mcu_host
          Acts as a Bluetooth Classic HID mouse that pairs with hosts and sends mouse-movement reports.
          7.87 KB
      • classic_bt_discovery 2
        • cp
          Performs a Classic Bluetooth (BR/EDR) device inquiry and prints every device the controller sees during the discovery window.
          9.50 KB
        • mcu_host
          Performs a Classic Bluetooth device inquiry and prints every device seen during discovery.
          5.61 KB
      • controller_mac_addr 2
        • cp
          Reads and optionally overrides the BT controller MAC, then brings up Bluedroid over hosted HCI.
          9.39 KB
        • mcu_host
          Reads and optionally overrides the BT controller MAC before initialization, then starts Bluedroid over hosted HCI.
          5.61 KB
    • esp_hosted_custom 2
      • hci_demo 2
        • cp
          This example drives a BT controller over ESP-Hosted with a custom raw-HCI handler. It demonstrates an HCI round trip.
          9.24 KB
        • mcu_host
          This example uses a custom raw-HCI handler to connect a host Bluetooth stack to an ESP-Hosted co-processor controller.
          3.92 KB
    • esp_hosted_nimble 6
      • bleprph_gatt 2
        • cp
          Connectable BLE peripheral exposing one custom 128-bit GATT service with two characteristics (read/write + notify).
          9.47 KB
        • mcu_host
          This example implements a connectable BLE peripheral with a custom GATT service using NimBLE over ESP-Hosted HCI.
          5.45 KB
      • bleprph_minimal 2
        • cp
          This example boots a BLE controller on an ESP-Hosted co-processor and runs NimBLE host code for advertising.
          9.46 KB
        • mcu_host
          Minimal NimBLE BLE peripheral using an ESP-Hosted co-processor controller and standard NimBLE host code.
          4.63 KB
      • bleprph_wifi_coex 2
        • cp
          Wi-Fi STA and BLE peripheral run concurrently on the same co-processor, with NimBLE over hosted HCI.
          9.88 KB
        • mcu_host
          Wi-Fi STA and BLE peripheral run concurrently on the same co-processor, with NimBLE over hosted HCI.
          22.75 KB
    • nimble_uart 3
      • bleprph_host_only_uart 3
        • cp
          A NimBLE host-only BLE peripheral communicates with an external Bluetooth controller over a dedicated HCI UART.
          11.04 KB
        • cp_wifi
          NimBLE host-only BLE peripheral communicating with an external Bluetooth controller over a dedicated UART H4 link.
          10.82 KB
        • mcu_host
          NimBLE BLE peripheral using an external controller over a dedicated HCI UART. The local controller is disabled.
          17.82 KB
  • ext_coex 2
    • cp
      Configures external coexistence (PTA) so the coprocessor shares radio airspace with a third-party radio.
      10.42 KB
    • mcu_host
      Configures PTA external coexistence so Wi-Fi/BT can share air with a nearby third-party radio.
      4.93 KB
  • gpio_expander 2
    • cp
      Drives coprocessor GPIOs remotely from the host via RPC, acting as a remote GPIO expander.
      10.35 KB
    • mcu_host
      Drives coprocessor GPIOs remotely from the host via RPC, acting as a remote GPIO expander.
      3.47 KB
  • mcu_hosted_sdio_sdmmc_combined 2
    • cp
      Demonstrates ESP-Hosted Wi-Fi over SDIO alongside an external SD card on a shared SDMMC controller.
      10.17 KB
    • mcu_host
      Demonstrates ESP-Hosted SDIO and an external SD card sharing an SDMMC controller. Tests Wi-Fi and FATFS.
      10.90 KB
  • mem_monitor 2
    • cp
      Monitors coprocessor heap and task statistics periodically, logging reports or low-water threshold crossings.
      10.25 KB
    • mcu_host
      Subscribes the host to periodic coprocessor heap and task-stat reports. Helps detect leaks and size buffers.
      11.59 KB
  • network_split 4
    • iperf 2
      • cp
        This example uses network split to measure end-to-end throughput with iperf3 between the host and coprocessor.
        23.75 KB
      • mcu_host
        This example uses iperf3 to measure end-to-end throughput between the coprocessor and host network stacks.
        35.50 KB
    • station 2
      • cp
        Bare-bones Wi-Fi station using network split, with Wi-Fi on the coprocessor and TCP/IP on the host.
        23.38 KB
      • mcu_host
        Bare-bones Wi-Fi station validating network split, with host and co-processor sharing an IP and port space.
        30.58 KB
  • openthread 4
    • border_router 2
      • cp
        An OpenThread Border Router uses one ESP-Hosted co-processor for both 802.15.4 radio and Wi-Fi backhaul.
        5.04 KB
      • esp_host
        OpenThread Border Router on a host using one ESP-Hosted co-processor for Wi-Fi and 802.15.4.
        8.13 KB
    • cli 2
      • cp
        Runs a full OpenThread CLI on the host using an 802.15.4 RCP over ESP-Hosted and a dedicated UART.
        4.78 KB
      • esp_host
        Runs a full OpenThread CLI on the host with an ESP32-C6 RCP over ESP-Hosted and dedicated UART.
        7.12 KB
  • ota 2
    • coprocessor_ota 2
      • cp
        Pushes a new co-processor firmware image from the host through an OTA RPC chain.
        10.42 KB
      • mcu_host
        Pushes a new CP firmware image from the host through the OTA begin/write/end/activate RPC chain.
        35.85 KB
  • peer_data_transfer 2
    • cp
      Demonstrates peer-data custom RPC messaging between a host and co-processor, including payload echoing and error handling.
      10.78 KB
    • mcu_host
      Demonstrates the peer_data custom-RPC channel, where the host sends application-defined messages and verifies echoed payloads.
      11.14 KB
  • power_save 6
    • cp 2
      • shut_down_cp_when_unused 2
        • cp
          The host holds the co-processor in reset when unused, cutting power to ~0 mA, then cold-boots it on wake-up.
          3.71 KB
        • mcu_host
          The host powers down the co-processor when unused and fully reinitializes it on wake-up, verifying leak-free cold-boot cycles.
          10.86 KB
    • host 2
      • network_split__host_deep_sleep 2
        • cp
          Network split keeps Wi-Fi alive on the coprocessor while the host enters deep sleep. The CP wakes the host when needed.
          22.65 KB
        • esp_host
          Network split lets the CP keep Wi-Fi alive while the host enters deep sleep, waking it only when needed.
          16.84 KB
    • host+cp 2
      • network_split__host_deep_sleep_cp_light_sleep 2
        • cp
          The host enters deep sleep while the coprocessor stays in light sleep; network split keeps Wi-Fi alive and wakes the host.
          30.23 KB
        • esp_host
          This example demonstrates host deep sleep and coprocessor light sleep with network-split Wi-Fi connectivity.
          25.70 KB
  • rf_cert 2
    • cp
      Drives co-processor PHY certification APIs from a host console. Supports Wi-Fi/BLE packet tests and carrier-wave tone.
      14.72 KB
    • mcu_host
      Drives co-processor PHY certification tests from a host console, including Wi-Fi and BLE packet TX/RX.
      17.08 KB
  • system 8
    • api_exerciser 2
      • cp
        A generic host+coprocessor example exposing the native eh_host_* API as console commands for functional API coverage.
        4.04 KB
      • mcu_host
        A generic host+CP example exposing the native eh_host_* API as console commands. Functional API coverage is data-driven.
        4.16 KB
    • get_cp_fw_version 2
      • cp
        A minimal ESP-Hosted smoke test that fetches the coprocessor firmware version via RPC. It exercises the complete transport stack.
        10.26 KB
      • mcu_host
        A minimal ESP-Hosted smoke test that fetches and prints the coprocessor firmware version over a single RPC round trip.
        5.72 KB
    • hosted_events 2
      • cp
        Wires ESP-IDF events to ESP-Hosted lifecycle events, enabling reaction to coprocessor state changes without polling.
        10.25 KB
      • mcu_host
        Wires the host's ESP-IDF event loop to ESP-Hosted lifecycle events. The example reconnects after coprocessor failures.
        12.57 KB
    • mcu_transport_config 2
      • cp
        This example manually configures the coprocessor bus clock and restarts the link at different speeds.
        11.19 KB
      • mcu_host
        Sets the bus clock from the application without auto-init, allowing the link to restart at different frequencies.
        13.37 KB
  • wifi 17
    • apsta 2
      • cp
        Runs Wi-Fi in AP+STA concurrent mode on the coprocessor, with the application on the host.
        10.00 KB
      • mcu_host
        Run Wi-Fi in AP + STA concurrent mode. The radio runs on the coprocessor and the application on the host.
        6.56 KB
    • dpp 2
      • cp
        Wi-Fi DPP enrollee example where a host prints a QR code and a coprocessor connects using pushed credentials.
        10.24 KB
      • mcu_host
        The host prints a QR code; a phone provisions Wi-Fi credentials, and the station joins the AP without a pre-shared PSK.
        6.54 KB
    • enterprise 2
      • cp
        Brings up a Wi-Fi station on an enterprise 802.1X/EAP network, with the radio on the coprocessor and app on the host.
        10.29 KB
      • mcu_host
        Wi-Fi station bring-up against an enterprise 802.1X/EAP access point, with the radio on a coprocessor.
        3.85 KB
    • iperf 2
      • cp
        Wi-Fi throughput benchmark using a coprocessor-hosted radio and the IDF iperf console app.
        10.28 KB
      • mcu_host
        Wi-Fi throughput benchmark using ESP-Hosted, with the host running iperf over a coprocessor's Wi-Fi radio.
        5.18 KB
    • itwt 2
      • cp
        Wi-Fi iTWT schedules periodic wake-ups, reducing power for always-connected devices. The radio runs on a coprocessor.
        10.22 KB
      • mcu_host
        This example negotiates an 802.11ax iTWT wake schedule with an AP, reducing power for connected devices.
        16.75 KB
    • scan 2
      • cp
        Scan nearby Wi-Fi access points on the coprocessor and print their details from a host application.
        10.15 KB
      • mcu_host
        Scans nearby Wi-Fi access points on the coprocessor and prints their details on the host.
        4.79 KB
    • softap 2
      • cp
        Run a Wi-Fi SoftAP with the radio on the coprocessor and the application on the host.
        10.19 KB
      • mcu_host
        Run a Wi-Fi SoftAP with the radio on the coprocessor and the application on the host.
        4.70 KB
    • sta 3
      • cp
        Connect to an AP as a Wi-Fi station with the radio on the coprocessor and the application on the host.
        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 coordinator on the host.
        4.91 KB
      • esp_host
        Runs a Zigbee Home Automation Thermostat as a host-based coordinator using an 802.15.4 radio co-processor.
        15.49 KB