{"id":17565088,"url":"https://github.com/luftdaten-at/firmware","last_synced_at":"2025-10-28T04:33:20.140Z","repository":{"id":248540261,"uuid":"815122815","full_name":"luftdaten-at/firmware","owner":"luftdaten-at","description":"Open source firmware for Luftdaten.at devices, written in CircuitPython.","archived":false,"fork":false,"pushed_at":"2025-02-10T09:58:10.000Z","size":450,"stargazers_count":0,"open_issues_count":11,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-10T10:36:23.414Z","etag":null,"topics":["circuitpython"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/luftdaten-at.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,"publiccode":null,"codemeta":null}},"created_at":"2024-06-14T11:58:45.000Z","updated_at":"2025-02-10T09:58:14.000Z","dependencies_parsed_at":"2024-07-15T17:07:17.798Z","dependency_job_id":"2d9dff6f-0732-4fad-b240-0c213aaa79ab","html_url":"https://github.com/luftdaten-at/firmware","commit_stats":{"total_commits":155,"total_committers":3,"mean_commits":"51.666666666666664","dds":0.07096774193548383,"last_synced_commit":"1bf3e251dfeb21dcd1f03dfe7ec43544f3c5084b"},"previous_names":["luftdaten-at/firmware"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luftdaten-at%2Ffirmware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luftdaten-at%2Ffirmware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luftdaten-at%2Ffirmware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/luftdaten-at%2Ffirmware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/luftdaten-at","download_url":"https://codeload.github.com/luftdaten-at/firmware/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238597382,"owners_count":19498397,"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":["circuitpython"],"created_at":"2024-10-21T14:08:46.409Z","updated_at":"2025-10-28T04:33:19.271Z","avatar_url":"https://github.com/luftdaten-at.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Circuitpython Firmware\n\nFirmware for Luftdaten.at devices in Circuitpython.\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Installation\n\nHere is the English translation of your markdown:\n\n## 1 - Download CircuitPython Version\n\nDownload link: https://circuitpython.org/board/espressif_esp32s3_devkitc_1_n8r8/\n\nAt least CircuitPython 9.1.0 is required. Due to a bug in CircuitPython, only \u003c= 9.1.0 or \u003e= 9.2.0 can currently be used. Download the `.bin` file, where `circuitpython.bin` is the path to the downloaded CircuitPython file.\n\n## 2 - Install CircuitPython\n\n### on Mac\nConnect the Mac and ESP32 via USB C. Press the Reset button while also holding down the Boot button.\n\nIf not already installed, install esptool.py:\n\n```bash\npip3 install esptool\n```\n\nFind the port of the ESP32:\n\n```bash\nls /dev/tty.*\n```\n\nThe ESP32 should appear as a USB device, e.g., /dev/tty.usbmodem101.\n\nErase the ESP32 flash memory:\n\n```bash\nesptool.py --port /dev/tty.usbmodem101 erase_flash\n```\n\nFlash CircuitPython onto the ESP32:\n\n```bash\nesptool.py --port /dev/tty.usbmodem101 write_flash -z 0x0 circuitpython.bin\n```\n\n### on Windows\n\nConnect Windows and the ESP32 via USB C. Press the Reset button while also holding down the Boot button.\n\nIf not already installed, install esptool.py. Open the command prompt (CMD) and install esptool:\n\n```CMD\npip install esptool\n```\n\nFind the port of the ESP32.\nOpen the Device Manager and look under “Ports (COM \u0026 LPT)” for your ESP32. There should be an entry like COM3 or COM5.\n\nErase the ESP32 flash memory:\nReplace COM3 with the actual COM port of your ESP32:\n\n```CMD\nesptool.py --port COM3 erase_flash\n```\n\nFlash CircuitPython onto the ESP32:\nUse the correct path to the downloaded CircuitPython file and the corresponding COM port:\n\n```CMD\nesptool.py --port COM3 write_flash -z 0x0 circuitpython.bin\n```\n\n### on Linux\n\nConnect Linux and the ESP32 via USB C. Press the Reset button while also holding down the Boot button.\n\nIf not already installed, install esptool.py. Open a terminal and install esptool:\n\n```bash\npip install esptool\n```\n\nFind the port of the ESP32.\nRun the following command in the terminal:\n\n```bash\nls /dev/tty*\n```\n\nThe ESP32 should appear as a device, e.g., /dev/ttyUSB0 or /dev/ttyACM0.\n\nErase the ESP32 flash memory:\nReplace /dev/ttyUSB0 with the actual device name:\n\n```bash\nesptool.py --port /dev/ttyUSB0 erase_flash\n```\n\nFlash CircuitPython onto the ESP32:\nUse the correct path to the downloaded CircuitPython file and the correct device name:\n\n```bash\nesptool.py --port /dev/ttyUSB0 write_flash -z 0x0 circuitpython.bin\n```\n\n## 3 - Copy Files\n\nDownload the latest [Release](https://github.com/luftdaten-at/firmware/releases)  and copy all files from the firmware folder to the ESP32.\n\n## 4 - Start and Configure\n\nConfigure the device using the app. You can find it in the Google Play or Apple App Store. [Links here](https://luftdaten.at/mobile-app/)\n\n## Contributing\n\nWe use GitHub Flow for our development process. Please open an issue oder write us.\n\n## License\n\nThis project is licensed under the AGPL 3.0 License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluftdaten-at%2Ffirmware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluftdaten-at%2Ffirmware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluftdaten-at%2Ffirmware/lists"}