Cleanup, Refactoring, Silkscreen update

- Code refactor, still far from great but a bit less crappy
- Unify behavior - Mouse Zoom feature was made toggle and
  moved from ALT to Right ALT + Right CTRL to avoid interfering
  with OS
- Added optional screensaver "Pong" mode, prevents sleep and it's fun
- Updated README
- Added more visible pin1 marking on PCB for digital isolator
- Marked pins to solder with a star *
- Added checksum and version format support for flash config

Author: Hrvoje Cavrak

README.md

@@ -73,17 +73,23 @@ This will make the corresponding Pico board enter the bootloader upgrade mode an
 
 ## Misc features
 
-#### Mouse slowdown
+### Mouse slowdown
 
 Ever tried to move that YT video slider to a specific position but your mouse moves too jumpy and suddenly you are moving your hand super-carefully like you're 5 and playing "Operation" all over again?
 
-**Holding right ALT** while moving the mouse will slow it down considerably, enabling you to get the finer precision work done and still have your mouse moving quickly otherwise.
+**Press right CTRL + right ALT** to toggle a slow-mouse mode. The mouse pointer will slow down considerably, enabling you to get the finer precision work done and still have your mouse moving normally by quickly pressing the same keys again.
 
-#### Switch Lock
+### Switch Lock
 
 If you want to lock yourself to one screen, use ```RIGHT CTRL + L```.
 This will make sure you won't accidentally leave your current screen. To turn off, press the same key combo again.
 
+### Screensaver
+
+Supposedly built in to prevent computer from entering standby, but truth be told - it is just fun to watch. Off by default, will make your mouse pointer bounce around the screen like a Pong ball. When enabled, it activates after a period of inactivity defined in user config header and automatically switches off as soon as you send any output towards that screen. 
+
+![Image](img/screensaver.gif)
+
 ## Hardware
 
 [The circuit](schematics/DeskHop.pdf) is based on two Raspberry Pi Pico boards, chosen because they are cheap (4.10 € / pc), can be hand soldered and most suppliers have them in stock.
@@ -152,22 +158,23 @@ The standard process to do that is using isopropyl alcohol and an old toothbrush
 
 ## Usage guide
 
-#### Keyboard shortcuts
+### Keyboard shortcuts
 
 _Firmware upgrade_
 - ```Right Shift + F12 + Left Shift + A``` - put board A in FW upgrade mode
 - ```Right Shift + F12 + Left Shift + B``` - put board B in FW upgrade mode
 
 _Usage_
-- ```Right ALT``` - mouse slows down while it's pressed
+- ```Right CTRL + Right ALT``` - Toggle slower mouse mode
 - ```Right CTRL + L``` - Lock/Unlock mouse desktop switching
 - ```Caps Lock``` - Switch between outputs
 
 _Config_
 - ```Right Shift + F12 + D``` - remove flash config
 - ```Right Shift + F12 + Y``` - save screen switch offset
+- ```Right Shift + F12 + S``` - turn on/off screensaver option
 
-#### Switch cursor height calibration
+### Switch cursor height calibration
 
 This step is not required, but it can be handy if your screens are not perfectly aligned or differ in size. The objective is to have the mouse pointer come out at exactly the same height.
 
@@ -177,11 +184,11 @@ Just park your mouse on the LARGER screen at the height of the smaller/lower scr
 
 Repeat for the bottom border (if it's above the larger screen's border). This will get saved to flash and it should keep this calibration value from now on.
 
-#### Other configuration
+### Other configuration
 
 Mouse speed can now be configured per output screen and per axis. If you have multiple displays under Linux, your X speed is probably too fast, so you need to configure it in user_config.h and rebuild. In the future, this will be configurable without having to do that.
 
-#### Functional verification
+### Functional verification
 
 When you connect a new USB peripheral, the board will flash the led twice, and instruct the other board to do the same. This way you can test if USB and outgoing communication works for each board.
 
@@ -239,7 +246,7 @@ There are several software alternatives you can use if that works in your partic
 - Not tested with a wide variety of devices, I don't know how it will work with your hardware. There is a reasonable chance things might not work out-of-the-box. 
 - Advanced keyboards (with knobs, extra buttons or sliders) will probably face issues where this additional hardware doesn't work.
 - Super-modern mice with 300 buttons might see some buttons not work as expected.
-- NOTE: Both computers need to be connected and powered on for this to work (as each board gets powered by the computer it plugs into).
+- NOTE: Both computers need to be connected and provide power to the USB for this to work (as each board gets powered by the computer it plugs into). Many desktops and laptops will provide power even when shut down nowadays. If you need to run with one board fully disconnected, you should be able to use a USB hub to plug both keyboard and mouse to a single port.
 
 ## Progress
 
