Merge pull request #1 from gbr1/cleanup

WIP: cleanup

Author: gbr1

Blink_fast.bin

@@ -0,0 +1,34 @@
+# Flashing firmware on STM32 via UART
+
+### How to
+
+The steps to follow in order to flash a new firmware (.bin) file on STM32 are the following:
+
+_Uploading the files_
+Please install mpremote to upload files on nano-ESP32 especially for binaries
+
+```shell
+(venv)$ pip install mpremote
+```
+to upload a file:
+``` shell
+(venv)$ mpremote connect "COM1" fs cp firmware.bin :firmware.bin
+```
+
+_Hardware_
+* Connect STM32 _Boot0_ pin to VDD 3V3 or connect _Boot0_ to _D2_ pin (nano)
+* Press _Reset_ button on Nucleo board or connect STM32 Reset pin to _D3_ (nano)
+* Connect nano _TX_ pin to STM32 _D2_ (UART1 RX) pin
+* Connect nano _RX_ pin to STM32 _D8_ (UART1 TX) pin
+* Connect nano _GND_ to STM32 _GND_
+
+_Software_
+* Use `STM32_startCommunication` to connect to STM32
+* Perform a memory erase (eg. mass extended erase `STM32_eraseMEM(0xFFFF)`)
+* Write your .bin file: `STM32_writeMEM("Blink_fast.bin")`
+
+If _Boot0_ is wired to 3V3, disconnect it and press STM32 _Reset_ pin
+
+### Tested on
+
+* nano-ESP32 STM32-F401RE

FLASH.md

@@ -0,0 +1,21 @@
+from sys import exit
+from stm32_flash import *
+
+ans = STM32_startCommunication()
+if ans == STM32_NACK:
+    print("Cannot etablish connection with STM32")
+    exit(-1)
+
+print('\nSTM32 FOUND')
+
+print('\nSTM32 GET ID')
+id_ = STM32_getID()
+print(id_.hex())
+
+print('\nSTM32 GET VERSION')
+ver = STM32_getVER()
+print(ver.hex())
+
+print('\nSTM32 GET')
+get_all = STM32_get()
+print(get_all.hex())

examples/check_stm32.py

@@ -0,0 +1,12 @@
+from sys import exit
+from stm32_flash import *
+
+ans = STM32_startCommunication()
+if ans == STM32_NACK:
+    print("Cannot etablish connection with STM32")
+    exit(-1)
+
+print('\nSTM32 FOUND')
+
+print("\nREADING 10 MEM PAGES")
+STM32_readMEM(10)

examples/read_mem.py

@@ -0,0 +1,19 @@
+from sys import exit
+from stm32_flash import *
+
+ans = STM32_startCommunication()
+if ans == STM32_NACK:
+    print("Cannot etablish connection with STM32")
+    exit(-1)
+
+print('\nSTM32 FOUND')
+
+print('\nERASING MEM')
+STM32_eraseMEM(0xFFFF)
+
+print("\nWRITING MEM")
+STM32_writeMEM("Blink_fast.bin")
+print("\nDONE")
+print("\nLower Boot0 and reset STM32")
+
+STM32_endCommunication()