Pico Portal

Turn your Raspberry Pi Pico W into a portable, powerful Wi-Fi access point with this lightweight captive portal software. Serve web content/pages and display real-time connection info directly on the onboard Pimoroni screen. Log all the connection details for later debugging and use!

Whether you're testing networks, showcasing web projects, or exploring IoT, this tool gives you the flexibility to do it all. It’s easily adaptable for various purposes—serve web applications, demo single-page apps (SPAs), or set up captive portals for network security testing.

• Preview images
• Hardware
  • Purchase
  • Build your own
• Firmware Setup
  • Connecting to PC
  • Installing Firmware
• Software Setup
  • Installing Software
  • User Defined Settings
  • Button Functions
• Development
  • Requirements
  • Development Setup
  • Scripts
• Licensing
• Wrapping Up

[ Index ]

You can purchase a fully assembled Pico Portal XL, Pico Portal Mini, or a 3D-printed enclosure/case for your own build from Lambda Guru:

🔗 https://www.lambda.guru/

Note: The 3D print files are available on Lambda Guru for a small fee (the first time I've ever charged for models, see my free collection here). The enclosures/cases on Lambda Guru are specifically designed for the parts listed below.

Note: If you'd like to do your own custom build there are other alternative 3D printable cases out there on websites such as thingiverse. Be sure to show off a picture of your build by submitting a ticket here! Your images will likely be shared on places like the Lambda Guru website or this repository for the community to see!

To replicate the original Pico Portal devices found on Lambda Guru, you will need the following:

Pico Portal XL parts list:

Pico Portal Mini parts list:

Note: This project can be ran standalone on a Raspberry Pi Pico W! Additional hardware is only required for the portable version.

[ Index ]

To connect your Raspberry Pi Pico W to your PC for firmware installation, follow these steps:

1. Make sure your Raspberry Pi Pico is not connected to any power source.

2. Hold down the BOOTSEL button on your Pico.

3. Connect the Pico to your computer using a Micro USB cable.

4. Release the BOOTSEL button. The device should appear on your computer as a USB Mass Storage Device.

Note: You only need to do this for Firmware installation. After the firmware is installed, you can connect your Pico to your computer without holding the BOOTSEL button.

To install MicroPython on your Raspberry Pi Pico W after connecting to your computer, follow these steps:

1. Download the latest Pimoroni Pico W UF2 file "picow-vXX.YY.ZZ-pimoroni-micropython.uf2" from the official releases:

   • https://github.com/pimoroni/pimoroni-pico/releases

2. Connect your Raspberry Pi Pico W to your PC, see Connecting to PC.

3. Drag and drop the UF2 file onto the RPI-RP2 drive. This will program the MicroPython firmware onto your Pico.

4. Wait for a few seconds. The board will automatically reboot. Your Pico will now be running MicroPython.

[ Index ]

Note: This project uses Node.js. Make sure you have Node.js installed on your system before proceeding.

1. Install project dependencies:

   npm install

2. Install Thonny IDE:

   • https://thonny.org/

3. Open Thonny IDE and connect to your Raspberry Pi Pico W via USB.

4. Copy the contents from src/ (this repo) to the root of your Raspberry Pi Pico W using the Thonny IDE.

   Note: Be sure the "src/modules/" is copied and that the folder exists.

5. Unplug your Raspberry Pi Pico W from your computer and connect it to a power source.

6. Your Raspberry Pi Pico W will now boot up and display the Pico Portal interface on the Pimoroni screen.

You can customize the Pico Portal settings by editing the src/options.py file. The settings are as follows:

{
    "wifi_ssid": "WiFi",
    "wifi_password": "",
    "wifi_domain": "setup.local",
    "display_type": "DISPLAY_PICO_DISPLAY"
    "enable_timestamps": False,
    "led_brightness": 0.25
}

The Pico Portal has four buttons that can be used to interact with the device. The button functions are as follows:

Button layout:

 Pico Display       Pico Display 2.0
|=============|  |=====================|
|             |  |   (B)         (A)   |
|  (B)   (A)  |  | ------------------- |
| ----------- |  | |                 | |
| |         | |  | |                 | |
| |         | |  | |                 | |
| |         | |  | |                 | |
| |         | |  | |                 | |
| |         | |  | |                 | |
| ----------- |  | |                 | |
|  (Y)   (X)  |  | ------------------- |
|    (LED)    |  |   (Y)  (LED)  (X)   |
|=============|  |=====================|

[ Index ]

Make sure the following are installed on your system before you begin:

• Node.js
• Python
• Thonny IDE

Using a terminal, follow these steps to set up the development environment:

1. Fork and clone the repository:

   git clone

2. Install project dependencies. This will install the required Node.js packages for running setup.ts which will download the required asset files to the src/modules folder. Run in the root of the project:

   npm install

3. Run the python setup script. This will download the files for linting (flake8), formatting (black), and pre-commit hooks (pre-commit). Basically everything we need for enforcing code quality.

   # Install the required packages
   npm run lint:install
   # Install the pre-commit hooks
   pre-commit install
   # Update the pre-commit hooks
   pre-commit autoupdate

4. Program, test, and debug the project using the Thonny IDE.

5. Commit (pre commit hooks should run and verify the code) and push your changes.

6. Create a pull request here.

Thank you for contributing!

[ Index ]

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. See the LICENSE.md file for the pertaining license text.

SPDX-License-Identifier: CC-BY-NC-4.0

Basically, everything is free for you to use personally. I just ask that you don't sell this software. If you want to use it for commercial purposes, please contact me first and we can work something out.

Feel free to build this project for yourself, your friends, or your family etc! You can also purchase this device from me directly fully assembled with a case here.

Thank you for your understanding!

[ Index ]

Thank you for all of your support, I spent a long time working on this project and plan to support it long term. Really hoping the community joins in and helps me improve it from here. It's important to me that this project stays accessible to everyone, so please keep this software free and open source. If you have any questions, please let me know by opening an issue here.

Type	Info
	webmaster@codytolene.com
	https://www.buymeacoffee.com/codytolene
	bc1qfx3lvspkj0q077u3gnrnxqkqwyvcku2nml86wmudy7yf2u8edmqq0a5vnt

Fin. Happy programming friend!

Cody Tolene