espressif/esp_hosted

3.1.0

Latest
uploaded 1 day ago
ESP-Hosted - Unified coprocessor connectivity
Readme Dependencies 5 Dependents 14 Examples 83 Versions 125

83 examples

  • bluetooth 25
    • bluedroid_uart 2
      • bluedroid_host_only_uart 2
        • cp
          Discovers Classic Bluetooth (BR/EDR) devices and services via Bluedroid over a dedicated H4 UART.
          10.56 KB
        • mcu_host
          Classic Bluetooth device and service discovery using Bluedroid over a dedicated HCI UART with a remote controller.
          8.66 KB
    • esp_hosted_bluedroid 12
      • ble_advertise_minimal 2
        • cp
          This example runs Bluedroid on a host and provides non-connectable BLE advertising through an ESP-Hosted co-processor.
          9.41 KB
        • mcu_host
          Minimal Bluedroid example using ESP-Hosted HCI to start non-connectable BLE advertising on a co-processor.
          5.00 KB
      • ble_compatibility_test 2
        • cp
          BLE compatibility test app exercises GATT characteristics, MTU sizes, notifications, and connection parameters.
          9.58 KB
        • mcu_host
          BLE interoperability test app exercising GATT characteristics, MTU sizes, notifications, and connection parameters.
          10.42 KB
      • ble_gatt_server 2
        • cp
          BLE GATT server with read/write and notify characteristics using Bluedroid over an ESP-Hosted co-processor.
          9.43 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
          Bluetooth Classic HID mouse that pairs with hosts and sends mouse-movement reports via an ESP-Hosted co-processor.
          9.75 KB
        • mcu_host
          Acts as a Bluetooth Classic HID mouse, pairing with hosts and sending mouse-movement reports.
          8.25 KB
      • classic_bt_discovery 2
        • cp
          Performs a Classic Bluetooth (BR/EDR) device inquiry and prints every device the controller sees during discovery.
          9.72 KB
        • mcu_host
          Performs Classic Bluetooth device inquiry and prints every device seen during discovery.
          5.84 KB
      • controller_mac_addr 2
        • cp
          Reads or overrides the co-processor BT controller MAC address before initialization, then advertises as a BLE beacon.
          9.40 KB
        • mcu_host
          Reads or overrides the BT controller MAC before initialization, then advertises as a BLE beacon using Bluedroid over hosted HCI.
          5.61 KB
    • esp_hosted_custom 2
      • hci_demo 2
        • cp
          This example drives the ESP-Hosted coprocessor's Bluetooth controller through a custom raw-HCI path.
          9.25 KB
        • mcu_host
          A bring-your-own BT stack example using a custom raw-HCI handler over ESP-Hosted. It demonstrates an HCI Reset round-trip.
          3.92 KB
    • esp_hosted_nimble 6
      • bleprph_gatt 2
        • cp
          A BLE peripheral exposes a custom GATT service with read/write and notify characteristics. NimBLE runs on the host.
          9.47 KB
        • mcu_host
          A connectable BLE peripheral exposes a custom GATT service with read/write and notify characteristics.
          5.45 KB
      • bleprph_minimal 2
        • cp
          Minimal NimBLE BLE peripheral using an ESP-Hosted co-processor controller and standard NimBLE host code.
          9.46 KB
        • mcu_host
          This example runs a minimal NimBLE BLE peripheral host on an ESP-Hosted co-processor controller over HCI.
          4.63 KB
      • bleprph_wifi_coex 2
        • cp
          Runs Wi-Fi and BLE concurrently on the same co-processor, with the host pinging an AP and advertising a GATT server.
          9.89 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 using a dedicated UART-H4 link to an external Bluetooth controller.
          11.27 KB
        • cp_wifi
          NimBLE host-only BLE peripheral communicating with an external Bluetooth controller over a dedicated UART H4 link.
          11.04 KB
        • mcu_host
          NimBLE host-only BLE peripheral that communicates with an external Bluetooth controller over a dedicated H4 UART.
          18.31 KB
  • ext_coex 2
    • cp
      Configures external coexistence so the coprocessor’s Wi-Fi/BT radio can share the air with a nearby third-party radio.
      10.52 KB
    • mcu_host
      Configures external coexistence (PTA) so the coprocessor’s Wi-Fi/BT radio can share the air with a third-party radio.
      5.02 KB
  • gpio_expander 2
    • cp
      Drives coprocessor GPIOs remotely from the host over RPC, acting as a GPIO expander.
      10.44 KB
    • mcu_host
      Drives co-processor GPIOs remotely from the host over RPC, acting as a remote GPIO expander.
      3.56 KB
  • mcu_hosted_sdio_sdmmc_combined 2
    • cp
      Demonstrates ESP-Hosted SDIO sharing an SDMMC controller with an external SD card on separate slots.
      10.22 KB
    • mcu_host
      Demonstrates ESP-Hosted SDIO and an external SD card sharing one SDMMC controller. It tests Wi-Fi during filesystem I/O.
      10.96 KB
  • mem_monitor 2
    • cp
      Subscribes the host to periodic heap/task-stat reports from the coprocessor. Useful for catching leaks and sizing buffers.
      10.34 KB
    • mcu_host
      Subscribes the host to periodic heap/task-stat reports from the coprocessor, useful for catching leaks and sizing buffers.
      11.69 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.85 KB
      • mcu_host
        This example uses network split to run iperf3 and measure end-to-end throughput.
        36.50 KB
    • station 2
      • cp
        Bare-bones Wi-Fi station with network-split backend. Wi-Fi runs on the coprocessor and TCP/IP on the host.
        23.47 KB
      • mcu_host
        Bare-bones Wi-Fi station with the network-split netif backend wired in.
        30.68 KB
  • openthread 7
    • rcp_on_hosted_cp 4
      • border_router 2
        • cp
          A host-based Thread Border Router connects a Thread mesh to Wi-Fi through an ESP-Hosted co-processor.
          7.03 KB
        • esp_host
          A Thread Border Router on the host connects a Thread mesh to your Wi-Fi network using an ESP-Hosted co-processor.
          8.08 KB
      • cli 2
        • cp
          Runs the OpenThread CLI on a host using an ESP-Hosted co-processor as the 802.15.4 radio.
          6.75 KB
        • esp_host
          Runs OpenThread CLI on the host using an ESP-Hosted co-processor as the 802.15.4 radio.
          7.54 KB
    • rcp_separate_chip 3
      • border_router 3
        • cp
          A three-chip Thread Border Router separates the host, Wi-Fi/BLE co-processor, and 802.15.4 radio co-processor.
          9.63 KB
        • cp_rcp
          A three-chip Thread Border Router uses separate host, Wi-Fi/BLE, and Thread radio chips.
          9.20 KB
        • esp_host
          A three-chip Thread Border Router uses a host for networking, a co-processor for Wi-Fi/BLE, and an RCP for Thread.
          20.12 KB
  • ota 2
    • coprocessor_ota 2
      • cp
        Pushes a new CP firmware image from the host through the OTA begin/write/end/activate RPC chain.
        10.51 KB
      • mcu_host
        Pushes a new coprocessor firmware image from the host using the OTA begin/write/end/activate RPC chain.
        35.94 KB
  • peer_data_transfer 2
    • cp
      Demonstrates peer_data custom-RPC messaging, echoing application-defined payloads and verifying round trips.
      10.71 KB
    • mcu_host
      Demonstrates peer_data custom-RPC messaging between host and coprocessor, including echo verification and error handling.
      11.24 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. Each wake-up performs a full cold boot.
          3.75 KB
        • mcu_host
          The host powers down the co-processor when unused and cold-boots it on wake-up, resuming Wi-Fi. Heap tracing checks leaks.
          10.91 KB
    • host 2
      • network_split__host_deep_sleep 2
        • cp
          Network split lets the CP keep Wi-Fi alive while the host enters deep sleep, waking it only when needed.
          22.73 KB
        • esp_host
          Network split keeps Wi-Fi alive while the host enters deep sleep. The CP wakes it only when needed.
          16.93 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, keeping Wi-Fi alive via network split.
          30.31 KB
        • esp_host
          The host enters deep sleep while the coprocessor stays in light sleep, with network split keeping Wi-Fi active.
          25.78 KB
  • rf_cert 2
    • cp
      Drives co-processor PHY certification APIs from a host console for Wi-Fi and BLE TX, RX, and carrier-wave tests.
      14.79 KB
    • mcu_host
      Drives co-processor PHY certification APIs from a host console, supporting Wi-Fi/BLE TX/RX and carrier-wave tone.
      17.16 KB
  • system 8
    • api_exerciser 2
      • cp
        A generic host+CP example exposing the native eh_host_* API as console commands for data-driven functional coverage.
        4.80 KB
      • mcu_host
        A generic host+CP example exposing the native eh_host_* API as console commands. Functional coverage is data-driven.
        4.79 KB
    • get_cp_fw_version 2
      • cp
        Smallest end-to-end ESP-Hosted scenario for fetching the coprocessor firmware version via a single RPC round-trip.
        10.36 KB
      • mcu_host
        A minimal ESP-Hosted bring-up test that fetches the coprocessor firmware version via one RPC round trip.
        5.82 KB
    • hosted_events 2
      • cp
        Wires ESP-IDF events to ESP-Hosted lifecycle changes without polling. Reconnects after coprocessor failures.
        10.35 KB
      • mcu_host
        Wires ESP-IDF events to ESP-Hosted lifecycle changes, enabling recovery when the coprocessor reboots or hangs.
        12.67 KB
    • mcu_transport_config 2
      • cp
        Configures coprocessor bus settings from the application, allowing link restart at a different clock.
        11.29 KB
      • mcu_host
        Sets the bus clock from the application without auto-init and supports restarting the link at another speed.
        13.47 KB
  • wifi 17
    • apsta 2
      • cp
        Runs Wi-Fi in AP + STA concurrent mode on a coprocessor, connecting upstream while serving a SoftAP to host applications.
        10.10 KB
      • mcu_host
        This example runs Wi-Fi in AP + STA concurrent mode, with the radio on the coprocessor and application on the host.
        6.66 KB
    • dpp 2
      • cp
        A host prints a QR code, receives Wi-Fi credentials, and joins an AP via DPP. The radio runs on a coprocessor.
        10.33 KB
      • mcu_host
        Wi-Fi Easy-Connect DPP enrollee where the host prints a QR code and receives credentials from a configurator.
        6.64 KB
    • enterprise 2
      • cp
        Brings up Wi-Fi station mode against enterprise (802.1X/EAP) access points using a coprocessor and host.
        10.39 KB
      • mcu_host
        This example brings up enterprise Wi-Fi with host-configured 802.1X/EAP authentication and a coprocessor-hosted radio.
        3.95 KB
    • iperf 2
      • cp
        Wi-Fi throughput benchmark with the radio on the coprocessor and iperf driven from the host console.
        11.32 KB
      • mcu_host
        Wi-Fi throughput benchmark using ESP-Hosted, with Wi-Fi on a coprocessor and iperf on the host.
        5.63 KB
    • itwt 2
      • cp
        This example demonstrates 802.11ax individual Target Wake Time on a Wi-Fi coprocessor and host.
        10.22 KB
      • mcu_host
        802.11ax iTWT negotiates periodic wake schedules with an AP, reducing power by sleeping between wake-ups.
        16.75 KB
    • scan 2
      • cp
        Scan nearby Wi-Fi access points and print SSID, RSSI, channel, and auth mode. The radio runs on the coprocessor.
        10.25 KB
      • mcu_host
        Scan nearby Wi-Fi access points and print SSID, RSSI, channel, and auth mode, with radio on the coprocessor.
        4.89 KB
    • softap 2
      • cp
        Run a Wi-Fi SoftAP with the radio on the coprocessor and the application on the host. Clients receive IP addresses.
        10.28 KB
      • mcu_host
        Run a Wi-Fi SoftAP on the coprocessor's radio with the application on the host.
        4.80 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.37 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.38 KB
      • mcu_host
        Connect to an access point as a Wi-Fi station, with the radio on the coprocessor and the application on the host.
        6.81 KB
  • zigbee 2
    • thermostat 2
      • cp
        Runs a Zigbee Home Automation Thermostat coordinator using an 802.15.4 radio co-processor.
        6.25 KB
      • esp_host
        Runs a Zigbee Home Automation Thermostat (a Zigbee Coordinator) on the host.
        14.67 KB