@@ -252,6 +259,7 @@ Planned features:
 - ~~Support for USB hubs and single-sided operation~~
 - Configurable screens (partially)
 - ~~Permament configuration stored in flash~~
+- Better support for keyboards with knobs and mice with mickeys
 - Unified firmware for both Picos
 - ... and more!
 

binaries/board_A.uf2

@@ -210,11 +210,11 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 5fd3f62a-d98c-4462-b185-53ee62a95831)
     )
-    (fp_text user "GP12" (at -13.2 13.97 45) (layer "F.SilkS")
+    (fp_text user " GP12*" (at -13.2 13.97 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 654bded7-dc3d-4110-b5c8-9933d7968d40)
     )
-    (fp_text user "GND" (at -12.8 19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 7a76e090-db64-49ef-9c3a-8fddc8374f01)
     )
@@ -234,19 +234,19 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 9af6d6e3-843a-4bca-90bd-2c3b9f316a84)
     )
-    (fp_text user "GP15" (at -13.054 24.13 45) (layer "F.SilkS")
+    (fp_text user " GP15*" (at -13.054 24.13 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 9da49d49-7de1-42a4-91fb-7720c8535bf6)
     )
-    (fp_text user "GND" (at 12.8 19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at 12.8 19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 9ec3ebbf-2742-4ec9-9764-07554be8b7fa)
     )
-    (fp_text user "GND" (at -12.8 -6.35 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 -6.35 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp a268ddcc-2c85-484d-bb30-2c57a598aa04)
     )
-    (fp_text user "GP13" (at -13.054 16.51 45) (layer "F.SilkS")
+    (fp_text user " GP13*" (at -13.054 16.51 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp a57e760a-aacf-4400-923a-ac969c8333f6)
     )
@@ -286,11 +286,11 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp c5d36558-3396-4928-b429-c319485ac106)
     )
-    (fp_text user "VBUS" (at 13.3 -24.2 45) (layer "F.SilkS")
+    (fp_text user " VBUS*" (at 13.3 -24.2 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp c5dbf120-2592-4aa5-ba0e-17d002b6126a)
     )
-    (fp_text user "GND" (at -12.8 -19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 -19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp ced39d21-201b-4efd-a857-444103e82d38)
     )
@@ -306,19 +306,19 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp e7db89ba-8097-461c-922f-efe95c69b626)
     )
-    (fp_text user "3V3" (at 12.9 -13.9 45) (layer "F.SilkS")
+    (fp_text user " 3V3*" (at 12.9 -13.9 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp eba83c67-b501-49f2-b261-9eabd4774e8b)
     )
-    (fp_text user "GND" (at 12.8 -19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at 12.8 -19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp ebec5c26-3696-4fb8-bce4-7240f2a1628b)
     )
     (fp_text user "RUN" (at 13 1.27 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp ee08acb9-4187-403c-977d-30480b9f54e8)
     )
-    (fp_text user "GP14" (at -13.1 21.59 45) (layer "F.SilkS")
+    (fp_text user " GP14*" (at -13.1 21.59 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp f416675b-3513-4287-a967-d510ec90166f)
     )
@@ -600,23 +600,23 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 04258d86-db8d-4f2f-83cf-9be5258ae56e)
     )
-    (fp_text user "GND" (at 12.8 -19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at 12.8 -19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 06d9de45-f0bc-4bab-bbd3-4d7fd75dc0de)
     )
     (fp_text user "CLK" (at -5.08 27.432) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 080eb970-3605-4dea-8a86-d0f5e211360c)
     )
-    (fp_text user "GP15" (at -13.054 24.13 45) (layer "F.SilkS")
+    (fp_text user " GP15*" (at -13.054 24.13 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 0eb03dac-5681-444f-b662-bd902e4a78d6)
     )
     (fp_text user "GP18" (at 13.054 16.51 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 244993d6-b401-400c-9c81-52250a283542)
     )
-    (fp_text user "VBUS" (at 13.3 -24.2 45) (layer "F.SilkS")
+    (fp_text user " VBUS*" (at 13.3 -24.2 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 29420bbe-3d5e-48c4-8f10-f791ece49ffd)
     )
@@ -640,7 +640,7 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 42ae899d-cb96-4cf6-b779-72e6029879ca)
     )
-    (fp_text user "GND" (at -12.8 19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 4dba1d28-fd16-4cfc-a36d-02e78edede5b)
     )
@@ -652,27 +652,27 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 5ae03de5-12f1-445f-a4d7-0534f3b50b2c)
     )
-    (fp_text user "GND" (at -12.8 -19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 -19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 5e0af269-21d7-4b63-b85d-a427da8e3c7e)
     )
