typos, updated getting started (#4)

foenich · web-flow · commit 081fc36e5281 · 2025-05-28T11:14:36.000+02:00
diff --git a/docs/images/hardware/overview.png b/docs/images/hardware/overview.png
diff --git a/docs/index.md b/docs/index.md
@@ -91,7 +91,7 @@ You would have all capabilities like PUP Packs, FlexDMD, etc.
 [![Watch the video](https://img.youtube.com/vi/MTMMOd1anZY/hqdefault.jpg)](https://youtu.be/MTMMOd1anZY)
 *Click the image to watch the video on YouTube.*
 
-![Overview Pic](https://github.com/PPUC/.github/raw/main/profile/images/overview.png)
+![Overview pic](images/hardware/overview.png)
 
 ## Licence
 
diff --git a/docs/ppuc/getting_started.md b/docs/ppuc/getting_started.md
@@ -16,37 +16,39 @@ protocol enhances the DOF protocol which is known from the virtual pinball world
 
 ## Get IO Boards
 
-Dependeing on your decisions abouve, you you might need different IO boards and a different amount.
-The entire hardware is open source and you can order the boards from your prefered PCB manufacturer.
+Depending on your decisions above, you you might need different IO boards and a different amount.
+The entire hardware is open source and you can order the boards from your preferred PCB manufacturer.
 Gerber and BOM files are part of the repositories:
 
 - [IO_16_8_1](https://github.com/PPUC/Hardware_IO_16_8_1)
 - [IO_16x8_matrix](https://github.com/PPUC/Hardware_IO_16x8_matrix)
 - [Out_8X10](https://github.com/PPUC/Hardware_Out_8x10)
 - [Opto_16](https://github.com/PPUC/Hardware_Opto_16)
 
-## Flash the IO Board Firware
-
-Download the latest firmware for your boards from https://github.com/PPUC/io-boards/releases/latest
-
-Pres and hold the `Boot` button of your board and connect it to your computer via USB.
-Release the button after a removable mass storage device is detected by your computer.
-Copy the appropriate `uf2` file from the download above to that mass storage device.
-The board will automatically flash the firmware and reboot.
-Repeat that procedure for every board.
-
 ## Wiring the boards
 
-todo:
-
 - Power
 - RS485 bus
 - Coils
 - Switches
 - Lamps
 - Motors
 
-todo: Explain the board addresses and BUS termination.
+For more details read the [hardware documentation](../ppuc_hardware/index.md).
+
+## Flash the IO Board Firware
+
+To bring "life" into the PPUC boards they need to get some software. All the boards gets the same firmware. Details about what they shall do and what they are connected to, are set by the config file which is generated by the config tool. This will be used to initialize the boards on start up.
+
+The boards are distinguished by an address. This must be set by DIP switches on the board. Every board must have a different address.
+
+Download the latest firmware for your boards from https://github.com/PPUC/io-boards/releases/latest
+
+Press and hold the `Boot` button of your board and connect it to your computer via USB.
+Release the button after a removable mass storage device is detected by your computer.
+Copy the appropriate `uf2` file from the download above to that mass storage device.
+The board will automatically flash the firmware and reboot.
+Repeat that procedure for every board.
 
 ## "CPU"
 
diff --git a/docs/ppuc_hardware/index.md b/docs/ppuc_hardware/index.md
@@ -64,9 +64,9 @@ To get some sound to your ears several speakers are used with an amplifier that
 ## Specific Hardware of the PPUC Project
 We designed some specific PCBs for PPUC project although they might be useful in other applications as well. Here is an overview what is available and what they can do. Fore more information there is a detailed description available for each PCB.
 
-* [IO_16_8_1](./io_16_8_1/): most basic PCB, always needed. Uses for reading switches, driving solenoids and control one LED strip.
+* [IO_16_8_1](./io_16_8_1/): most basic PCB, always needed. Used for reading switches, driving solenoids and control one LED strip.
 * [IO_16x8_matrix](./io_16x8_matrix/): convenient if a switch matrix is used. Especially if the original cable harness shall be used. Can control a 16x8 switch matrix. Or use for 16 inputs and 8 outputs. Also can control one LED strip.
-* [Out_8x10](./out_8x10/): convenient if a lamp matrix is used. Especially if the original cable harness shall be used. Can control a 8x10 lamp matrix [^f1] (only LEDs, no incandescent light bulbs!). Or use for 8 high side outputs and 10 low side outputs. Also can control one LED strip.
+* [Out_8x10](./out_8x10/): convenient if a lamp matrix is used. Especially if the original cable harness shall be used. Can control a 8x10 lamp matrix (only LEDs, no incandescent light bulbs!). Or use for 8 high side outputs and 10 low side outputs. Also can control one LED strip.
 * [Opto_16](./opto_16/): used to directly attach optical switches like opto couplers or LED transmitter/receiver pairs.
 
 The following table shows how many functions can be done with wich PCB. With that table you can estimate how many PCBs you need for your specific project. Just count the needed solenoids, flashers, lamps and switches. Take into account if you want to use controlled LED strips vs LED matrix vs direct LED drivers (mostly a mixture is used). Also think about direct switches vs switch matrix. And take into account if you have original opto boards from your pin or not.
