We've created a drag-and-drop UF2 file to make it easy to get your ESPHole up and running right away. If you'd like to tweak the code and upload via Arduino IDE, check out the source code here.

While the actual code you'll run is a compiled Arduino sketch, first, you will put CircuitPython on the Feather in order to create a file system accessible as a USB drive. This way, you can add the secrets.json file with login information for the local router. The firmware doesn't have the WiFi access point data, instead it's separated out into a json file that can be easily modified.

Then, you'll drag on the UF2 file of the compiled Arduino code. (Download link below).

Create Filesystem, Add Files

  1. Plug in Feather to your computer with a known good data cable.
  2. Double-click the Feather board reset button to get to bring up the bootloader FTHRS2BOOT drive in your computer File Explorer/Finder.
  3. Download the latest release version of CircuitPython for this board.
  4. Drag the CircuitPython .uf2 file onto FTHRS2BOOT drive (more info here).
  5. After a moment CIRCUITPY drive will show up
  6. Copy the secrets.json code below, paste it into a text editor on your computer and edit it to use your SSID and password for your WiFi router, then save the file to the CIRCUITPY drive.
  7. Next, download the pre-compiled ESPHole UF2 file linked below.
  8. Double-click the Feather board reset button to get to the bootloader AGAIN.
  9. Drag the UF2 onto the FTHRS2BOOT drive to flash it with the ESPHole code.
    'ssid' : 'YOUR_WIFI_SSID',
    'password' : 'YOUR_WIFI_PASSWORD',
    'hostname' : 'esphole',
    'hostfile' : 'https://raw.githubusercontent.com/AdAway/adaway.github.io/master/hosts.txt'

This guide was first published on Apr 27, 2022. It was last updated on Mar 08, 2024.

This page (Code the ESPHole) was last updated on Mar 08, 2024.

Text editor powered by tinymce.