Skip to content

Commit 5304fea

Browse files
deploy: f0965be
1 parent ac49da1 commit 5304fea

5 files changed

Lines changed: 818 additions & 741 deletions

File tree

api/boards.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5727,7 +5727,7 @@
57275727
"board_image": "lilygo_tdisplay_s3.jpg",
57285728
"date_added": "2024-03-09",
57295729
"family": "esp32s3",
5730-
"bootloader_id": "",
5730+
"bootloader_id": "lilygo_tdisplay_s3",
57315731
"tags": [
57325732
],
57335733
"features": [

board/lilygo_tdisplay_s3/index.html

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1068,6 +1068,82 @@ <h3>Previous Versions of CircuitPython</h3>
10681068

10691069

10701070

1071+
<div class="section unrecommended">
1072+
<h3>Install, Repair, or Update UF2 Bootloader</h3>
1073+
<p>
1074+
Latest version: 0.20.1
1075+
</p>
1076+
<p>
1077+
<strong>The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs.
1078+
The bootloader is not CircuitPython.</strong>
1079+
If a UF2 bootloader is installed, you can check its version by looking in
1080+
the <b>INFO_UF2.TXT</b> file when the <b>BOOT</b> drive is visible
1081+
(<b>FTHRS2BOOT</b>, <b>MAGTAGBOOT</b>, <b>HOUSEBOOT</b>, etc.)
1082+
</p>
1083+
<p>
1084+
It is not necessary to reinstall a UF2 bootloader you unless a <b>BOOT</b> drive is not visible
1085+
when in UF2 bootloader mode, or you know of a problem with your current UF2 bootloader.
1086+
</p>
1087+
<p>
1088+
If a UF2 bootloader has never been installed on the board, or the UF2 bootloader was removed by erasing or overwriting the flash, the UF2 bootloader must be installed in order to flash <b>.uf2</b> files onto the board. <b>.bin</b> files can be uploaded without a UF2 bootloader, using the
1089+
<a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">ESP Web Flasher</a>
1090+
or <b>esptool.py</b>.
1091+
</p>
1092+
1093+
<p>
1094+
<em>Note: <b>update.uf2</b> files are not currently working on ESP32-S2 or ESP32-S3 boards.</em>
1095+
</p>
1096+
1097+
<p><strong><em>Important</em></strong>:
1098+
<em>this will erase previously flashed firmware and sketches from the board,
1099+
but needs to be perfomed only once.</em>
1100+
</p>
1101+
<p><em>The instructions here are general.
1102+
We recommend you consult the manufacturer's board documentation for detailed
1103+
instructions, which may be different.</em>
1104+
</p>
1105+
<ul>
1106+
<li>Unzip to find the file <b>combined.bin</b>.</li>
1107+
<li>Place board in bootloader mode:
1108+
<ul>
1109+
<li>Plug board into a USB port on your computer using a data/sync cable. Make sure it is the only board plugged in, and that a charge-only cable is not being used.</li>
1110+
<li>Press and <strong>hold down</strong> the <b>BOOT</b> or <b>0</b> button.</li>
1111+
<li>Press and <strong>release</strong> the <b>RESET</b> or <b>RST</b> button.</li>
1112+
<li>Release the <b>BOOT</b> button.</li>
1113+
</ul>
1114+
</li>
1115+
<li>Upload <b>combined.bin</b> (Google Chrome 89 or newer):
1116+
<ul>
1117+
<li>Open <a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">ESP Web Flasher</a> in a new window/tab.</li>
1118+
<li>Select <b>460800 Baud</b> from the pull-down menu (top-right).</li>
1119+
<li>Click <b>Connect</b> (top-right).</li>
1120+
<li>Select the COM or Serial port from the pop-up window.</li>
1121+
<li>After successful connection, click <b>Erase</b>.</li>
1122+
<li>After successful erase, click any <b>Choose a file...</b>, then locate and select the <b>combined.bin</b> file unzipped earlier.</li>
1123+
<li>After successfully choosing <b>combined.bin</b>, click <b>Program</b>.</li>
1124+
<li>After the TinyUF2 firmware update is complete, press the <b>RESET</b> button on the board.
1125+
A new drive <b>BOOT</b> should be visible in your file browser.</li>
1126+
</ul>
1127+
</li>
1128+
</ul>
1129+
1130+
<p>
1131+
After installing the UF2 bootloader, enter the bootloader by double-clicking the reset button.
1132+
On boards with an RGB status LED, tap reset once, wait for the LED to turn purple, and tap
1133+
again before the purple goes away. On other boards, consult the board documentation.
1134+
</p>
1135+
1136+
<p>
1137+
After you update, check <b>INFO_UF2.TXT</b> to verify that the bootloader version has been updated.
1138+
Then you will need to load or reload CircuitPython using the <b>.uf2</b> file.
1139+
</p>
1140+
<div>
1141+
<a class="download-button" href="https://github.com/adafruit/tinyuf2/releases/download/0.20.1/tinyuf2-lilygo_tdisplay_s3-0.20.1.zip">DOWNLOAD BOOTLOADER ZIP<i class="fas fa-download" aria-hidden="true"></i></a>
1142+
</div>
1143+
</div>
1144+
1145+
1146+
10711147

10721148
</div>
10731149
</div>

feed.rss

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<title>CircuitPython.org Boards</title>
55
<link>https://circuitpython.org/</link>
66
<description>A list of CircuitPython and Blinka supported boards</description>
7-
<lastBuildDate>Tue, 18 Feb 2025 05:03:57 -0500</lastBuildDate>
7+
<lastBuildDate>Tue, 18 Feb 2025 13:16:46 -0500</lastBuildDate>
88

99
<item>
1010
<title>ESP32-C6 1.47inch Display Development Board</title>

json/esp32_boards.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1520,6 +1520,7 @@
15201520
"lilygo_tdisplay_s3": {
15211521
"name": "T-Display S3",
15221522
"chipfamily": "esp32s3",
1523+
"bootloader": "https://adafruit-circuit-python.s3.amazonaws.com/bootloaders/esp32/tinyuf2-lilygo_tdisplay_s3-0.20.1.zip",
15231524
"releases": [
15241525
{
15251526
"version": "9.2.4",

0 commit comments

Comments
 (0)