{"id":25015563,"url":"https://github.com/hkzlab/pontag","last_synced_at":"2025-04-12T23:32:49.782Z","repository":{"id":140511454,"uuid":"309298938","full_name":"hkzlab/pontag","owner":"hkzlab","description":"PONTAG is an active adapter that converts a mouse using PS/2 protocol into an RS232 mouse (Microsoft protocol), commonly used on IBM XT/AT and compatibles.","archived":false,"fork":false,"pushed_at":"2021-08-22T07:26:01.000Z","size":42239,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T17:41:49.854Z","etag":null,"topics":["adapter","converter","mouse","pcb","retrocomputing","serialport"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"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/hkzlab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"publiccode":null,"codemeta":null}},"created_at":"2020-11-02T08:07:41.000Z","updated_at":"2024-07-22T17:02:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"4cdc4cbf-94a1-495d-b1b0-a514f625bb6b","html_url":"https://github.com/hkzlab/pontag","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hkzlab%2Fpontag","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hkzlab%2Fpontag/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hkzlab%2Fpontag/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hkzlab%2Fpontag/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hkzlab","download_url":"https://codeload.github.com/hkzlab/pontag/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647257,"owners_count":21139081,"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":["adapter","converter","mouse","pcb","retrocomputing","serialport"],"created_at":"2025-02-05T08:30:30.536Z","updated_at":"2025-04-12T23:32:49.776Z","avatar_url":"https://github.com/hkzlab.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PONTAG\n## Introduction\nPONTAG is a board that converts a PS/2 mouse into a serial mouse that can be used on old IBM PC and clones, which lacked PS/2 ports but had plenty of serial interfaces (especially if expansion cards are installed).\n\n![Rev. 1 PCB](pics/pcb_smd_v1.png)\n\n## Features \u0026 Limitations\n* Supports 3 buttons+wheel PS/2 mouses and converts their protocol to RS232 serial usable on old PC systems.\n* The board requires an external power supply between 8V and 12V to power the MCU and mouse\n* Detects PS/2 mouses with wheel and without and notifies the user via LED (5 fast blinks for a normal mouse, 20 fast blinks for a mouse with wheel)\n* Can be configured for various resolutions and mouse protocols by pushing mouse buttons\n\n### Configuration\nThe board can be configured during powerup by pressing the mouse keys. The configuration will be retained for all subsequent boots.\nTo configure the board you must keep the mouse button pressed during a reset/bootup. A sequence of **15 slow blinks** will notify the user of the accepted command, then the board will be reset with the new configuration.\n\n* **Left mouse button pressed**: Switches between simple Microsoft protocol and Microsoft protocol with wheel (**DEFAULT:** MS+Wheel)\n* **Right mouse button pressed**: Switches mouse resolution, switching between 1, 2, 4 or 8 counts per mm traveled (**DEFAULT:** 4 counts per mm)\n* **Both buttons pressed**: Resets the board to defaults\n\n### Extra Header\nThe board supports some special options that can be toggled via external header, shorting the corrisponding pin to GND.\n\n* **Pin 1**: The board will enter debug mode, and start printing debug strings on the serial port. It will NOT work as a mouse.\n* **Pin 2**: If jumpered, the board enter power save mode after 3 minutes of mouse inactivity.\n* **Pin 3**: If shorted, forces the use of the simple Microsoft protocol (2 buttons, no wheel), regardless of what is stored in the EEPROM.\n* **Pin 4**: If jumpered, the board will skip the PS/2 intellimouse wheel activation sequence. (**not exposed on board 1.0 !!!**)\n\n## Supported protocols\nPONTAG emulates a Microsoft 3-buttons Wheel serial mouse by default and transmits the `0x4D 0x5A 0x40 0x00 0x00 0x00` detection string when RTS signal is toggled.\n\nThe boards are tested with [CuteMouse](http://cutemouse.sourceforge.net/).\n\n## Credits\n\n- Some footprints are taken from [4x1md](https://github.com/4x1md/kicad_libraries)\n- Took and modified PS/2 code from [sensi.org](http://sensi.org/~svo/%5Bm%5Douse/) and [mouse1351](https://github.com/svofski/mouse1351)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhkzlab%2Fpontag","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhkzlab%2Fpontag","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhkzlab%2Fpontag/lists"}