-    (fp_text user "GP17" (at 13.054 21.59 45) (layer "F.SilkS")
+    (fp_text user " GP17*" (at 13.054 21.59 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 60192e7d-24f9-415f-972e-4eab77a5b5e7)
     )
     (fp_text user "GP4" (at -12.8 -11.43 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 69e44965-b51f-4579-a420-34c32d41c682)
     )
-    (fp_text user "GND" (at -12.8 6.35 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 6.35 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 6a08809b-e049-49ec-a689-fecdb644c04e)
     )
     (fp_text user "GP8" (at -12.8 1.27 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 6eac192f-b906-44eb-85a6-d39b2e567c1d)
     )
-    (fp_text user "GP14" (at -13.1 21.59 45) (layer "F.SilkS")
+    (fp_text user " GP14*" (at -13.1 21.59 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 704211ed-8e53-4fc9-8c55-04f6d1e97075)
     )
@@ -700,15 +700,15 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 924973f6-cb24-4d5e-9b4f-944cd7b8d3c2)
     )
-    (fp_text user "3V3" (at 12.9 -13.9 45) (layer "F.SilkS")
+    (fp_text user " 3V3*" (at 12.9 -13.9 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 9916d5ae-1ea5-4b41-aa70-6a7f9b6c33e5)
     )
-    (fp_text user "GP16" (at 13.054 24.13 45) (layer "F.SilkS")
+    (fp_text user " GP16*" (at 13.054 24.13 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp 99bb43bd-b729-4948-9bb2-e8ae89878b0c)
     )
-    (fp_text user "GND" (at -12.8 -6.35 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at -12.8 -6.35 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp bae5cebf-f67e-458f-bc62-d2ede84b1ad3)
     )
@@ -732,7 +732,7 @@
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp dcfd0f66-777c-43b2-b1d9-87dd102c9f3f)
     )
