espressif/esp_hosted

78 examples

• bluetooth 25
  • bluedroid_uart 2
    • bluedroid_host_only_uart 2
      • cp

        Classic Bluetooth device and service discovery with the Bluedroid host stack running on an MCU, using UART H4 mode.

        9.94 KB
      • mcu_host

        Classic Bluetooth (BR/EDR) device and service discovery using the Bluedroid host stack on an MCU with UART H4 mode.

        7.70 KB
  • esp_hosted_bluedroid 12
    • ble_advertise_minimal 2
      • cp

        Smallest Bluedroid + ESP-Hosted example that sets up the BT controller on a co-processor for BLE advertising.

        9.41 KB
      • mcu_host

        This example demonstrates the smallest possible Bluedroid setup on ESP-Hosted, utilizing the BT controller and enabling non-connectable BLE advertising.

        4.99 KB
    • ble_compatibility_test 2
      • cp

        BLE interoperability test app using a GATT server to validate BLE behavior against phones and centrals.

        9.45 KB
      • mcu_host

        BLE interoperability test app that validates behavior against phones and centrals using a GATT server.

        10.29 KB
    • ble_gatt_server 2
      • cp

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

        9.42 KB
      • mcu_host

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

        5.98 KB
    • bt_hid_mouse 2
      • cp

        Acts as a Bluetooth Classic HID mouse, pairing with host devices to send 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 inquiry and prints detected devices during discovery, requiring an ESP32 co-processor.

        9.50 KB
      • mcu_host

        Performs a Classic Bluetooth device inquiry and prints discovered devices using Bluedroid on a host stack.

        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 Bluedroid over hosted HCI.

        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, implemented with NimBLE over a Bluetooth controller coprocessor.

        9.47 KB
      • mcu_host

        This example demonstrates a connectable BLE peripheral using NimBLE over a hosted HCI, exposing a custom GATT service.

        5.45 KB
    • bleprph_minimal 2
      • cp

        The smallest possible NimBLE BLE peripheral boots the BLE controller on the ESP-Hosted co-processor to run NimBLE host code.

        9.46 KB
      • mcu_host

        The smallest possible NimBLE BLE peripheral using the ESP-Hosted co-processor, running standard NimBLE host code.

        4.63 KB
    • bleprph_wifi_coex 2
      • cp

        This example enables concurrent Wi-Fi and BLE operation on the same co-processor, allowing the host to connect to an AP while advertising a GATT server.

        9.88 KB
      • mcu_host

        This example enables Wi-Fi STA and BLE peripheral to run concurrently on the same co-processor, connecting to an AP while simultaneously advertising a GATT server.

        22.60 KB
  • nimble_uart 3
    • bleprph_host_only_uart 3
      • cp

        NimBLE host-only BLE peripheral that communicates via HCI over dedicated UART with a standalone co-processor, eliminating the ESP-Hosted VHCI bridge.

        11.04 KB
      • cp_wifi

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

        10.82 KB
      • mcu_host

        NimBLE host-only BLE peripheral using HCI over dedicated UART to an external BT controller, enabling a standalone link without ESP-Hosted bus.

        17.82 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 to allow Wi-Fi / BT radio sharing 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, useful when the host runs out of pins.

    10.35 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 while managing Wi-Fi connections.

    10.17 KB
  • mcu_host

    Demonstrates running ESP-Hosted's SDIO transport alongside an external SD card on the same SDMMC controller.

    10.90 KB
• mem_monitor 2
  • cp

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

    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 uses iperf3 to measure end-to-end throughput with a network split between a coprocessor and host running separate TCP/IP stacks.

      23.60 KB
    • mcu_host

      This example uses iperf3 to measure end-to-end throughput in a setup where Wi-Fi runs on the coprocessor.

      35.26 KB
  • station 2
    • cp

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

      23.22 KB
    • mcu_host

      Bare-bones Wi-Fi station with the network-split netif backend wired in for minimal connectivity validation.

      30.43 KB
• openthread 4
  • border_router 2
    • cp

      OpenThread Border Router integrates an ESP-Hosted co-processor, managing both 802.15.4 Radio Co-Processor and Wi-Fi backhaul functionality.

      5.04 KB
    • esp_host

      OpenThread Border Router operates on a host managing a single ESP-Hosted co-processor for Wi-Fi and 802.15.4. It supports various platforms and connection buses, facilitating communication between Thread and Wi-Fi.

      8.13 KB
  • cli 2
    • cp

      Runs a full OpenThread CLI on the host using an 802.15.4 Radio Co-Processor (RCP) for communication.

      4.78 KB
    • esp_host

      Runs a full OpenThread CLI on the host, utilizing a 802.15.4 Radio Co-Processor and exchanging traffic over a dedicated UART.

      7.12 KB
