From f88fc89465b86f3a029d593427fb57ad59201e4f Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Fri, 15 Sep 2023 19:12:32 +0200 Subject: Start article on esp32-pro --- source/index.rst | 1 + source/microcontrollers/index.rst | 9 +++++++++ source/microcontrollers/olimex-esp32-pro/index.rst | 20 ++++++++++++++++++++ 3 files changed, 30 insertions(+) create mode 100644 source/microcontrollers/index.rst create mode 100644 source/microcontrollers/olimex-esp32-pro/index.rst diff --git a/source/index.rst b/source/index.rst index d70e647..e93df5d 100644 --- a/source/index.rst +++ b/source/index.rst @@ -65,6 +65,7 @@ Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. :maxdepth: 2 :caption: Contents: + microcontrollers/index self_hosting/index bibliography/index diff --git a/source/microcontrollers/index.rst b/source/microcontrollers/index.rst new file mode 100644 index 0000000..2344463 --- /dev/null +++ b/source/microcontrollers/index.rst @@ -0,0 +1,9 @@ +############## + Microcontrollers +############## + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + + olimex-esp32-pro/index diff --git a/source/microcontrollers/olimex-esp32-pro/index.rst b/source/microcontrollers/olimex-esp32-pro/index.rst new file mode 100644 index 0000000..da977a2 --- /dev/null +++ b/source/microcontrollers/olimex-esp32-pro/index.rst @@ -0,0 +1,20 @@ +****************** + Olimex ESP32-PRO +****************** + +Board: OLIMEX ESP32-EVB +Upload Speed: 115200 +Flash Frequency: 80MHz +Partition Scheme: Default +Core Debug Level None +Erase All Flash Before Sketch Upload: Disabled + +Version 2.0.9 + +See also +-------- + +* ``_ + +.. + vim: set filetype=rst: -- cgit v1.2.3 From 207dff3ef34c6f501f4b88ceacf2f234c13f4d1c Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Fri, 2 Aug 2024 09:02:34 +0200 Subject: Cleanup the notes on the Olimex ESP32-PRO --- source/microcontrollers/index.rst | 4 ++-- source/microcontrollers/olimex-esp32-pro/index.rst | 18 +++++++++++------- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/source/microcontrollers/index.rst b/source/microcontrollers/index.rst index 2344463..0e5ba7c 100644 --- a/source/microcontrollers/index.rst +++ b/source/microcontrollers/index.rst @@ -1,6 +1,6 @@ -############## +################## Microcontrollers -############## +################## .. toctree:: :maxdepth: 2 diff --git a/source/microcontrollers/olimex-esp32-pro/index.rst b/source/microcontrollers/olimex-esp32-pro/index.rst index da977a2..c6ac7a0 100644 --- a/source/microcontrollers/olimex-esp32-pro/index.rst +++ b/source/microcontrollers/olimex-esp32-pro/index.rst @@ -2,14 +2,18 @@ Olimex ESP32-PRO ****************** -Board: OLIMEX ESP32-EVB -Upload Speed: 115200 -Flash Frequency: 80MHz -Partition Scheme: Default -Core Debug Level None -Erase All Flash Before Sketch Upload: Disabled +As of September 2023 there was a bug in the Espressif esp32 package for +Arduino that meant that it wasn't working with the Olimex ESP32-PRO +board, the workaround was to use Version 2.0.9 of the package. -Version 2.0.9 +These are the settings used: + +:Board: OLIMEX ESP32-EVB +:Upload Speed: 115200 +:Flash Frequency: 80MHz +:Partition Scheme: Default +:Core Debug Level: None +:Erase All Flash Before Sketch Upload: Disabled See also -------- -- cgit v1.2.3 From 3f772b7b88f4992091a6397644ad2beb96ad9c10 Mon Sep 17 00:00:00 2001 From: Elena ``of Valhalla'' Grandi Date: Fri, 2 Aug 2024 15:58:07 +0200 Subject: Writing code on the Maple Mini --- source/microcontrollers/index.rst | 1 + source/microcontrollers/maple_mini/index.rst | 103 +++++++++++++++++++++++++++ 2 files changed, 104 insertions(+) create mode 100644 source/microcontrollers/maple_mini/index.rst diff --git a/source/microcontrollers/index.rst b/source/microcontrollers/index.rst index 0e5ba7c..a44719c 100644 --- a/source/microcontrollers/index.rst +++ b/source/microcontrollers/index.rst @@ -6,4 +6,5 @@ :maxdepth: 2 :caption: Contents: + maple_mini/index olimex-esp32-pro/index diff --git a/source/microcontrollers/maple_mini/index.rst b/source/microcontrollers/maple_mini/index.rst new file mode 100644 index 0000000..bf8a9b2 --- /dev/null +++ b/source/microcontrollers/maple_mini/index.rst @@ -0,0 +1,103 @@ +************ + Maple Mini +************ + +Programming with OpenOCD +======================== + +The Maple Mini can be programmed using OpenOCD_ and a suitable +programmer. + +.. _OpenOCD: https://openocd.sourceforge.io/ + +To program a Maple Mini the following PINs should be connected: + +==== === +Prog MM +==== === +GND GND +3V3 Vcc +MOSI D22 +CLK D21 +==== === + +If the maple mini still has the original firmware it may be necessary to +press and hold the button (at least 1 s) while resetting the board, to +enter DMU mode. + +Create the file ``openocd.cfg`` according to the programmer you are +using, and then run:: + + openocd -f openocd.cfg + telnet localhost 4444 + +To then write ``.elf`` to the Maple Mini use the following +commands:: + + reset halt + stm32f1x unlock 0 + reset halt + flash write_image erase .elf + stm32f1x lock 0 + reset halt + +With an ST-Link V2 Clone from Baite +----------------------------------- + +The required PINs on the ST-Link V2 Clone from Baite are as follows, +with the notch on the left:: + + +------+ + | 1 2 | 3V3 + 5V | 3 4 | CLK (MM 21) + 5 6 | MOSI (MM 22) + GND | 7 8 | + | 9 10 | + +------+ + +``openocd.cfg`` should have the following contents:: + + source [find interface/stlink.cfg] + + source [find target/stm32f1x.cfg] + + +With a Bus Pirate v3.6 +---------------------- + +``openocd.cfg`` should have the following contents:: + + source [find interface/buspirate.cfg] + + buspirate_port /dev/ttyUSB0 + buspirate_vreg 1 + buspirate_mode normal + transport select swd + + source [find target/stm32f1x.cfg] + +Programmin with gnuk/tool/stlinkv2.py +===================================== + +gnuk also provides a tool to write binaries; first the board should be +unlocked with:: + + ./stlinkv2.py -u + +then reset (while pressing the button), and the flash erased:: + + ./stlinkv2.py -e + +and finally it can be written with:: + + ./stlinkv2.py .elf + +See also +======== + +* https://web.archive.org/web/20150502182337/http://nodonogard.blogspot.com/2014/08/writting-gnuk-binary-to-fst-01-using-st.html +* https://www.earth.li/~noodles/blog/2017/02/gnuk-on-maple-mini.html +* https://www.earth.li/~noodles/blog/2015/08/program-fst01-with-buspirate.html + +.. + vim: set filetype=rst: -- cgit v1.2.3