uploaded 6 days ago
ESP-Hosted - Unified coprocessor connectivity

66 examples

  • bluetooth 15
    • cp 4
      • hosted_hci
        This profile enables the ESP-Hosted Bluetooth feature with VHCI path, carrying HCI frames over a Hosted transport.
        8.14 KB
      • standard_hci_uart
        This profile configures the Bluetooth controller for UART H4 mode, bypassing the ESP-Hosted bridge components.
        8.86 KB
      • wifi_hosted_hci
        This profile enables Wi-Fi + Bluetooth on CP, using Hosted VHCI for HCI frames over various transport channels.
        8.46 KB
      • wifi_standard_hci_uart
        This profile enables Wi-Fi + BT on CP and configures BT controller for UART H4 mode.
        9.02 KB
    • host_mcu 11
      • bluedroid 7
        • examples 7
          • hosted_hci 6
            • ble_advertise_minimal
              Smallest possible Bluedroid + ESP-Hosted example that starts non-connectable BLE advertising.
              9.53 KB
            • ble_compatibility_test
              BLE interoperability test app to validate BLE behavior against phones and centrals, utilizing a GATT server.
              14.63 KB
            • ble_gatt_server
              Connectable BLE peripheral with a custom 128-bit GATT service exposing read/write and notify characteristics.
              10.11 KB
            • bt_hid_mouse
              Acts as a Bluetooth Classic HID mouse that pairs with a host and sends mouse-movement reports.
              12.24 KB
            • classic_bt_discovery
              Performs a Classic Bluetooth device inquiry and prints every device detected during the discovery window.
              9.81 KB
            • controller_mac_addr
              Reads and optionally overrides the BT controller's MAC address on the co-processor before initialization.
              9.94 KB
          • standard_hci_uart 1
            • bluedroid_host_only_uart
              This example demonstrates a Bluetooth Host using UART as HCI IO, requiring a UART device to support RTS/CTS.
              7.06 KB
      • nimble 4
        • examples 4
          • hosted_hci 3
            • bleprph_gatt
              Connectable BLE peripheral exposing a custom 128-bit GATT service with two characteristics.
              9.64 KB
            • bleprph_minimal
              The smallest possible NimBLE BLE peripheral that runs the NimBLE host code on a coprocessor via ESP-Hosted.
              8.80 KB
            • bleprph_wifi_coex
              This example runs Wi-Fi and BLE concurrently on the same co-processor, allowing the host to connect to an AP and advertise a GATT server.
              27.10 KB
          • standard_hci_uart 1
            • bleprph_host_only_uart
              This example demonstrates a BLE Peripheral using a custom UART transport, requiring specific project configuration.
              14.84 KB
  • ext_coex 2
    • cp
      Configures the coprocessor's external-coex work mode for Wi-Fi/BT radio sharing with a third-party radio.
      10.42 KB
    • mcu_host
      Configures the coprocessor's external-coex work mode so the CP'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.36 KB
    • mcu_host
      Drives CP-side GPIOs from the host as if the coprocessor were a remote GPIO expander over RPC.
      3.47 KB
  • mcu_hosted_sdio_sdmmc_combined 2
    • cp
      Demonstrates running ESP-Hosted's SDIO transport on the same SDMMC controller as an external SD card.
      10.17 KB
    • mcu_host
      Demonstrates running ESP-Hosted's SDIO transport alongside an external SD card using a shared bus driver.
      10.90 KB
  • mem_monitor 2
    • cp
      Subscribes the host to periodic heap/task-stat reports from the coprocessor, useful for catching slow leaks.
      10.30 KB
    • mcu_host
      Subscribes the host to periodic heap/task-stat reports from the coprocessor to catch memory leaks and size buffers.
      11.59 KB
  • network_split 4
    • iperf 2
      • cp
        This example implements a network split using iperf3 to measure throughput, where Wi-Fi operates on a coprocessor and the host runs its own TCP/IP stack.
        23.60 KB
      • mcu_host
        This example uses iperf3 to measure end-to-end throughput for Wi-Fi running on a coprocessor while the host operates its own TCP/IP stack.
        35.26 KB
    • station 2
      • cp
        Bare-bones Wi-Fi station with a network-split backend for coprocessors, allowing shared IP and port separation.
        23.22 KB
      • mcu_host
        Bare-bones Wi-Fi station with network-split netif backend, sharing one IP between host and co-processor.
        30.43 KB
  • openthread 4
    • border_router 2
      • cp
        OpenThread Border Router integrates an ESP-Hosted co-processor for 802.15.4 radio and Wi-Fi backhaul, enabling full OT BR stack functionality.
        4.78 KB
      • esp_host
        OpenThread Border Router drives an ESP-Hosted co-processor providing 802.15.4 and Wi-Fi connectivity for networking.
        7.87 KB
    • cli 2
      • cp
        Runs a full OpenThread CLI on a host, controlling the 802.15.4 Radio Co-Processor via a dedicated UART.
        4.22 KB
      • esp_host
        Runs a full OpenThread CLI on the host, controlling the Radio Co-Processor lifecycle via ESP-Hosted.
        6.83 KB
  • ota 2
    • coprocessor_ota 2
      • cp
        This example enables pushing new firmware images to a coprocessor via OTA RPC calls using various transport methods.
        10.43 KB
      • mcu_host
        Pushes new coprocessor firmware from the host through the OTA RPC chain using various sources like HTTPS or LittleFS.
        35.69 KB
  • peer_data_transfer 2
    • cp
      Demonstrates the peer_data custom-RPC channel where the host sends and verifies application-defined messages.
      10.77 KB
    • mcu_host
      Demonstrates the peer_data custom-RPC channel where the host sends and verifies application-defined messages.
      11.12 KB
  • power_save 6
    • cp 2
      • shut_down_cp_when_unused 2
    • host 2
      • network_split__host_deep_sleep 2
        • cp
          Network split allows the coprocessor to maintain Wi-Fi while the host sleeps, waking it only for specific packets.
          22.49 KB
        • esp_host
          Network split allows the co-processor to keep Wi-Fi alive while the host enters deep sleep, minimizing idle current.
          16.84 KB
    • host+cp 2
      • network_split__host_deep_sleep_cp_light_sleep 2
        • cp
          This example demonstrates a coprocessor setup where the host is in deep sleep and the coprocessor is in light sleep, keeping Wi-Fi alive.
          28.48 KB
        • esp_host
          This project enables both the host in deep sleep and the coprocessor in light sleep, maintaining Wi-Fi connectivity.
          16.78 KB
  • system 8
    • api_exerciser 2
      • cp
        3.19 KB
      • mcu_host
        A generic host+CP example that exposes the native `eh_host_*` API as console commands for functional API coverage.
        3.79 KB
    • get_cp_fw_version 2
      • cp
        The smallest end-to-end ESP-Hosted scenario fetches the coprocessor firmware version via an RPC call. It is a basic transport-health test that confirms the link is operational.
        10.26 KB
      • mcu_host
        The smallest end-to-end ESP-Hosted scenario fetches the co-processor firmware version via an RPC request and is used 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, allowing user applications to react to coprocessor state changes.
        10.25 KB
      • mcu_host
        Wires the host's ESP-IDF event loop to ESP-Hosted's lifecycle events for reacting to coprocessor state changes.
        12.57 KB
    • mcu_transport_config 2
      • cp
        Configures the host-side transport programmatically at runtime before esp_hosted_init(). This example shows how to override Kconfig defaults in code.
        10.15 KB
      • mcu_host
        This example configures the host-side transport programmatically at runtime before esp_hosted_init(). It allows overriding default Kconfig settings to match application needs.
        7.08 KB
  • wifi 17
    • apsta 2
      • cp
        Run Wi-Fi in AP + STA concurrent mode, connecting to an upstream AP while serving a SoftAP on the coprocessor.
        10.02 KB
      • mcu_host
        Run Wi-Fi in AP + STA concurrent mode, connecting to an upstream AP while serving a SoftAP.
        6.56 KB
    • dpp 2
      • cp
        Wi-Fi Easy-Connect (DPP) enrollee allows a host MCU to print a QR code for Wi-Fi credentials provisioning to a configurator device.
        10.24 KB
      • mcu_host
        Wi-Fi Easy-Connect (DPP) enrollee allows a host MCU to print a QR code for Wi-Fi credential provisioning.
        6.54 KB
    • enterprise 2
      • cp
        Wi-Fi station bring-up against an enterprise (802.1X / EAP) AP, running on a coprocessor with host application support.
        10.29 KB
      • mcu_host
        This example demonstrates Wi-Fi station bring-up against an enterprise 802.1X/EAP AP, utilizing mbedTLS and wpa_supplicant.
        3.85 KB
    • iperf 2
      • cp
        Wi-Fi throughput benchmark that measures end-to-end throughput using iperf over a coprocessor network.
        10.30 KB
      • mcu_host
        Wi-Fi throughput benchmark using coprocessor with upstream IDF app to measure end-to-end throughput.
        5.18 KB
    • itwt 2
      • cp
        Wi-Fi iTWT is a feature of 802.11ax enabling devices to negotiate a wake schedule with the AP, reducing power consumption.
        10.24 KB
      • mcu_host
        Wi-Fi iTWT allows the station to negotiate a periodic wake schedule with the AP, reducing power consumption for connected devices.
        16.71 KB
    • scan 2
      • cp
        Scan for nearby Wi-Fi access points and print SSID, RSSI, channel, and auth mode for each.
        10.18 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 on the coprocessor while the application runs on the host, allowing clients to associate and obtain an IP.
        10.22 KB
      • mcu_host
        Run a Wi-Fi SoftAP with the coprocessor's radio and host's application, auto-spawning a DHCP server for clients.
        4.70 KB
    • sta 3
      • cp
        Connect to an AP as a Wi-Fi station using a coprocessor for radio and a host for the application.
        10.27 KB
      • cp_streaming
        8.91 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