• ota 2
  • coprocessor_ota 2
    • cp

      Pushes a new CP firmware image from the host through the OTA RPC chain, sourcing the image from HTTPS, LittleFS, or raw flash.

      10.42 KB
    • mcu_host

      Pushes a new CP firmware image from the host through the OTA RPC chain. The host can source the image from HTTPS, LittleFS, or a raw flash partition.

      35.69 KB
• peer_data_transfer 2
  • cp

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

    10.77 KB
  • mcu_host

    Demonstrates a custom-RPC channel where the host sends and receives application-defined messages with various sizes.

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

        This example shows how to shut down the co-processor when unused, power-cycling it through the host.

        3.71 KB
      • mcu_host

        The host manages the co-processor by holding it in reset when not in use, performing a cold-boot on wake-up.

        10.85 KB
  • host 2
    • network_split__host_deep_sleep 2
      • cp

        Network split allows the coprocessor to maintain Wi-Fi while the host enters deep sleep, minimizing power usage.

        22.49 KB
      • esp_host

        Network split enables the co-processor to maintain Wi-Fi while the host enters deep sleep, waking it only when necessary.

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

        This example demonstrates host deep sleep with the coprocessor in light sleep, maintaining network connections through a split. The setup enables power-saving features while the host is asleep.

        30.07 KB
      • esp_host

        This project enables simultaneous sleep modes for the host and coprocessor, ensuring network connectivity while conserving power.

        25.64 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 for functional API coverage.

      3.79 KB
  • get_cp_fw_version 2
    • cp

      The smallest end-to-end ESP-Hosted scenario fetching the coprocessor firmware version via an RPC call.

      10.26 KB
    • mcu_host

      The smallest end-to-end ESP-Hosted scenario fetches the coprocessor's firmware version and serves as a smoke test.

      5.63 KB
  • hosted_events 2
    • cp

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

      10.25 KB
    • mcu_host

      Wires the host's ESP-IDF event loop to ESP-Hosted's lifecycle events for reaction 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

      Configures the host-side transport programmatically at runtime, allowing customization before initialization.

      7.08 KB
• wifi 17
  • apsta 2
    • cp

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

      10.00 KB
    • mcu_host

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

      6.56 KB
  • dpp 2
    • cp

      Wi-Fi Easy-Connect enrollee enables a host MCU to print a QR code for Wi-Fi credential sharing with 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 allows clients to authenticate using certificates or per-user credentials.

      10.29 KB
    • mcu_host

      Wi-Fi station bring-up against an enterprise (802.1X / EAP) AP, enabling client authentication with certificates or credentials.

      3.85 KB
  • iperf 2
    • cp

      Wi-Fi throughput benchmark utilizing a coprocessor to run the Wi-Fi radio, while the host measures end-to-end throughput.

      10.28 KB
    • mcu_host

      Wi-Fi iperf benchmarks Wi-Fi throughput using a host IDF console app that communicates with a coprocessor for TCP/UDP tests.

      5.18 KB
  • itwt 2
    • cp

      Wi-Fi iTWT allows devices to negotiate a periodic wake schedule, reducing power consumption for always-connected devices.

      10.22 KB
    • mcu_host

      Wi-Fi iTWT enables periodic wake scheduling for power savings in always-connected devices, using a Wi-Fi 6 coprocessor.

      16.71 KB
  • scan 2
    • cp

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

      10.15 KB
    • mcu_host

      Scan for nearby Wi-Fi access points and print relevant details like SSID and RSSI. This example serves as a smoke test for the radio link.

      4.79 KB
  • softap 2
    • cp

      Run a Wi-Fi SoftAP on the coprocessor with the application on the host, spawning a DHCP server for client STAs.

      10.19 KB
    • mcu_host

      Run a Wi-Fi SoftAP on the co-processor's radio with automatic DHCP for client STAs on 192.168.4.1.

      4.70 KB
  • sta 3
    • cp

      Connect to an AP as a Wi-Fi station with the coprocessor handling the radio while the host runs the application.

      10.27 KB
    • cp_streaming

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

      10.28 KB
    • mcu_host

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

      6.41 KB
• zigbee 2
  • thermostat 2
    • cp

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

      4.91 KB
    • esp_host

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

      15.40 KB