-    (fp_text user "GND" (at 12.8 19.05 45) (layer "F.SilkS")
+    (fp_text user " GND*" (at 12.8 19.05 45) (layer "F.SilkS")
         (effects (font (size 0.8 0.8) (thickness 0.15)))
       (tstamp e1a37e64-c2ff-4550-aad7-7eee1cfd9296)
     )
@@ -1054,7 +1054,7 @@
     (property "ki_keywords" "cap capacitor")
     (path "/3c58f69e-1b44-4a9e-8696-820df6d6d00b")
     (attr smd)
-    (fp_text reference "C2" (at 3.5429 0.0254) (layer "F.SilkS")
+    (fp_text reference "C2" (at 0.134809 1.830335) (layer "F.SilkS")
         (effects (font (size 1 1) (thickness 0.15)))
       (tstamp 06cb8b2c-1271-446d-a93d-130a270fe442)
     )
@@ -1602,7 +1602,7 @@
     (property "ki_keywords" "cap capacitor")
     (path "/fb534856-14b0-4379-bd15-7952c4f76624")
     (attr smd)
-    (fp_text reference "C1" (at 3.556 0.0508) (layer "F.SilkS")
+    (fp_text reference "C1" (at -0.099564 -1.727201) (layer "F.SilkS")
         (effects (font (size 1 1) (thickness 0.15)))
       (tstamp 2a770326-88ad-4947-9ace-cdc0b6ff3bb8)
     )
@@ -5352,6 +5352,8 @@
     )
 
     (stroke (width 0) (type solid)) (fill solid) (layer "F.SilkS") (tstamp c5383451-e798-427e-8631-6dd983e845c0))
+  (gr_circle (center 64.048728 81.041328) (end 64.455128 81.041328)
+    (stroke (width 0.12) (type solid)) (fill solid) (layer "F.SilkS") (tstamp d88e0c1e-780a-4330-9e02-0d8f43cbcef0))
   (gr_poly
     (pts
       (xy 71.346351 110.357574)
@@ -6069,6 +6071,9 @@
   (gr_text "DeskHop - Keyboard/Mouse Switch\n\nby Hrvoje Cavrak, 12/2023\n\nhttps://github.com/hrvach" (at 64.9732 96.266) (layer "B.SilkS") (tstamp e86cc18b-e914-42f8-adc9-6ea2bbb55ee5)
     (effects (font (size 1.1 1.1) (thickness 0.15)) (justify left bottom mirror))
   )
+  (gr_text "*" (at 60.4774 76.708) (layer "F.SilkS") (tstamp 0c6253e3-41c8-4ad8-a815-57aa39b7d021)
+    (effects (font (size 1 1) (thickness 0.15)) (justify left bottom))
+  )
   (gr_text "PC 1" (at 83.9216 46.7868) (layer "F.SilkS") (tstamp 179b2c6b-34d3-4f8d-9920-6b082e4f9180)
     (effects (font (size 0.8 0.8) (thickness 0.15)) (justify left bottom))
   )
@@ -6084,6 +6089,9 @@
   (gr_text "DATA" (at 63.0428 99.9744 45) (layer "F.SilkS") (tstamp 6a8636ed-7847-4f79-be68-902fb28046b3)
     (effects (font (size 0.8 0.8) (thickness 0.15)))
   )
+  (gr_text "*" (at 72.9488 76.708) (layer "F.SilkS") (tstamp 7bf68895-0aeb-4dda-aa66-265c186f64a3)
+    (effects (font (size 1 1) (thickness 0.15)) (justify left bottom))
+  )
   (gr_text "A" (at 68.834 53.34) (layer "F.SilkS") (tstamp cb5b8470-d35e-410c-b050-6e152f7e6a4c)
     (effects (font (size 2 2) (thickness 0.15)) (justify left bottom))
   )

binaries/board_B.uf2

@@ -1,6 +1,6 @@
 {
   "board": {
-    "active_layer": 0,
+    "active_layer": 37,
     "active_layer_preset": "All Layers",
     "auto_track_width": true,
     "hidden_netclasses": [],

img/screensaver.gif

@@ -1,12 +1,12 @@
 %TF.GenerationSoftware,KiCad,Pcbnew,7.0.9*%
-%TF.CreationDate,2023-12-24T22:12:45+01:00*%
+%TF.CreationDate,2024-01-21T01:35:16+01:00*%
 %TF.ProjectId,DeskHop,4465736b-486f-4702-9e6b-696361645f70,rev?*%
 %TF.SameCoordinates,Original*%
 %TF.FileFunction,Copper,L2,Bot*%
 %TF.FilePolarity,Positive*%
 %FSLAX46Y46*%
 G04 Gerber Fmt 4.6, Leading zero omitted, Abs format (unit mm)*
-G04 Created by KiCad (PCBNEW 7.0.9) date 2023-12-24 22:12:45*
+G04 Created by KiCad (PCBNEW 7.0.9) date 2024-01-21 01:35:16*
 %MOMM*%
 %LPD*%
 G01*

pcb/DeskHop.kicad_pcb

@@ -1,12 +1,12 @@
 %TF.GenerationSoftware,KiCad,Pcbnew,7.0.9*%
-%TF.CreationDate,2023-12-24T22:12:45+01:00*%
+%TF.CreationDate,2024-01-21T01:35:17+01:00*%
 %TF.ProjectId,DeskHop,4465736b-486f-4702-9e6b-696361645f70,rev?*%
 %TF.SameCoordinates,Original*%
 %TF.FileFunction,Soldermask,Bot*%
 %TF.FilePolarity,Negative*%
 %FSLAX46Y46*%
 G04 Gerber Fmt 4.6, Leading zero omitted, Abs format (unit mm)*
-G04 Created by KiCad (PCBNEW 7.0.9) date 2023-12-24 22:12:45*
+G04 Created by KiCad (PCBNEW 7.0.9) date 2024-01-21 01:35:17*
 %MOMM*%
 %LPD*%
 G01*

pcb/DeskHop.kicad_prl

@@ -1,12 +1,12 @@
 %TF.GenerationSoftware,KiCad,Pcbnew,7.0.9*%
-%TF.CreationDate,2023-12-24T22:12:45+01:00*%
+%TF.CreationDate,2024-01-21T01:35:17+01:00*%
 %TF.ProjectId,DeskHop,4465736b-486f-4702-9e6b-696361645f70,rev?*%
 %TF.SameCoordinates,Original*%
 %TF.FileFunction,Paste,Bot*%
 %TF.FilePolarity,Positive*%
 %FSLAX46Y46*%
 G04 Gerber Fmt 4.6, Leading zero omitted, Abs format (unit mm)*
-G04 Created by KiCad (PCBNEW 7.0.9) date 2023-12-24 22:12:45*
+G04 Created by KiCad (PCBNEW 7.0.9) date 2024-01-21 01:35:17*
 %MOMM*%
 %LPD*%
 G01*

pcb/Gerber/DeskHop-B_Cu.gbr

@@ -1,12 +1,12 @@
 %TF.GenerationSoftware,KiCad,Pcbnew,7.0.9*%
-%TF.CreationDate,2023-12-24T22:12:45+01:00*%
+%TF.CreationDate,2024-01-21T01:35:17+01:00*%
 %TF.ProjectId,DeskHop,4465736b-486f-4702-9e6b-696361645f70,rev?*%
 %TF.SameCoordinates,Original*%
 %TF.FileFunction,Legend,Bot*%
 %TF.FilePolarity,Positive*%
 %FSLAX46Y46*%
 G04 Gerber Fmt 4.6, Leading zero omitted, Abs format (unit mm)*
-G04 Created by KiCad (PCBNEW 7.0.9) date 2023-12-24 22:12:45*
+G04 Created by KiCad (PCBNEW 7.0.9) date 2024-01-21 01:35:17*
 %MOMM*%
 %LPD*%
 G01*