{"id":13691564,"url":"https://github.com/zwenergy/WSMtool","last_synced_at":"2025-05-02T15:32:34.954Z","repository":{"id":212848340,"uuid":"732444800","full_name":"zwenergy/WSMtool","owner":"zwenergy","description":"A multitool adapter for the WonderSwan. Headphone, serial and link cable adapter in one.","archived":false,"fork":false,"pushed_at":"2024-04-25T06:17:00.000Z","size":318,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-03T17:12:45.312Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zwenergy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-12-16T17:38:49.000Z","updated_at":"2024-07-15T15:51:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"ac6de551-3572-45b0-a046-834aaababf5e","html_url":"https://github.com/zwenergy/WSMtool","commit_stats":null,"previous_names":["zwenergy/wsmtool"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zwenergy%2FWSMtool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zwenergy%2FWSMtool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zwenergy%2FWSMtool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zwenergy%2FWSMtool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zwenergy","download_url":"https://codeload.github.com/zwenergy/WSMtool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224319055,"owners_count":17291768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T17:00:46.532Z","updated_at":"2024-11-12T17:31:24.162Z","avatar_url":"https://github.com/zwenergy.png","language":null,"funding_links":[],"categories":["Hardware development"],"sub_categories":["Other hardware development"],"readme":"# WSMtool\nA multitool adapter for the WonderSwan. Headphone, serial and link cable adapter in one.\n\n## Idea\nThe idea for this multitool is to have a single adapter board which plugs into the EXT port of a WonderSwan and handle different tasks.\nMore specifically, this board can do the following:\n* **Headphone adapter**: You can plug in regular headphones with a 3.5 mm connector and enjoy the enhanced 16b audio output.\n* **Serial adapter**: Using the RP2040 Zero-based USB dongle board, you can use it as a PC serial adapter. You connect the WS adapter to the dongle via a male-to-male 3.5 mm cable (stereo cable) and connect the dongle via USB C to a computer. Useful for, e.g., WonderGate emulation, WonderWitch or ExtFriend.\n* **Link cable**: Using the WSMtool link board, you can connect two WonderSwan and use a 3.5 mm audio cable (stereo) as a link cable.\n\n## Usage\nFor regular headphone mode place the switch into a UP position.\nFor serial or link mode, place the switch into a DOWN position.\n\nThe RP2040 dongle works with [asie's ExtFriend](https://github.com/WonderfulToolchain/ws-extfriend).\nIt follows the same GPIO pinout, hence no changes in the code are required, it should work out of the box.\n**ExtFriend Note**: The digital audio signals are not carried over to the dongle board.\nThis means the digital audio capture via ExtFriend is not possible.\n\n**NOTE: NEVER connect two WonderSwan using two main boards or two link boards. Only connect two WonderSwan using one main board and one link board.**\n\n**NOTE 2: Right now, the WSMtool is not compatible with my consolizer swancolorHD. DO NOT USE IT WITH swancolorHD!**\n\n## Parts\nThe main and link board PCBs need to be ordered with 1.6 mm width to fit with the HDMI connector.\n\n### Main Board\n| **Reference** | **Value**| **Links**\n|---------------|----------|----------|\n| AUDIO1        | Vertical HDMI male connector (1.6 mm board width) |[LCSC](https://lcsc.com/product-detail/D-Sub-DVI-HDMI-Connectors_Jing-Extension-of-the-Electronic-Co-920-867A2021Y10100_C168715.html)|\n| CN2           | 3.5 mm headphone jack (4 pin) |[LCSC](https://www.lcsc.com/product-detail/_SHOU-HAN-_C431535.html)\n| U1            | BU9480f |[AliExpress](https://aliexpress.com/item/1005005906822526.html)|\n| U2            | TDA1308T |[AliExpress](https://aliexpress.com/item/33020207730.html)|\n| U3            | FSA2466UMX | [LCSC](https://www.lcsc.com/product-detail/Analog-Switches-Multiplexers_onsemi-FSA2466UMX_C457657.html)|\n| SW2           | SPDT SMD switch | [LCSC](https://www.lcsc.com/product-detail/Slide-Switches_SHOU-HAN-MINI-MSK12CO2_C2681570.html)|\n| R1            | 10 kOhm dual potentiometer (e.g. Alps Alpine RK10J12R0A0B) |[LCSC](https://lcsc.com/product-detail/Variable-Resistors-Potentiometers_ALPSALPINE-RK10J12R0A0B_C351175.html)|\n| R2, R3, R4, R5 | 3.9 kOhm resistor (0805 SMD) ||\n| R6, R7 | 10 kOhm resistor (0805 SMD) ||\n| C1, C2 | 1 uF capacitor (0805 SMD) ||\n| C3 | 22 uF capacitor (0805 SMD) ||\n| C4 | 100 nF capacitor (0805 SMD) ||\n| C6, C7 | 0 Ohm resistor (1206 SMD) ||\n\n### Link Board\n| **Reference** | **Value**| **Links**\n|---------------|----------|----------|\n| AUDIO1        | Vertical HDMI male connector (1.6 mm board width) |[LCSC](https://lcsc.com/product-detail/D-Sub-DVI-HDMI-Connectors_Jing-Extension-of-the-Electronic-Co-920-867A2021Y10100_C168715.html)|\n| CN2           | 3.5 mm headphone jack (4 pin) |[LCSC](https://lcsc.com/product-detail/Variable-Resistors-Potentiometers_ALPSALPINE-RK10J12R0A0B_C351175.html)\n\n### USB Dongle\n| **Reference** | **Value**| **Links**\n|---------------|----------|----------|\n| U1            | RP2040 Zero |[AliExpress](https://aliexpress.com/item/1005004967926448.html)|\n| CN2           | 3.5 mm headphone jack (4 pin) |[LCSC](https://lcsc.com/product-detail/Variable-Resistors-Potentiometers_ALPSALPINE-RK10J12R0A0B_C351175.html)\n\n## Case\nRight now, there are no cases for the WonderSwan adapters. \nThough, there is a case for the dongle under the STL folder.\n\n## Connector Sleeve\nIn order to make the connector better fitting, I designed a sleeve for the HDMI connector which \"extends\" it physically to a WonderSwan EXT connector. It's 3D printable, you can find the STL here in the repo.\n\n![Connector Sleeve](./WS_Sleeve.png \"Connector Sleeve\")\n\n## Disclaimer\n**Use the files and/or schematics to build your own adapter board at your own risk**.\nThis adapter works fine for me, but it's a simple hobby project, so there is no liability for errors in the schematics and/or board files.\n**Use at your own risk**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzwenergy%2FWSMtool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzwenergy%2FWSMtool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzwenergy%2FWSMtool/lists"}