Move the 'working safely' section

Move this to the documentation folder. This only moves the content, but it does not update the references.
basilfx · Nov 21, 2024 · 7a8cd09 · 7a8cd09
1 parent 90b34b0
commit 7a8cd09
Show file tree

Hide file tree

Showing 11 changed files with 27 additions and 26 deletions.
diff --git a/README.md b/README.md
@@ -110,32 +110,6 @@ A version of DOOM was port to the IKEA TRÅDFRI MGM210L modules, including a
 custom contrller. The project is documented [here](https://next-hack.com/index.php/2021/06/12/lets-port-doom-to-an-ikea-tradfri-lamp/)
 and the source code can be found [here](https://github.com/next-hack/MG21DOOM).
 
-## Working safely
-If you plan to leave the board in-place, and run your own light bulb firmware,
-never connect external devices (e.g. debugger or serial adapter) to a light
-bulb that is plugged in. Due to different voltage levels, you could destroy
-your devices.
-
-If you want to connect an external device, ensure that it is properly isolated
-(e.g. using a optocoupler).
-
-I have designed a board that you could use to isolate UART signals. You can
-find it [here](pcbs/isolator).
-
-### Test setup
-My setup (the small board is a UART isolator):
-
-[<img src="images/setup.jpg" alt="Test setup" width="256">](images/setup.jpg)
-
-My safer setup, including debugger (LED is connected to same pin as it would in
-the GU10 light):
-
-[<img src="images/setup2.jpg" alt="Safer test setup" width="256">](images/setup2.jpg)
-
-Two soldered development boards that I use nowadays:
-
-[<img src="images/setup3.jpg" alt="Safer test setup" width="256">](images/setup3.jpg)
-
 ## Sources
 I have gathered some information from the following sources:
 

diff --git a/images/setup3.jpg → contrib/pcbs/devboard/images/setup3.jpg b/images/setup3.jpg → contrib/pcbs/devboard/images/setup3.jpg
diff --git a/docs/firmware_reversing/screenshot_1.png → ...irmware_reversing/images/screenshot_1.png b/docs/firmware_reversing/screenshot_1.png → ...irmware_reversing/images/screenshot_1.png
diff --git a/docs/firmware_reversing/screenshot_2.png → ...irmware_reversing/images/screenshot_2.png b/docs/firmware_reversing/screenshot_2.png → ...irmware_reversing/images/screenshot_2.png
diff --git a/docs/firmware_reversing/screenshot_3.png → ...irmware_reversing/images/screenshot_3.png b/docs/firmware_reversing/screenshot_3.png → ...irmware_reversing/images/screenshot_3.png
diff --git a/docs/firmware_reversing/screenshot_4.png → ...irmware_reversing/images/screenshot_4.png b/docs/firmware_reversing/screenshot_4.png → ...irmware_reversing/images/screenshot_4.png
diff --git a/docs/firmware_reversing/screenshot_5.png → ...irmware_reversing/images/screenshot_5.png b/docs/firmware_reversing/screenshot_5.png → ...irmware_reversing/images/screenshot_5.png
diff --git a/docs/working_safely/README.md b/docs/working_safely/README.md
@@ -0,0 +1,27 @@
+# Working safely
+
+## Introduction
+If you plan to leave the board in-place, and run your own light bulb firmware,
+never connect external devices (e.g. debugger or serial adapter) to a light
+bulb that is plugged in. Due to different voltage levels, you could destroy
+your devices.
+
+If you want to connect an external device, ensure that it is properly isolated
+(e.g. using a optocoupler).
+
+I have designed a board that you could use to isolate UART signals. You can
+find it [here](pcbs/isolator).
+
+### Test setup
+My setup (the small board is a UART isolator):
+
+[<img src="images/setup.jpg" alt="Test setup" width="256">](images/setup.jpg)
+
+My safer setup, including debugger (LED is connected to same pin as it would in
+the GU10 light):
+
+[<img src="images/setup2.jpg" alt="Safer test setup" width="256">](images/setup2.jpg)
+
+Two soldered development boards that I use nowadays:
+
+[<img src="images/setup3.jpg" alt="Safer test setup" width="256">](images/setup3.jpg)
diff --git a/images/led.jpg → docs/working_safely/images/led.jpg b/images/led.jpg → docs/working_safely/images/led.jpg
diff --git a/images/setup.jpg → docs/working_safely/images/setup.jpg b/images/setup.jpg → docs/working_safely/images/setup.jpg
diff --git a/images/setup2.jpg → docs/working_safely/images/setup2.jpg b/images/setup2.jpg → docs/working_safely/images/setup2.jpg