{"id":13802103,"url":"https://github.com/brainelectronics/Micropython-ESP-WiFi-Manager","last_synced_at":"2025-05-13T12:32:23.189Z","repository":{"id":40470552,"uuid":"454861875","full_name":"brainelectronics/Micropython-ESP-WiFi-Manager","owner":"brainelectronics","description":"MicroPython based ESP WiFi Manager","archived":false,"fork":false,"pushed_at":"2023-06-16T08:08:23.000Z","size":394,"stargazers_count":36,"open_issues_count":7,"forks_count":9,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-05-13T04:06:51.400Z","etag":null,"topics":["esp32","esp8266","flask","library","micropython","simulation","unit-testing","wifi","wifimanager"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brainelectronics.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-02-02T17:00:57.000Z","updated_at":"2025-03-31T13:35:08.000Z","dependencies_parsed_at":"2024-01-29T19:40:37.872Z","dependency_job_id":null,"html_url":"https://github.com/brainelectronics/Micropython-ESP-WiFi-Manager","commit_stats":{"total_commits":195,"total_committers":2,"mean_commits":97.5,"dds":0.00512820512820511,"last_synced_commit":"a6049d90a093867c7869b1a148d34caed2e8f0c2"},"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainelectronics%2FMicropython-ESP-WiFi-Manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainelectronics%2FMicropython-ESP-WiFi-Manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainelectronics%2FMicropython-ESP-WiFi-Manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brainelectronics%2FMicropython-ESP-WiFi-Manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brainelectronics","download_url":"https://codeload.github.com/brainelectronics/Micropython-ESP-WiFi-Manager/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253942612,"owners_count":21988098,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esp32","esp8266","flask","library","micropython","simulation","unit-testing","wifi","wifimanager"],"created_at":"2024-08-04T00:01:36.001Z","updated_at":"2025-05-13T12:32:22.419Z","avatar_url":"https://github.com/brainelectronics.png","language":"Python","funding_links":[],"categories":["Libraries"],"sub_categories":["Communications"],"readme":"# ESP WiFi Manager\n\n[![Downloads](https://pepy.tech/badge/micropython-esp-wifi-manager)](https://pepy.tech/project/micropython-esp-wifi-manager)\n![Release](https://img.shields.io/github/v/release/brainelectronics/micropython-esp-wifi-manager?include_prereleases\u0026color=success)\n![MicroPython](https://img.shields.io/badge/micropython-Ok-green.svg)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![CI](https://github.com/brainelectronics/micropython-esp-wifi-manager/actions/workflows/release.yml/badge.svg)](https://github.com/brainelectronics/micropython-esp-wifi-manager/actions/workflows/release.yml)\n\nMicroPython WiFi Manager to configure and connect to networks\n\n-----------------------\n\n\u003c!-- MarkdownTOC --\u003e\n\n- [Installation](#installation)\n\t- [Install required tools](#install-required-tools)\n\t- [Flash firmware](#flash-firmware)\n\t- [Upload files to board](#upload-files-to-board)\n\t\t- [Install package](#install-package)\n\t\t- [General](#general)\n\t\t- [Hook the WiFi Manager boot logic](#hook-the-wifi-manager-boot-logic)\n\t\t- [Specific version](#specific-version)\n\t\t- [Test version](#test-version)\n\t\t- [Manually](#manually)\n\t\t\t- [Upload files to board](#upload-files-to-board-1)\n\t\t\t- [Install additional MicroPython packages](#install-additional-micropython-packages)\n- [Usage](#usage)\n\n\u003c!-- /MarkdownTOC --\u003e\n\n## Installation\n\n### Install required tools\n\nPython3 must be installed on your system. Check the current Python version\nwith the following command\n\n```bash\npython --version\npython3 --version\n```\n\nDepending on which command `Python 3.x.y` (with x.y as some numbers) is\nreturned, use that command to proceed.\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate\n\npip install -r requirements.txt\n```\n\nTest both tools by showing their man/help info description.\n\n```bash\nesptool.py --help\nrshell --help\n```\n\n### Flash firmware\n\nTo flash the [micropython firmware][ref-upy-firmware-download] as described on\nthe micropython firmware download page, use the `esptool.py` to erase the\nflash before flashing the firmware.\n\n```bash\nesptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART erase_flash\nesptool.py --chip esp32 --port /dev/tty.SLAB_USBtoUART --baud 460800 write_flash -z 0x1000 esp32-20210623-v1.16.bin\n```\n\nIf the Micropython board is equipped with an external PSRAM chip, the\n`esp32spiram-20210623-v1.16.bin` can also be used for ESP32 devices. If there\nis no external PRSAM only the non SPIRAM version is working.\n\n### Upload files to board\n\n#### Install package\n\nConnect your MicroPython board to a network\n\n```python\nimport network\nstation = network.WLAN(network.STA_IF)\nstation.active(True)\nstation.connect('SSID', 'PASSWORD')\nstation.isconnected()\n```\n\n#### General\n\nInstall the latest package version of this lib on the MicroPython device\n\n```python\nimport mip\nmip.install(\"github:brainelectronics/micropython-esp-wifi-manager\")\n\n# maybe install the dependencies manually afterwards\n# mip.install(\"github:brainelectronics/micropython-modules\")\n```\n\nFor MicroPython versions below 1.19.1 use the `upip` package instead of `mip`\n\n```python\nimport upip\nupip.install('micropython-esp-wifi-manager')\n# dependencies will be installed automatically\n```\n\n#### Hook the WiFi Manager boot logic\n\nThe `boot.py` and `main.py` files of this package are installed into `/lib` of\nthe MicroPython device by `mip`. They are fully functional and without any\nother dependencies or MicroPython port specific commands. Simply add the\nfollowing line to the `boot.py` file of your device. *The following commands\nare not working if this package got installed by `upip`*\n\n```python\nimport wifi_manager.boot\n```\n\nAnd also add this line to your `main.py`, before your application code\n\n```python\nimport wifi_manager.main\n```\n\n#### Specific version\n\nInstall a specific, fixed package version of this lib on the MicroPython device\n\n```python\nimport mip\n# install a verions of a specific branch\nmip.install(\"github:brainelectronics/micropython-esp-wifi-manager\", version=\"feature/support-mip\")\n# install a tag version\nmip.install(\"github:brainelectronics/micropython-esp-wifi-manager\", version=\"1.7.0\")\n```\n\n#### Test version\n\nInstall a specific release candidate version uploaded to\n[Test Python Package Index](https://test.pypi.org/) on every PR on the\nMicroPython device. If no specific version is set, the latest stable version\nwill be used.\n\n```python\nimport mip\nmip.install(\"github:brainelectronics/micropython-esp-wifi-manager\", version=\"1.7.0-rc5.dev22\")\n```\n\nFor MicroPython versions below 1.19.1 use the `upip` package instead of `mip`\n\n```python\nimport upip\n# overwrite index_urls to only take artifacts from test.pypi.org\nupip.index_urls = ['https://test.pypi.org/pypi']\nupip.install('micropython-esp-wifi-manager')\n```\n\nSee also [brainelectronics Test PyPi Server in Docker][ref-brainelectronics-test-pypiserver]\nfor a test PyPi server running on Docker.\n\n#### Manually\n\n##### Upload files to board\n\nCopy the module(s) to the MicroPython board and import them as shown below\nusing [Remote MicroPython shell][ref-remote-upy-shell]\n\nOpen the remote shell with the following command. Additionally use `-b 115200`\nin case no CP210x is used but a CH34x.\n\n```bash\nrshell -p /dev/tty.SLAB_USBtoUART --editor nano\n```\n\nCreate compressed CSS and JS files as described in the\n[simulation static files README](simulation/static) to save disk space on the\ndevice and increase the performance (webpages are loading faster)\n\n```bash\nmkdir /pyboard/lib/\nmkdir /pyboard/lib/microdot/\nmkdir /pyboard/lib/utemplate/\nmkdir /pyboard/lib/wifi_manager/\nmkdir /pyboard/lib/static/\nmkdir /pyboard/lib/static/css\nmkdir /pyboard/lib/static/js\n\ncp static/css/*.gz /pyboard/lib/static/css\ncp static/js/*.gz /pyboard/lib/static/js\n# around 24kB compared to uncompressed 120kB\n\n# optional, not used so far\n# mkdir /pyboard/lib/static/js\n# cp static/js/*.gz /pyboard/lib/static/js\n# around 12kB compared to uncompressed 40kB\n\nmkdir /pyboard/lib/templates/\ncp templates/* /pyboard/lib/templates/\n# around 20kB\n\ncp wifi_manager/* /pyboard/lib/wifi_manager/\ncp microdot/* /pyboard/lib/microdot/\ncp utemplate/* /pyboard/lib/utemplate/\ncp main.py /pyboard\ncp boot.py /pyboard\n# around 40kB\n```\n\n##### Install additional MicroPython packages\n\nAs this package has not been installed with `upip` additional modules are\nrequired, which are not part of this repo.\n\nConnect the board to a network and install the package like this for\nMicroPython 1.20.0 or never\n\n```python\nimport mip\nmip.install(\"github:brainelectronics/micropython-modules\")\n```\n\nFor MicroPython versions below 1.19.1 use the `upip` package instead of `mip`\n\n```python\nimport upip\nupip.install('micropython-brainelectronics-helper')\n```\n\n## Usage\n\nAfter all files have been transfered or installed open a REPL to the device.\n\nThe device will try to load and connect to the configured networks based on an\nencrypted JSON file.\n\nIn case no network has been configured or no connection could be established\nto any of the configured networks within the timeout of each 5 seconds an\nAccessPoint at `192.168.4.1` is created.\n\nA simple Picoweb webserver is hosting the webpages to connect to new networks,\nto remove already configured networks from the list of connections to\nestablish and to get the latest available networks as JSON.\n\nThis is a list of available webpages\n\n| URL | Description |\n|-----|-------------|\n| `/`   | Root index page, to choose from the available pages |\n| `/select` | Select and configure a network |\n| `/configure` | Manage already configured networks |\n| `/scan_result` | JSON of available networks |\n| `/shutdown` | Shutdown webserver and return from `run` function |\n\nTo leave from the Webinterface, just press CTRL+C and wait until all threads\nfinish running. This takes around 1 second. The device will return to its REPL\n\n\u003c!-- Links --\u003e\n[ref-esptool]: https://github.com/espressif/esptool\n[ref-remote-upy-shell]: https://github.com/dhylands/rshell\n[ref-brainelectronics-test-pypiserver]: https://github.com/brainelectronics/test-pypiserver\n[ref-upy-firmware-download]: https://micropython.org/download/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainelectronics%2FMicropython-ESP-WiFi-Manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrainelectronics%2FMicropython-ESP-WiFi-Manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrainelectronics%2FMicropython-ESP-WiFi-Manager/lists"}