If you are connecting to a new device, follow the steps below. Otherwise click the Reconnect button.
Web Bluetooth is currently only supported in Chromium-based browsers.
On Linux only with older versions of Google Chrome, enable the experimental about://flags/#enable-experimental-web-platform-features flag. However be careful as it would be risky to browse the web with this flag turned on as it enables many other experimental web platform features. Starting with Chromium version 100, enable the about://flags/#enable-web-bluetooth safer flag instead. You can also enable Web Bluetooth Binding by enabling the about://flags/#enable-web-bluetooth-new-permissions-backend flag instead of the experimental features if it is available.
See the online documentation for platform specific notes on how to use Bluetooth. Note that CircuitPython boards with nrf chips need CircuitPython 7.0.0 or newer.
The first time a device is connected to your host, you'll need to enable public broadcasting by pressing reset (or bootsel on some devices) when the faster, blue blink is happening on start up. The device will reset and the second, blue blink will be solid when done successfully.
Web Workflow is only available on CircuitPython boards with ESP chips running CircuitPython 8.0.0-beta.6 or newer.
To connect the device to your network, you will need to set up the settings.toml file on your device and add your WiFi credentials. The CircuitPython Web Workflow Code Editor Quick Start Guide has more details how to create this file.
Once your device is connected to your Local Area Network, you can navigate to http://circuitpython.local/code/. This opens a page on your device that loads this website onto the device and to avoid any cross domain security issues.
If your device doesn't support the .local domain or the connection times out, connect with serial to read the IP address assigned to your device, then open http://device-ip-address:80/code/ from another tab in your browser
Web Serial is currently only supported in Chromium-based browsers.
For versions of Google Chrome between versions 78-89, Web Serial needs to manually be enabled. On recent browsers, this feature is enabled by default. If you are on an older version of the browser, you may be able to enable Web Serial with the about://flags/#enable-experimental-web-platform-features flag.
Connect to the Serial Port of your device. At this time, it will need to be enabled to continue.
Select the root folder of your device. This is typically the CIRCUITPY Drive on your computer unless you renamed it. If your device does not appear as a drive on your computer, it will need to have the USB Host functionality enabled.
| Current Device Info | |
|---|---|
| Board: | |
| Version: | |
| Hostname: | |
| IP Address: | |
| Build Date: | |
| MCU Name: | |
| Board ID: | |
| UID: | |