espressif/esp_hosted

3.0.8

Latest
uploaded 3 hours ago
ESP-Hosted - Unified coprocessor connectivity
Readme Dependencies 1 Dependents 12 Examples 78 Versions 120

78 examples

  • bluetooth 25
    • bluedroid_uart 2
      • bluedroid_host_only_uart 2
        • cp
          Classic Bluetooth device and service discovery with Bluedroid over a dedicated H4 UART to a co-processor.
          9.94 KB
        • mcu_host
          Classic Bluetooth device and service discovery runs on a host MCU using Bluedroid over a dedicated H4 UART.
          7.70 KB
    • esp_hosted_bluedroid 12
      • ble_advertise_minimal 2
        • cp
          This minimal example runs Bluedroid on the host and a Bluetooth controller on an ESP-Hosted coprocessor.
          9.41 KB
        • mcu_host
          Minimal Bluedroid + ESP-Hosted example that starts non-connectable BLE advertising.
          4.99 KB
      • ble_compatibility_test 2
        • cp
          BLE compatibility test app with a GATT server tests characteristics, MTU sizes, notifications, and connection parameters.
          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 a custom 128-bit GATT service. Bluedroid runs over hosted HCI on a coprocessor.
          9.42 KB
        • mcu_host
          A connectable BLE peripheral exposes a custom GATT service with read/write and notify characteristics.
          5.98 KB
      • bt_hid_mouse 2
        • cp
          A Bluetooth Classic HID mouse pairs with a host and sends mouse-movement reports via an ESP-Hosted co-processor.
          9.53 KB
        • mcu_host
          Acts as a Bluetooth Classic HID mouse that pairs with a host and sends mouse-movement reports over ESP-Hosted.
          7.87 KB
      • classic_bt_discovery 2
        • cp
          Performs Classic Bluetooth (BR/EDR) discovery and prints every device found by the controller.
          9.50 KB
        • mcu_host
          Performs a Classic Bluetooth (BR/EDR) device inquiry and prints every device the controller sees during discovery.
          5.61 KB
      • controller_mac_addr 2
        • cp
          Reads or overrides the BT controller MAC before initialization, starts Bluedroid over hosted HCI, and advertises as a BLE beacon.
          9.39 KB
        • mcu_host
          Reads or overrides the co-processor BT MAC before initialization. Starts Bluedroid over hosted HCI as Bluedroid_Beacon.
          5.61 KB
    • esp_hosted_custom 2
    • esp_hosted_nimble 6
      • bleprph_gatt 2
        • cp
          This example exposes a custom BLE GATT service using NimBLE on the host and an ESP-Hosted coprocessor controller.
          9.47 KB
        • mcu_host
          A BLE peripheral exposes a custom GATT service with read/write and notify characteristics over ESP-Hosted HCI.
          5.45 KB
      • bleprph_minimal 2
        • cp
          This example runs a minimal NimBLE BLE peripheral host with the controller on an ESP-Hosted co-processor.
          9.46 KB
        • mcu_host
          Minimal NimBLE BLE peripheral with its controller on an ESP-Hosted co-processor. Uses hosted HCI for connectable advertising.
          4.63 KB
      • bleprph_wifi_coex 2
        • cp
          Wi-Fi and BLE run concurrently on the same co-processor, while the host pings a target and advertises a GATT server.
          9.88 KB
        • mcu_host
          Wi-Fi STA and BLE peripheral run concurrently on a co-processor using hosted HCI.
          22.75 KB
    • nimble_uart 3
      • bleprph_host_only_uart 3
        • cp
          NimBLE host-only BLE peripheral communicating with an external Bluetooth controller over a dedicated UART H4 link.
          11.04 KB
        • cp_wifi
          NimBLE host-only BLE peripheral communicating with an external Bluetooth controller over a dedicated HCI UART (H4).
          10.82 KB
        • mcu_host
          NimBLE host-only BLE peripheral that communicates with an external Bluetooth controller over a dedicated HCI UART.
          17.82 KB
  • ext_coex 2
    • cp
      Configures the coprocessor's external-coex (PTA) mode and grant pins to share airspace with a third-party radio.
      10.42 KB
    • mcu_host
      Configures external coexistence so the coprocessor’s Wi-Fi/BT radio can share 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.
      10.35 KB
    • mcu_host
      Drives coprocessor GPIOs remotely from the host as a GPIO expander. Calls are sent over RPC.
      3.47 KB
  • mcu_hosted_sdio_sdmmc_combined 2
    • cp
      Demonstrates ESP-Hosted SDIO and an external SD card sharing one SDMMC controller on separate slots.
      10.17 KB
    • mcu_host
      Demonstrates ESP-Hosted SDIO and an external SD card sharing an SDMMC controller on separate slots.
      10.90 KB
  • mem_monitor 2
    • cp
      Reports coprocessor heap and task statistics periodically to the host for leak detection and buffer sizing.
      10.25 KB
    • mcu_host
      Monitors coprocessor heap and task statistics at configurable intervals. Logs all reports or only low-memory events.
      11.59 KB
  • network_split 4
    • iperf 2
      • cp
        This example uses iperf3 to measure end-to-end throughput with Wi-Fi on the coprocessor and TCP/IP on the host.
        23.75 KB
      • mcu_host
        This example uses iperf3 to measure end-to-end throughput with Wi-Fi on the coprocessor and TCP/IP on the host.
        35.41 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 using the network-split backend. Host and coprocessor share one IP with split port ranges.
        30.58 KB
  • openthread 4
    • border_router 2
      • cp
        OpenThread Border Router on the host uses one ESP-Hosted co-processor for Wi-Fi and 802.15.4.
        5.04 KB
      • esp_host
        Runs an OpenThread Border Router on the host with one ESP-Hosted co-processor providing Wi-Fi and 802.15.4.
        8.13 KB
    • cli 2
      • cp
        Runs a full OpenThread CLI on the host. The coprocessor provides ESP-Hosted control and 802.15.4 RCP radio roles.
        4.78 KB
      • esp_host
        Runs a full OpenThread CLI on the host using an ESP32-C6 Radio Co-Processor over ESP-Hosted and dedicated UART.
        7.12 KB
  • ota 2
    • coprocessor_ota 2
      • cp
        Pushes a new coprocessor firmware image through the OTA begin/write/end/activate RPC chain.
        10.42 KB
      • mcu_host
        Pushes a new CP firmware image from the host through the OTA begin, write, end, and activate RPC chain.
        35.69 KB
  • peer_data_transfer 2
    • cp
      Demonstrates the peer_data custom-RPC channel, echoing application-defined messages and verifying payload integrity.
      10.78 KB
    • mcu_host
      Demonstrates peer_data custom-RPC messaging, echoed responses, payload verification, and graceful rejection of invalid IDs.
      11.14 KB
  • power_save 6
    • cp 2
      • shut_down_cp_when_unused 2
        • cp
          The host powers down the co-processor when unused and cold-boots it on wake-up. Heap tracing verifies no leaks.
          3.71 KB
        • mcu_host
          The host powers down the co-processor when unused and reinitializes networking on wake-up. Heap tracing checks for leaks.
          10.85 KB
    • host 2
      • network_split__host_deep_sleep 2
        • cp
          Network split keeps Wi-Fi alive on the CP while the host enters deep sleep. The CP wakes the host only when needed.
          22.65 KB
        • esp_host
          Network split keeps Wi-Fi alive while the host enters deep sleep and wakes 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 enters light sleep. Wi-Fi stays alive on the coprocessor.
          30.23 KB
        • esp_host
          The host enters deep sleep while the CP enters light sleep. Network split keeps Wi-Fi alive on the CP.
          25.70 KB
  • system 8
    • api_exerciser 2
      • cp
        3.19 KB
      • mcu_host
        A generic host+CP example exposing the native eh_host_* API as console commands. API coverage is added as test data.
        3.79 KB
    • get_cp_fw_version 2
      • cp
        This smoke test brings up ESP-Hosted, opens a coprocessor transport, fetches its firmware version, and exits.
        10.26 KB
      • mcu_host
        The simplest control-path round trip: a single RPC request and response, serving as the transport-health gate.
        5.72 KB
    • hosted_events 2
      • cp
        Wires the host's event loop to ESP-Hosted lifecycle events, enabling applications to react to coprocessor changes.
        10.25 KB
      • mcu_host
        Connects ESP-IDF to ESP-Hosted lifecycle events, letting applications react to coprocessor changes without polling.
        12.57 KB
    • mcu_transport_config 2
      • cp
        Configures host-side SDIO, SPI, or UART transport at runtime before esp_hosted_init().
        10.15 KB
      • mcu_host
        Configures MCU host transport at runtime before esp_hosted_init(). Supports SDIO, full/half-duplex SPI, and UART.
        7.08 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
        Runs Wi-Fi in AP + STA mode, connecting upstream while serving a SoftAP; radio is on the coprocessor, app on the host.
        6.56 KB
    • dpp 2
      • cp
        This example implements Wi-Fi Easy-Connect DPP enrolment. The host prints a QR code and the coprocessor joins Wi-Fi.
        10.24 KB
      • mcu_host
        Wi-Fi DPP enrollee lets a host print a QR code, receive credentials, and join an access point.
        6.54 KB
    • enterprise 2
      • cp
        Brings up an enterprise 802.1X/EAP Wi-Fi station with the radio on the coprocessor and application on the host.
        10.29 KB
      • mcu_host
        Brings up a Wi-Fi station against an enterprise 802.1X/EAP AP, with radio on the coprocessor and the host application.
        3.85 KB
    • iperf 2
      • cp
        Wi-Fi throughput benchmark using a coprocessor-hosted radio and the IDF iperf console app over ESP-Hosted.
        10.28 KB
      • mcu_host
        Wi-Fi throughput benchmark using a host iperf console and coprocessor-hosted Wi-Fi over ESP-Hosted.
        5.18 KB
    • itwt 2
      • cp
        Wi-Fi 6 iTWT negotiates periodic wake schedules with an AP to reduce power. The radio runs on a coprocessor.
        10.22 KB
      • mcu_host
        This example negotiates periodic Wi-Fi 6 wake schedules with an AP, reducing power for always-connected devices.
        16.75 KB
    • scan 2
      • cp
        Scans nearby Wi-Fi access points, with the radio on the coprocessor and application on the host.
        10.15 KB
      • mcu_host
        Scan nearby Wi-Fi access points and print SSID, RSSI, channel, and auth mode from the host, using a coprocessor radio.
        4.79 KB
    • softap 2
      • cp
        Runs a Wi-Fi SoftAP on the coprocessor while the application runs on the host; clients receive IP addresses automatically.
        10.19 KB
      • mcu_host
        This example runs 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. Uses an ESP32-C6 802.15.4 RCP coprocessor.
        4.91 KB
      • esp_host
        Runs a Zigbee Home Automation Thermostat (Zigbee Coordinator) on the host using an 802.15.4 Radio Co-Processor.
        15.43 KB