From ea5744fd8decb1161a2bd212813a275e2705fd89 Mon Sep 17 00:00:00 2001
From: ubi de feo <me@ubidefeo.com>
Date: Thu, 20 Jan 2022 07:07:06 +0100
Subject: [PATCH] esp32/boards: Provide custom deploy_c3.md for ESP32-C3
 boards.

This fixes the flash address for installation on ESP32-C3.
---
 ports/esp32/boards/GENERIC_C3/board.json     |  2 +-
 ports/esp32/boards/GENERIC_C3_USB/board.json |  2 +-
 ports/esp32/boards/deploy_c3.md              | 14 ++++++++++++++
 3 files changed, 16 insertions(+), 2 deletions(-)
 create mode 100644 ports/esp32/boards/deploy_c3.md

diff --git a/ports/esp32/boards/GENERIC_C3/board.json b/ports/esp32/boards/GENERIC_C3/board.json
index 481e66bccd..6cc326bf14 100644
--- a/ports/esp32/boards/GENERIC_C3/board.json
+++ b/ports/esp32/boards/GENERIC_C3/board.json
@@ -1,6 +1,6 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_c3.md"
     ],
     "docs": "",
     "features": [
diff --git a/ports/esp32/boards/GENERIC_C3_USB/board.json b/ports/esp32/boards/GENERIC_C3_USB/board.json
index 94d86d4428..23f9a8eb20 100644
--- a/ports/esp32/boards/GENERIC_C3_USB/board.json
+++ b/ports/esp32/boards/GENERIC_C3_USB/board.json
@@ -1,6 +1,6 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_c3.md"
     ],
     "docs": "",
     "features": [
diff --git a/ports/esp32/boards/deploy_c3.md b/ports/esp32/boards/deploy_c3.md
new file mode 100644
index 0000000000..016ba7cabb
--- /dev/null
+++ b/ports/esp32/boards/deploy_c3.md
@@ -0,0 +1,14 @@
+Program your board using the esptool.py program, found [here](https://github.com/espressif/esptool).
+
+If you are putting MicroPython on your board for the first time then you should
+first erase the entire flash using:
+
+```bash
+esptool.py --chip esp32c3 --port /dev/ttyUSB0 erase_flash
+```
+
+From then on program the firmware starting at address 0x0:
+
+```bash
+esptool.py --chip esp32c3 --port /dev/ttyUSB0 --baud 460800 write_flash -z 0x0 esp32c3-20220117-v1.18.bin
+```