Initial commit

GEMINI.md

@@ -0,0 +1,28 @@
+# STM32 Bluepill Quickstart
+
+## Temporary files
+Create files and directories within the project temp directory e.g.: `~/.gemini/tmp/d9929d1c794fb414052498bc12a08fef640ff8b7c30d9190d0699962781facbf`
+
+## Compilation
+
+To compile the sketch, run the following command from the project root:
+
+```bash
+arduino-cli compile --fqbn STMicroelectronics:stm32:GenF1:pnum=BLUEPILL_F103CB,upload_method=OpenOCDDapLink --build-path /tmp/$(basename $(pwd)) .
+```
+
+## Flashing
+
+To flash the sketch use `openocd` to flash the sketch.
+
+```bash
+openocd -d2 -f interface/cmsis-dap.cfg -f target/stm32f1x.cfg -c "program {/tmp/$(basename $(pwd))/$(basename $(pwd)).ino.elf} verify reset exit"
+```
+
+## Viewing Logs
+
+The best way for me to read the logs is to capture the output from the serial port to a file, and then read that file.
+
+1. First, I'd configure the serial port settings without starting an interactive session using `stty`.
+2. Then, I'd use a command like `head` to read a specific number of lines from the serial port and save them to a temporary file. This command will exit automatically after reading the lines.
+3. Finally, I would use `read_file` to read the contents of that temporary file.