https://github.com/thingpulse/esp-app-market
Web App To Flash firmware for Espressif microcontrollers
https://github.com/thingpulse/esp-app-market
Last synced: 10 months ago
JSON representation
Web App To Flash firmware for Espressif microcontrollers
- Host: GitHub
- URL: https://github.com/thingpulse/esp-app-market
- Owner: ThingPulse
- License: mit
- Created: 2024-06-19T17:08:02.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-12-20T13:31:41.000Z (about 1 year ago)
- Last Synced: 2025-01-11T10:43:08.090Z (12 months ago)
- Language: TypeScript
- Size: 4.94 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Esp-App-Market
The Esp-App-Market is web-based tool to flash firmware to Espressif based microcontrollers
## Development server
Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The application will automatically reload if you change any of the source files.
## Build
Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.
## Running unit tests
Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
## Building docker image
### Building docker for local machine architecture
`docker build -t thingpulse/esp-app-market:1.0.0 . `
### building docker on ARM for x86
`docker buildx build --platform linux/amd64 -t thingpulse/esp-app-market:1.0.0 .`
### Running with docker-compose
The repository contains a sample docker-compose.yaml file. By executing
`docker-compose up -d`
in the root of this repository you can start the service. The example docker-compose configuration
will start the service at http://localhost:8081
## Changing device configuration
Default configurations loads the browser from the server. The angular application looks for a configuration
file at `/assets/defaultDeviceConfiguration.json`
### Explanation
- id: unique id within this file
- name: displayed name of the device
- imageSource: relative url to the displayed device image
- partitions: one or several partitions. We recommend to use just one partition if possible
- name: of the partition, will be displayed during flashing
- data: leave empty
- offset: address in the flash at which this partition should be written
- url: relative url where the binary file is. Adapt CORS headers if loading from a different domain
## Changing device configuration when running with docker-compose
Adapt and uncomment the following lines to use your own configuration files in `docker-compose.yaml`
```
volumes:
- ./src/assets:/usr/share/nginx/html/assets:ro
```
## Creating firmware to run the test
The following repository shows how to build a firmware which can be used together with the
esp-app-market: https://github.com/ThingPulse/esp32-epulse-feather-testbed
## FAQ
- Question: The tool doesn't work with Safari or Firefox
- Answer: This is expected, since neither Safari nor Firefox support WebSerial. Currently only
Chrome, Edge and Opera support this feature: https://caniuse.com/web-serial
- Question: When I connect my ESP32 no device shows up in the device pop-up
- Answer: If your operating system does not support the Serial-To-UART chip you still
have to install the driver. Check with your device manufacturer where to get this driver