{"id":20279080,"url":"https://github.com/t-vk/docker-esp-sdk","last_synced_at":"2025-04-11T06:14:57.782Z","repository":{"id":43606763,"uuid":"71453974","full_name":"T-vK/docker-esp-sdk","owner":"T-vK","description":"Executable docker image to easily compile and flash for the ESP32 and ESP8266","archived":false,"fork":false,"pushed_at":"2016-12-01T19:33:56.000Z","size":16,"stargazers_count":38,"open_issues_count":4,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-11T06:14:52.139Z","etag":null,"topics":["compile","docker","docker-image","esp","esp-sdk","esp32","esp8266","flash"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/T-vK.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-20T10:54:05.000Z","updated_at":"2025-04-06T16:24:19.000Z","dependencies_parsed_at":"2022-09-10T17:50:52.090Z","dependency_job_id":null,"html_url":"https://github.com/T-vK/docker-esp-sdk","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/T-vK%2Fdocker-esp-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/T-vK%2Fdocker-esp-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/T-vK%2Fdocker-esp-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/T-vK%2Fdocker-esp-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/T-vK","download_url":"https://codeload.github.com/T-vK/docker-esp-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248351393,"owners_count":21089272,"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":["compile","docker","docker-image","esp","esp-sdk","esp32","esp8266","flash"],"created_at":"2024-11-14T13:28:02.490Z","updated_at":"2025-04-11T06:14:57.762Z","avatar_url":"https://github.com/T-vK.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Easily compile and flash binaries for the ESP8266 and ESP8266EX\nYou might also be interested in the branch for the ESP32: https://github.com/T-vK/docker-esp-sdk/tree/esp32\n\n 1. [Get Docker](https://docs.docker.com/engine/installation/linux/)\n 2. \n   - If you trust me, you can simply pull my image from the docker hub:\n     ``` bash\n     sudo docker pull tavk/esp-sdk:0.1.0\n     ```\n     \n   - Otherwise, if you want it to be built on your computer (takes about 30-90 minutes), run this: \n     ``` bash\n     git clone https://github.com/T-vK/docker-esp-sdk.git\n     cd docker-esp-sdk\n     sudo docker build -t tavk/esp-sdk:0.1.0 .\n     ```\n     \nDone!\n\n## How to use\n\n### Compiling binaries\n\n``` bash\nsudo docker run -t -i -u esp \\\n-v /home/ubuntu/esp8266/esp-open-sdk/examples/blinky:/home/esp/shared_project \\\n-e SDK_VERSION='1.5.3' \\\ntavk/esp-sdk:0.1.0 \\\nmake\n```\n\n - Replace `/home/ubuntu/esp8266/esp-open-sdk/examples/blinky` with the absolute path to the directory of the project oyu want to compile.\n - Replace `1.5.3` with whatever version of the ESP SDK you want to compile. 1.4.0 up to 2.0.0 are supported.\n - Replace `make` with whatever command is necessary to compile your binary/binaries.\n\n\n### Flashing binaries\n\n``` bash\nsudo docker run -t -i -u esp \\\n--device=/dev/ttyUSB0 \\\n-v /home/ubuntu/esp8266/esp-open-sdk/examples/blinky:/home/esp/shared_project \\\ntavk/esp-sdk:0.1.0 \\\nesptool.py --port /dev/ttyUSB0 write_flash 0x00000 blinky-0x00000.bin 0x40000 blinky-0x40000.bin\n```\n\n - Replace `/home/ubuntu/esp8266/esp-open-sdk/examples/blinky` with the absolute path to the directory that contains the files you want to flash.\n - Replace `/dev/ttyUSB0` with the COM port that your ESP is connected to.\n - Replace `esptool.py --port /dev/ttyUSB0 write_flash 0x00000 blinky-0x00000.bin 0x40000 blinky-0x40000.bin` with whatever command is necessary to flash your binaries.\n\n\n### Flashing bootloaders\n\n``` bash\nsudo docker run -t -i -u esp \\\n--device=/dev/ttyUSB0 \\\n-v /home/ubuntu/projects/esp-bootloader:/home/esp/shared_project \\\ntavk/esp-sdk:0.1.0 \\\nesptool.py --port /dev/ttyUSB0 write_flash --flash_mode dio --flash_size 32m 0x0 bootloader.bin\n```\n\n - Replace `/home/ubuntu/projects/esp-bootloader` with the absolute path to the directory that contains the files you want to flash.\n - Replace `/dev/ttyUSB0` with the COM port that your ESP is connected to.\n -Replace `esptool.py --port /dev/ttyUSB0 write_flash --flash_mode dio --flash_size 32m 0x0 bootloader.bin` with whatever command is necessary to flash your binaries.\n\n### If the make file takes care of compiling AND flashing\n\n``` bash\nsudo docker run -t -i -u esp \\\n--device=/dev/ttyUSB0 \\\n-v /home/debian/espusb:/home/esp/shared_project \\\n-e SDK_VERSION='1.5.3' \\\ntavk/esp-sdk:0.1.0 \\\nmake ESP_ROOT=/home/esp/esp-open-sdk burn\n```\n\n - Replace `/dev/ttyUSB0` with the COM port your esp is connected to.\n - Replace `/home/debian/espusb` with the absolute path to directory of the project you want to compile/flash.\n - Replace `1.5.3` with whatever version of the ESP SDK you want to use for the compiling process.\n - Replace `make ESP_ROOT=/home/esp/esp-open-sdk burn` with the command necessary to compile and flash your project.\n\n### For more information on flashing please refer to the README of https://github.com/themadinventor/esptool\n\n### Tested\nI personally tested the docker image under Ubuntu 16.04 x64 and Debian 8 Jessie x64.\n\n## Can I use this on Windows?\nYes, but docker doesn't run natively on Windows. Tools like boot2docker or docker-machine create a Linux VM using VirtualBox. So in order to grant the docker image access to your serial port and your project folder you have to pass your serial port (or usb serial adapter) through to the vm and the same applies for your project folder.  \nRead this for more information on that: http://stackoverflow.com/questions/30864466/whats-the-best-way-to-share-files-from-windows-to-boot2docker-vm\n\n## Can I use this on Mac OS X?\nProbably yes. If docker runs natively on Mac OS X, then there is no need to do anything special. Otherwise follow the same steps that are required for Windows as described above.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft-vk%2Fdocker-esp-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ft-vk%2Fdocker-esp-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft-vk%2Fdocker-esp-sdk/lists"}