Merge pull request #52 from LouDnl/dev

Pull in changes from dev

Author: LouDnl

README.md

@@ -15,10 +15,14 @@ USBSID-Pico is a RaspberryPi Pico/PicoW (RP2040) & Pico2/Pico2W (RP2350) based b
 * [Questions & Support](#questions-and-support)
 * [Project status](#project-status)
 * [Firmware](#firmware)
+  * [Configuring your board's firmware](#configuring-your-boards-firmware)
+    * [Testing your board](#testing-your-board)
+  * [Firmware features](#firmware-features)
   * [Firmware types and naming](doc/USBSID-Pico-firmware-manual.adoc) [(PDF)](doc/USBSID-Pico-firmware-manual.pdf)
   * [How to flash new firmware](doc/USBSID-Pico-firmware-manual.adoc) [(PDF)](doc/USBSID-Pico-firmware-manual.pdf)
   * [How to configure your board](doc/USBSID-Pico-firmware-manual.adoc) [(PDF)](doc/USBSID-Pico-firmware-manual.pdf)
   * [Known issues](#known-issues)
+  * [Building](#building)
 * [Hardware](#hardware)
   * [PCB usage information](#pcb-usage-information)
     * [PCB revision v1.0 manual](#pcb-revision-v10-manual)
@@ -53,7 +57,9 @@ Unofficial support is added to a fork of [RetroDebugger](https://github.com/LouD
 [erique](https://github.com/erique) and [koobo](https://github.com/koobo) have added support to [playsid](https://github.com/erique/playsid.library)
 ##### C64 Music trackers
 You should be able to use the ASID fork of [sidfactory2](https://github.com/Chordian/sidfactory2/tree/asid-support) without issues.  
-When using Vice or RetroDebugger you can freely use applications like [SID-Wizard](https://sourceforge.net/projects/sid-wizard/) for music creation.
+When using Vice or RetroDebugger you can freely use applications like [SID-Wizard](https://sourceforge.net/projects/sid-wizard/) for music creation.  
+There is also work being done in my forks of [Goattracker2](https://github.com/LouDnl/goattracker2) and [GTUltra](https://github.com/LouDnl/GTUltra-USBSID). Ask on Discord for latest binaries :)
+
 #### Midi
 USBSID-Pico acts as Midi device and supports basic Midi in ~ note that Midi is still in development and in Beta phase.  
 This means that no support is available here at this time, please visit the Discord for more information.
@@ -103,52 +109,29 @@ While in development any mentioned features, options, etc. are subject to change
 [J]: https://github.com/LouDnl/USBSID-Pico/blob/master/LICENSE
 [K]: https://github.com/LouDnl/USBSID-Pico
 
-### Test and config your board
-Also see the [Firmware manual](doc/USBSID-Pico-firmware-manual.adoc) for information on how to set up your board!  
-You can configurate your board by using the commandline [config-tool](examples/config-tool) [binary](examples/config-tool/cfg_usbsid) (Linux only at the moment) provided in examples or use the web configurations, see below.  
-
-You can test your board with WebUSB and ASID here: [USBSID](https://usbsid.loudai.nl/?player=webusb).  
-If needed you can change your USBSID configuration after selecting WebUSB and clicking on `Open config`.  
-<img src="images/usbsidpico-config-dark.png" width="300px"><img src="images/usbsidpico-config-light.png" width="300px"><br>
-_The player is set up with some borrowed code from Deepsid using Hermit's JsSID implementation._
-
-#### Debug functions
-For testing purposes only you can use the debug functions available on the [USBSID Debug](https://usbsid.loudai.nl/?player=webusb&debug=usbsidpico) site.
-
 ### Supported platforms
+See the [Software manual](doc/USBSID-Pico-software-manual.adoc) for driver installation and supported software information!  
 _In development_  
-Linux: Vice, RetroDebugger, SidBerry, SidplayFp, JSidplay2, USB Midi, ASID (in webbrowser) SID Play  
-Windows: Vice, SidBerry, USB Midi, ASID (in webbrowser) SID Play  
-Android: USB Midi, ASID (in webbrowser) SID Play
+Linux: Vice, JSidplay2, SidplayFp, RetroDebugger, SidBerry, USB Midi, WebUSB & ASID (in webbrowser) SID Play  
+Windows: Vice, JSidplay2, SidBerry, USB Midi, WebUSB & ASID (in webbrowser) SID Play  
+Android: USB Midi, WebUSB & ASID (in webbrowser) SID Play
 Amiga: PlaySID library
 
-### Linux Udev rules
-Also see the [Software manual](doc/USBSID-Pico-software-manual.adoc) for more information on how to use supported software!  
-In the [examples/udev](repo/examples/udev-rules/69-usbsid-permissions.rules) directory you can find the udev rules that I use on Linux. This purely an example file that you can use and change to your own needs.  
-Steps required for this to work
-```shell
-  # Check if you are in the plugdev group
-  groups  # should show the plugdev group
-  # Copy the udev ules file to the correct directory
-  sudo cp 69-usbsid-permissions.rules /etc/udev/rules.d
-  # Now reload the udev rules
-  sudo udevadm control --reload-rules && sudo udevadm trigger
-  # Not working? Try reloading the service
-  sudo systemctl restart udev
-```
+#### Linux Udev rules
+See the [Software manual](doc/USBSID-Pico-software-manual.adoc) for udev rule installation information!
 
-### Windows driver
-Also see the [Software manual](doc/USBSID-Pico-software-manual.adoc) for mroe information on how to use supported software!  
-Use [Zadig](https://zadig.akeo.ie/) to install the correct driver. Replace the driver for `USBSID-Pico Data` with WinUSB.  
-<img src="images/zadig-list-all-devices.png" width="200px">
-<img src="images/zadig-install-driver.png" width="200px">  
-Then configure check, configure and test your board on the [USBSID](https://usbsid.loudai.nl/?player=webusb) config tool website  
-<img src="images/usbsid-config-connect.png" width="200px">
-<img src="images/usbsid-config-checkversion.png" width="200px">  
+#### Windows driver
+See the [Software manual](doc/USBSID-Pico-software-manual.adoc) for driver installation information!
 
 # Firmware
 See the [firmware changelog](CHANGELOG.md) for more information on what's changed and previous releases.  
-Also see the [Firmware manual](doc/USBSID-Pico-firmware-manual.adoc) for more information on how to set up your board!  
+
+### Configuring your board's firmware
+See the [Firmware manual](doc/USBSID-Pico-firmware-manual.adoc) for more information on how to set up your board!  
+
+#### Testing your board
+You can test your board with WebUSB and ASID here on the same site as the web configuration tool here: [USBSID web configuration tool](https://usbsid.loudai.nl/?player=webusb) (requires a Chrome based browser).  
+
 ### Firmware features
 The firmware is still in development so features might change, be added or removed.
 - By default both sockets are enabled and the configuration is set to 2 SID's.
@@ -164,7 +147,7 @@ The firmware is still in development so features might change, be added or remov
 - Two SID sockets with up to 4 SID's (e.g. SKPico) supported
   - Socket one address range $00 ~ $7F (default $00 ~ $1F) auto based on configuration settings
   - Socket two address range $00 ~ $7F (default $40 ~ $7F) auto based on configuration settings
-  - Configurable via [config-tool](repo/examples/config-tool) for Linux (Windows still in development)
+  - Configurable via [config-tool](repo/examples/config-tool) for Linux and Windows
 - Onboard LED acts as VU meter calculated by the voices of SID1 (Pico & Pico2 only)
 - Onboard RGB LED acts as second VU meter calculated by the voices of SID1 (default)
   - Requires Black Pico clone board with RGB LED onboard!
@@ -209,6 +192,7 @@ _Cases for PCB revision v1.0:_
 
 _Cases for PCB revision v1.3:_
 * [spotUP Cartridge case revisited](cases/v1.3/spotUP-revisited) by @LouD
+* [Dual USBSID-Pico Commodore 64 Case](cases/v1.3/Dual_USBSID-Pico_Commodore_64_Case) by @OlefinMakes
 
 ### Schematic and BOM
 If you want and are up to it you can solder your own PCB or create your own development board using the documents below
@@ -278,7 +262,7 @@ If you want and are up to it you can solder your own PCB or create your own deve
 # Examples
 Visit my [Youtube channel](https://www.youtube.com/channel/UCOu1hPBTsEbG7ZFnk9-29KQ), [other socials](https://github.com/LouDnl) or the [SHOWCASE](SHOWCASE.md) page to see more examples of the board in action.
 ### Software
-Also see the [Software manual](doc/USBSID-Pico-software-manual.adoc) for information on how to use supported software!  
+See the [Software manual](doc/USBSID-Pico-software-manual.adoc) for information on how to use supported software!  
 _Available examples with USBSID-Pico support:_<br>
 [**USBSID-Pico driver**](https://github.com/LouDnl/USBSID-Pico-driver) repo is available @ https://github.com/LouDnl/USBSID-Pico-driver<br>
 [**HardSID USB / SidBlaster USB**](examples/hardsid-sidblaster) emulation driver example<br>

cases/v1.3/Dual_USBSID-Pico_Commodore_64_Case/C64-Case-Bottom.3mf

@@ -0,0 +1,25 @@
+# Source
+[Dual USBSID-Pico Commodore 64 Case](makerworld.com/en/models/1639001-dual-usbsid-pico-commodore-64-case)  
+by [OlefinMakes](https://makerworld.com/en/@OlefinMakes) over at [MakerWorld](https://makerworld.com/en)
+
+# Description
+* This is a case that fits a pair of USBSID-Pico v1.3 PCBs, exposing 3.5mm and USB connectors to the rear of the case.
+* The model was remixed from the [Commodore 64 case design by Nisoli Damiano](https://makerworld.com/en/models/891169-commodore-64-chassis) - it is 60% scale of the original, and able to print on an X1/P1 series printer.
+* The case also has a slot for a 30x30x8mm fan - SID chips are known to get very toasty (65degC measured in my case). You will need to consider heat dissipation.
+* This model is considered in beta - it is printable, however thermal management is still a WIP.
+
+# Printing
+* It is recommended to print these in a heat resistant filament - PETG, ABS, etc due to the hot SID chips. Heatsinks and a fan will also help avoid overheating inside the case.
+* Due to the large area and aspect ratio of the parts, it is recommended to use a build plate treatment for good adhesion (such as gluestick), and to use the 20mm brim specified in the profile.
+* Support reinforcers and blockers have already been added to the parts.
+Take your time and exercise caution removing the supports from the top lid - you do not want to snap off the screw bosses from the top lid!
+
+# Assembly
+* The keyboard print is only designed to be superglued into place. Test fit to ensure it fits correctly prior to gluing. It will friction fit into place to aid assembly.
+* The USBSID-Pico v1.3 PCBs fasten to the lower case using 4x M2.5x6mm BCHS per board. There is space for a pair of boards.
+* Insert the 30x30x8mm fan into the lower case - you will need to provide for power as well (likely by tapping the Vbus pin on the Pi Pico for 5VDC directly). It is recommended to set the fan into ‘exhaust’ position, however slots have been placed on both sides to allow you to choose which direction the fan should flow, and route the power wires accordingly.
+* Assemble the bottom and top halves, ensuring you get the fan aligned on both halves. Fasten the case together using 4x BT2.5x10 SHCS self tapping screws. Do not overtighten!
+
+![Front](case_front.webp)
+![Inside](case_inside.webp)
+![Backside](case_backside.webp)