{"id":19834521,"url":"https://github.com/thingpulse/esp-iot-flasher","last_synced_at":"2025-05-01T17:31:17.518Z","repository":{"id":145446159,"uuid":"600505008","full_name":"ThingPulse/esp-iot-flasher","owner":"ThingPulse","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-26T17:32:18.000Z","size":2832,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-26T22:07:23.764Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/ThingPulse.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2023-02-11T17:45:12.000Z","updated_at":"2024-06-26T17:32:21.000Z","dependencies_parsed_at":"2024-06-26T21:48:47.771Z","dependency_job_id":null,"html_url":"https://github.com/ThingPulse/esp-iot-flasher","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingPulse%2Fesp-iot-flasher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingPulse%2Fesp-iot-flasher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingPulse%2Fesp-iot-flasher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThingPulse%2Fesp-iot-flasher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThingPulse","download_url":"https://codeload.github.com/ThingPulse/esp-iot-flasher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224270307,"owners_count":17283649,"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":[],"created_at":"2024-11-12T12:04:57.961Z","updated_at":"2024-11-12T12:04:58.471Z","avatar_url":"https://github.com/ThingPulse.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESP-IoT-Flasher\n\nThe ESP-IoT-Flasher is web-based tool which is made for simplicity of use.\nA device tester just needs to install the UART driver. After opening the application\nin his browser he selects the device and clicks `Flash \u0026 Test`. The web application\nthen flashes a firmware to the device and the device responds with tests results from tests\nrunning on the device.\n\n[![Running the test](https://img.youtube.com/vi/a3fYCeyGAyI/maxresdefault.jpg)](https://www.youtube.com/shorts/a3fYCeyGAyI)\n\n## Development server\n\nRun `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The application will automatically reload if you change any of the source files.\n\n## Build\n\nRun `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.\n\n## Running unit tests\n\nRun `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).\n\n## Building docker image\n\n### Building docker for local machine architecture\n\n`docker build -t thingpulse/esp-iot-flasher:1.0.2 . `\n\n### building docker on ARM for x86\n\n`docker buildx build --platform linux/amd64 -t thingpulse/esp-iot-flasher:1.0.2 .`\n\n### Running with docker-compose\n\nThe repository contains a sample docker-compose.yaml file. By executing\n`docker-compose up -d`\nin the root of this repository you can start the service. The example docker-compose configuration\nwill start the service at http://localhost:8081\n\n## Changing device configuration\n\nDefault configurations loads the browser from the server. The angular application looks for a configuration\nfile at `/assets/defaultDeviceConfiguration.json`: \n\nhttps://github.com/ThingPulse/esp-iot-flasher/blob/1c669c1fe53238a759b6027cf89888fffa4055e9/src/assets/defaultDeviceConfiguration.json#L1-L24\n\n### Explanation\n\n- id: unique id within this file\n- name: displayed name of the device\n- imageSource: relative url to the displayed device image\n- partitions: one or several partitions. We recommend to use just one partition if possible\n    - name: of the partition, will be displayed during flashing\n    - data: leave empty\n    - offset: address in the flash at which this partition should be written\n    - url: relative url where the binary file is. Adapt CORS headers if loading from a different domain\n\n## Changing device configuration when running with docker-compose\n\nAdapt and uncomment the following lines to use your own configuration files in `docker-compose.yaml` \n```\n        volumes:\n          - ./src/assets:/usr/share/nginx/html/assets:ro\n```\n\n## Creating firmware to run the test\n\nThe following repository shows how to build a firmware which can be used together with the\nesp-iot-flasher: https://github.com/ThingPulse/esp32-epulse-feather-testbed\n\n## FAQ\n\n- Question: The tool doesn't work with Safari or Firefox\n- Answer: This is expected, since neither Safari nor Firefox support WebSerial. Currently only\n  Chrome, Edge and Opera support this feature: https://caniuse.com/web-serial\n\n- Question: When I connect my ESP32 no device shows up in the device pop-up\n- Answer: If your operating system does not support the Serial-To-UART chip you still\n  have to install the driver. Check with your device manufacturer where to get this driver\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthingpulse%2Fesp-iot-flasher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthingpulse%2Fesp-iot-flasher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthingpulse%2Fesp-iot-flasher/lists"}