Improve and correct documentation

Author: RaBoom

doc/src/SUMMARY.md

@@ -4,4 +4,6 @@
 
 - [Development]()
 - [Hardware]()
+- [Assembly](./assembly.md)
+- [Bringup](./bringup.md)
 - [Calibration](./calibration.md)

doc/src/assembly.md

@@ -0,0 +1,23 @@
+# Assembly
+
+How to assemble the boards into the housings
+
+## Instructions
+- Test the scale to make sure that it generally works
+- Disassemble fully, keep the screws
+<p align="center">
+  <img src ="assets/disassembly.jpeg" width="600" alt="Partially disassembled scale">
+</p>
+
+- Swap over the wires to the new, already populated PCB
+- Screw the new PCB back in 
+<p align="center">
+  <img src ="assets/soldered.jpeg" width="600" alt="Soldered and semi-assembled scale">
+</p>
+
+- Measure the voltage input pins for shorts (to prevent stupid errors)
+- Power on the board with batteries or a lab bench power supply
+- Do the [Bringup](./bringup.md)
+- Close the housing and screw it shut, don't pinch any wires or strip any screws 
+- Do the [Calibration](./calibration.md)
+- Done!

doc/src/assets/disassembly.jpeg

@@ -0,0 +1,47 @@
+# Bringup 
+
+How to get the board from being assembled to being functional, using Windows, WSL and a ST-Link
+
+## Requirements on Windows ##
+- Working WSL2
+- ST-Link, with installed drivers (I used a ST-Link V2-1, borrowed from a Nucleo Board)
+- Install usbipd-win on windows: run `winget install --interactive --exact dorssel.usbipd-win` in a windows terminal
+- Install required packages in wsl: `sudo apt install build-essential`
+- Install rust: https://rustup.rs/
+- Install probe-rs: https://probe.rs/
+- Install OpenOCD in WSL: `sudo apt install openocd` in wsl
+- Download the SoftDevice for the chip from NRF (I used s113_nrf52_7.3.0_softdevice.hex)
+
+
+## Flashing on Windows ##
+- Connect the ST-Link
+- Follow these instructions to get the ST-Link connected to WSL: https://learn.microsoft.com/de-de/windows/wsl/connect-usb
+ - `usbipd list`
+ - `usbipd bind --busid <busid>`
+ - `usbipd attach --wsl --busid <busid>`
+- Connect the board to the ST-Link correctly
+- Power the board
+- Run `openocd -f /usr/share/openocd/scripts/interface/stlink.cfg -f /usr/share/openocd/scripts/target/nrf52.cfg`
+- In a seperate terminal run `telnet localhost 4444`
+- Use `targets` you can check that you can see the nrf52 target
+- Run `init`, `halt`, `nrf5 mass_erase`, `program /full/path/.../s113_nrf52_7.3.0_softdevice.hex verify`
+- Run `exit`in telnet shell
+- Exit OpenOCD with CTRL+C
+- Build and flash the code with `cargo run --bin proto1_0 --release`
+- Done! Further flashing etc. should not require reflashing the SoftDevice
+
+### Notes:
+- If you just want to flash the softdevice in one command you can do it like this: `openocd -f /usr/share/openocd/scripts/interface/stlink.cfg -f /usr/share/openocd/scripts/target/nrf52.cfg -c "init; halt; nrf5 mass_erase; program /full/path/.../s113_nrf52_7.3.0_softdevice.hex preverify verify; shutdown"`
+
+### Sources:
+- https://www.jentsch.io/nrf51822-flashen-mit-st-link-v2-und-openocd/
+- https://github.com/seemoo-lab/openhaystack/wiki/Flashing-nRF-with-OpenOCD---ST-Link
+- https://github.com/lupyuen/stm32bluepill-mynewt-sensor/blob/nrf52/scripts/nrf52/flash-boot.sh
+- https://www.youtube.com/watch?v=R5wub5ywzTU&t=197s
+- https://www.reddit.com/r/embedded/comments/1k9v4vr/stm32_cmake_stlinkv3pwr_on_windows_in_2025/?show=original
+- https://github.com/dorssel/usbipd-win/wiki/WSL-support
+- https://discuss.ardupilot.org/t/help-setting-up-openocd-with-st-link-in-wsl2/112271
+- https://hackmd.io/@aeefs2Y8TMms-cjTDX4cfw/r1fqAa_Da
+- https://learn.microsoft.com/de-de/windows/wsl/connect-usb
+
+

doc/src/assets/soldered.jpeg

@@ -21,7 +21,7 @@ characteristic. This should be the only writable characteristic. This sends the
 maximum weight but less than 150kg, the maximum capacity of the scale.
 1. Convert the known weight, in kg, to a 32-bit floating point number in little-endian format. Write
 `69 <your hex bytes here>` to the same characteristic as earlier. As an example, if your known
-weight were 100.0 kg, you would send `690000f042`.
+weight were 120.0 kg, you would send `690000f042`.
 1. If you mess up entering in either meaurement, feel free to resend the corresponding command.
 1. Once you're set, write `0x6A` to the same characteristic to save the calibration.
 1. At this point, disconnect from Hangman and test it out using the Tindeq mobile app or something