Skip to content

Commit aba4614

Browse files
adafruit-adabotadafruit-adabot
committed
deploy: 01745bf 
1 parent 9126c15 commit aba4614

File tree

16 files changed

+2118
-1568
lines changed

16 files changed

+2118
-1568
lines changed

‎api/boards.json‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4136,7 +4136,7 @@
41364136
"board_image": "espressif_esp32s2_devkitc_1_n4.jpg",
41374137
"date_added": "2022-04-01",
41384138
"family": "esp32s2",
4139-
"bootloader_id": "",
4139+
"bootloader_id": "espressif_esp32s2_devkitc_1",
41404140
"tags": [
41414141
],
41424142
"features": [
@@ -4157,7 +4157,7 @@
41574157
"board_image": "espressif_esp32s2_devkitc_1_n4r2.jpg",
41584158
"date_added": "2022-02-14",
41594159
"family": "esp32s2",
4160-
"bootloader_id": "",
4160+
"bootloader_id": "espressif_esp32s2_devkitc_1",
41614161
"tags": [
41624162
],
41634163
"features": [
@@ -5951,7 +5951,7 @@
59515951
"board_image": "lilygo_tdisplay_s3_pro.jpg",
59525952
"date_added": "2024-07-18",
59535953
"family": "esp32s3",
5954-
"bootloader_id": "",
5954+
"bootloader_id": "lilygo_tdisplay_s3_pro",
59555955
"tags": [
59565956
],
59575957
"features": [
@@ -5976,7 +5976,7 @@
59765976
"board_image": "lilygo_tdongle_s3.jpg",
59775977
"date_added": "2024-07-18",
59785978
"family": "esp32s3",
5979-
"bootloader_id": "",
5979+
"bootloader_id": "lilygo_tdongle_s3",
59805980
"tags": [
59815981
],
59825982
"features": [
@@ -12296,7 +12296,7 @@
1229612296
"board_image": "waveshare_esp32_s3_matrix.jpg",
1229712297
"date_added": "2025-01-27",
1229812298
"family": "esp32s3",
12299-
"bootloader_id": "",
12299+
"bootloader_id": "waveshare_esp32_s3_matrix",
1230012300
"tags": [
1230112301
],
1230212302
"features": [
@@ -12363,7 +12363,7 @@
1236312363
"board_image": "waveshare_esp32_s3_touch_lcd_2.jpg",
1236412364
"date_added": "2024-04-17",
1236512365
"family": "esp32s3",
12366-
"bootloader_id": "",
12366+
"bootloader_id": "waveshare_esp32_s3_touch_lcd_2",
1236712367
"tags": [
1236812368
],
1236912369
"features": [

‎board/espressif_esp32s2_devkitc_1_n4/index.html‎

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

18451845

18461846

1847+
1848+
<div class="section unrecommended">
1849+
<h3>Install, Repair, or Update UF2 Bootloader</h3>
1850+
<p>
1851+
Latest version: 0.35.0
1852+
</p>
1853+
<p>
1854+
<strong>The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs.
1855+
</strong>
1856+
The bootloader itself is not CircuitPython.
1857+
On Espressif boards, the UF2 bootloader is called <em>TinyUF2</em>.
1858+
If the TinyUF2 bootloader is installed, you can check its version by looking in
1859+
the <strong>INFO_UF2.TXT</strong> file when the <strong>BOOT</strong> drive is visible
1860+
(<strong>FTHRS2BOOT</strong>, <strong>MAGTAGBOOT</strong>, <strong>HOUSEBOOT</strong>, etc.)
1861+
</p>
1862+
<p>
1863+
In general, it is not necessary to update TinyUF2 at every version change.
1864+
You can read the <a href="https://github.com/adafruit/tinyuf2/releases">release notes on GitHub</a> to see what has been changed.
1865+
Update if you've been told about a necessary change or a bug fix.
1866+
</p>
1867+
<p><strong><em>Note:</em></strong>
1868+
<em>CircuitPython 10 and later, on Espressif boards with 4MB flash, requires TinyUF2 0.33.0 or later.
1869+
The flash partition layout has changed (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/update-tinyuf2-bootloader-for-circuitpython-10-4mb-boards-only">details</a>).</em>
1870+
</p>
1871+
<p>
1872+
If TinyUF2 has never been installed on the board,
1873+
or it was removed by erasing or overwriting the flash,
1874+
it must be installed in order to flash <strong>.uf2</strong> files onto the board.
1875+
But you don't need the TinyUF2 bootloader to upload <strong>.bin</strong> files. They can be uploaded using the
1876+
built-in ROM bootloader, with the
1877+
<a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>
1878+
or <strong>esptool.py</strong>.
1879+
</p>
1880+
<p><strong><em>Warning:</em></strong>
1881+
<em>Installing the TinyUF2 bootloader will erase everything that was previously on the board.
1882+
Save any files in <strong>CIRCUITPY</strong> for which you don't have backups.</em>
1883+
</p>
1884+
<p>There are several ways to install the TinyUF2 bootloader on your board.
1885+
Check to see if your board's manufacturer provides specific instructions.
1886+
For Adafruit boards, consult the <em>Factory Reset</em> page
1887+
in the Learn Guide for your particular board (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/factory-reset">example</a>).
1888+
</p>
1889+
<p>The easiest way to install TinyUF2 is to use the <strong>OPEN INSTALLER</strong> button
1890+
(see above, in the CiruitPython sections).
1891+
You can also use the <a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>, or <strong>esptool.py</strong>,
1892+
as described in the Factory Reset page.
1893+
</p>
1894+
<li>If you are not using the <strong>OPEN INSTALLER</strong> button,
1895+
download the <strong>combined.bin</strong> file using the <strong>DOWNLOAD BOOTLOADER combined.bin</strong> button below.
1896+
(If you use <strong>OPEN INSTALLER</strong>, it will do the download itself.)</li>
1897+
<li>First, place board in ROM bootloader mode:
1898+
<ul>
1899+
<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>
1900+
<li>Press and <em>hold</em> the BOOT button (sometimes marked "B0").</li>
1901+
<li>Press and <em>release</em> the RESET button (sometimes marked "RST").</li>
1902+
<li>Release the BOOT button. This starts the ROM bootloader.</li>
1903+
</ul>
1904+
</li>
1905+
<li>Then proceed with <strong>OPEN INSTALLER</strong> or one of the other tools.</li>
1906+
<li>After the TinyUF2 firmware installation is complete, press the RESET button on the board.
1907+
A new drive <strong>BOOT</strong> drive should be visible in your file browser.</li>
1908+
</ul>
1909+
</li>
1910+
</ul>
1911+
1912+
<p>
1913+
After installing TinyUF2, enter the UF2 bootloader by double-clicking the RESET button.
1914+
On boards with an RGB status LED, you usually tap reset once, wait for the LED to turn purple, and tap
1915+
again before the purple goes away. On other boards, consult the board documentation.
1916+
</p>
1917+
1918+
<p>
1919+
If you are updating TinyUF2, look at <strong>INFO_UF2.TXT</strong> to verify the new version of TinyUF2,
1920+
by checking the version number.
1921+
Then you will need to copy the CircuitPython<strong>.uf2</strong> file to the <strong>BOOT</strong> drive.
1922+
</p>
1923+
<div>
1924+
<a class="download-button" href="https://adafruit-circuit-python.s3.amazonaws.com/bootloaders/esp32/espressif_esp32s2_devkitc_1/tinyuf2-espressif_esp32s2_devkitc_1-0.35.0-combined.bin">DOWNLOAD BOOTLOADER combined.bin<i class="fas fa-download" aria-hidden="true"></i></a>
1925+
</div>
1926+
</div>
1927+
1928+
18471929

18481930
</div>
18491931
</div>

‎board/espressif_esp32s2_devkitc_1_n4r2/index.html‎

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

18651865

18661866

1867+
1868+
<div class="section unrecommended">
1869+
<h3>Install, Repair, or Update UF2 Bootloader</h3>
1870+
<p>
1871+
Latest version: 0.35.0
1872+
</p>
1873+
<p>
1874+
<strong>The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs.
1875+
</strong>
1876+
The bootloader itself is not CircuitPython.
1877+
On Espressif boards, the UF2 bootloader is called <em>TinyUF2</em>.
1878+
If the TinyUF2 bootloader is installed, you can check its version by looking in
1879+
the <strong>INFO_UF2.TXT</strong> file when the <strong>BOOT</strong> drive is visible
1880+
(<strong>FTHRS2BOOT</strong>, <strong>MAGTAGBOOT</strong>, <strong>HOUSEBOOT</strong>, etc.)
1881+
</p>
1882+
<p>
1883+
In general, it is not necessary to update TinyUF2 at every version change.
1884+
You can read the <a href="https://github.com/adafruit/tinyuf2/releases">release notes on GitHub</a> to see what has been changed.
1885+
Update if you've been told about a necessary change or a bug fix.
1886+
</p>
1887+
<p><strong><em>Note:</em></strong>
1888+
<em>CircuitPython 10 and later, on Espressif boards with 4MB flash, requires TinyUF2 0.33.0 or later.
1889+
The flash partition layout has changed (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/update-tinyuf2-bootloader-for-circuitpython-10-4mb-boards-only">details</a>).</em>
1890+
</p>
1891+
<p>
1892+
If TinyUF2 has never been installed on the board,
1893+
or it was removed by erasing or overwriting the flash,
1894+
it must be installed in order to flash <strong>.uf2</strong> files onto the board.
1895+
But you don't need the TinyUF2 bootloader to upload <strong>.bin</strong> files. They can be uploaded using the
1896+
built-in ROM bootloader, with the
1897+
<a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>
1898+
or <strong>esptool.py</strong>.
1899+
</p>
1900+
<p><strong><em>Warning:</em></strong>
1901+
<em>Installing the TinyUF2 bootloader will erase everything that was previously on the board.
1902+
Save any files in <strong>CIRCUITPY</strong> for which you don't have backups.</em>
1903+
</p>
1904+
<p>There are several ways to install the TinyUF2 bootloader on your board.
1905+
Check to see if your board's manufacturer provides specific instructions.
1906+
For Adafruit boards, consult the <em>Factory Reset</em> page
1907+
in the Learn Guide for your particular board (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/factory-reset">example</a>).
1908+
</p>
1909+
<p>The easiest way to install TinyUF2 is to use the <strong>OPEN INSTALLER</strong> button
1910+
(see above, in the CiruitPython sections).
1911+
You can also use the <a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>, or <strong>esptool.py</strong>,
1912+
as described in the Factory Reset page.
1913+
</p>
1914+
<li>If you are not using the <strong>OPEN INSTALLER</strong> button,
1915+
download the <strong>combined.bin</strong> file using the <strong>DOWNLOAD BOOTLOADER combined.bin</strong> button below.
1916+
(If you use <strong>OPEN INSTALLER</strong>, it will do the download itself.)</li>
1917+
<li>First, place board in ROM bootloader mode:
1918+
<ul>
1919+
<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>
1920+
<li>Press and <em>hold</em> the BOOT button (sometimes marked "B0").</li>
1921+
<li>Press and <em>release</em> the RESET button (sometimes marked "RST").</li>
1922+
<li>Release the BOOT button. This starts the ROM bootloader.</li>
1923+
</ul>
1924+
</li>
1925+
<li>Then proceed with <strong>OPEN INSTALLER</strong> or one of the other tools.</li>
1926+
<li>After the TinyUF2 firmware installation is complete, press the RESET button on the board.
1927+
A new drive <strong>BOOT</strong> drive should be visible in your file browser.</li>
1928+
</ul>
1929+
</li>
1930+
</ul>
1931+
1932+
<p>
1933+
After installing TinyUF2, enter the UF2 bootloader by double-clicking the RESET button.
1934+
On boards with an RGB status LED, you usually tap reset once, wait for the LED to turn purple, and tap
1935+
again before the purple goes away. On other boards, consult the board documentation.
1936+
</p>
1937+
1938+
<p>
1939+
If you are updating TinyUF2, look at <strong>INFO_UF2.TXT</strong> to verify the new version of TinyUF2,
1940+
by checking the version number.
1941+
Then you will need to copy the CircuitPython<strong>.uf2</strong> file to the <strong>BOOT</strong> drive.
1942+
</p>
1943+
<div>
1944+
<a class="download-button" href="https://adafruit-circuit-python.s3.amazonaws.com/bootloaders/esp32/espressif_esp32s2_devkitc_1/tinyuf2-espressif_esp32s2_devkitc_1-0.35.0-combined.bin">DOWNLOAD BOOTLOADER combined.bin<i class="fas fa-download" aria-hidden="true"></i></a>
1945+
</div>
1946+
</div>
1947+
1948+
18671949

18681950
</div>
18691951
</div>

‎board/lilygo_tdisplay_s3_pro/index.html‎

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

19381938

19391939

1940+
1941+
<div class="section unrecommended">
1942+
<h3>Install, Repair, or Update UF2 Bootloader</h3>
1943+
<p>
1944+
Latest version: 0.35.0
1945+
</p>
1946+
<p>
1947+
<strong>The UF2 bootloader allows you to load CircuitPython, MakeCode, and Arduino programs.
1948+
</strong>
1949+
The bootloader itself is not CircuitPython.
1950+
On Espressif boards, the UF2 bootloader is called <em>TinyUF2</em>.
1951+
If the TinyUF2 bootloader is installed, you can check its version by looking in
1952+
the <strong>INFO_UF2.TXT</strong> file when the <strong>BOOT</strong> drive is visible
1953+
(<strong>FTHRS2BOOT</strong>, <strong>MAGTAGBOOT</strong>, <strong>HOUSEBOOT</strong>, etc.)
1954+
</p>
1955+
<p>
1956+
In general, it is not necessary to update TinyUF2 at every version change.
1957+
You can read the <a href="https://github.com/adafruit/tinyuf2/releases">release notes on GitHub</a> to see what has been changed.
1958+
Update if you've been told about a necessary change or a bug fix.
1959+
</p>
1960+
<p><strong><em>Note:</em></strong>
1961+
<em>CircuitPython 10 and later, on Espressif boards with 4MB flash, requires TinyUF2 0.33.0 or later.
1962+
The flash partition layout has changed (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/update-tinyuf2-bootloader-for-circuitpython-10-4mb-boards-only">details</a>).</em>
1963+
</p>
1964+
<p>
1965+
If TinyUF2 has never been installed on the board,
1966+
or it was removed by erasing or overwriting the flash,
1967+
it must be installed in order to flash <strong>.uf2</strong> files onto the board.
1968+
But you don't need the TinyUF2 bootloader to upload <strong>.bin</strong> files. They can be uploaded using the
1969+
built-in ROM bootloader, with the
1970+
<a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>
1971+
or <strong>esptool.py</strong>.
1972+
</p>
1973+
<p><strong><em>Warning:</em></strong>
1974+
<em>Installing the TinyUF2 bootloader will erase everything that was previously on the board.
1975+
Save any files in <strong>CIRCUITPY</strong> for which you don't have backups.</em>
1976+
</p>
1977+
<p>There are several ways to install the TinyUF2 bootloader on your board.
1978+
Check to see if your board's manufacturer provides specific instructions.
1979+
For Adafruit boards, consult the <em>Factory Reset</em> page
1980+
in the Learn Guide for your particular board (<a href="https://learn.adafruit.com/adafruit-esp32-s3-feather/factory-reset">example</a>).
1981+
</p>
1982+
<p>The easiest way to install TinyUF2 is to use the <strong>OPEN INSTALLER</strong> button
1983+
(see above, in the CiruitPython sections).
1984+
You can also use the <a href="https://adafruit.github.io/Adafruit_WebSerial_ESPTool/">Adafruit WebSerial ESPTool</a>, or <strong>esptool.py</strong>,
1985+
as described in the Factory Reset page.
1986+
</p>
1987+
<li>If you are not using the <strong>OPEN INSTALLER</strong> button,
1988+
download the <strong>combined.bin</strong> file using the <strong>DOWNLOAD BOOTLOADER combined.bin</strong> button below.
1989+
(If you use <strong>OPEN INSTALLER</strong>, it will do the download itself.)</li>
1990+
<li>First, place board in ROM bootloader mode:
1991+
<ul>
1992+
<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>
1993+
<li>Press and <em>hold</em> the BOOT button (sometimes marked "B0").</li>
1994+
<li>Press and <em>release</em> the RESET button (sometimes marked "RST").</li>
1995+
<li>Release the BOOT button. This starts the ROM bootloader.</li>
1996+
</ul>
1997+
</li>
1998+
<li>Then proceed with <strong>OPEN INSTALLER</strong> or one of the other tools.</li>
1999+
<li>After the TinyUF2 firmware installation is complete, press the RESET button on the board.
2000+
A new drive <strong>BOOT</strong> drive should be visible in your file browser.</li>
2001+
</ul>
2002+
</li>
2003+
</ul>
2004+
2005+
<p>
2006+
After installing TinyUF2, enter the UF2 bootloader by double-clicking the RESET button.
2007+
On boards with an RGB status LED, you usually tap reset once, wait for the LED to turn purple, and tap
2008+
again before the purple goes away. On other boards, consult the board documentation.
2009+
</p>
2010+
2011+
<p>
2012+
If you are updating TinyUF2, look at <strong>INFO_UF2.TXT</strong> to verify the new version of TinyUF2,
2013+
by checking the version number.
2014+
Then you will need to copy the CircuitPython<strong>.uf2</strong> file to the <strong>BOOT</strong> drive.
2015+
</p>
2016+
<div>
2017+
<a class="download-button" href="https://adafruit-circuit-python.s3.amazonaws.com/bootloaders/esp32/lilygo_tdisplay_s3_pro/tinyuf2-lilygo_tdisplay_s3_pro-0.35.0-combined.bin">DOWNLOAD BOOTLOADER combined.bin<i class="fas fa-download" aria-hidden="true"></i></a>
2018+
</div>
2019+
</div>
2020+
2021+
19402022

19412023
</div>
19422024
</div>

0 commit comments

Comments
 (0)