Co-authored-by: Ryan <fauxpark@gmail.com> Co-authored-by: Nick Brassel <nick@tzarc.org>pull/21066/head
@ -0,0 +1,21 @@ | |||||
# QMK Breaking Changes - 2023 May 28 Changelog | |||||
## Notable Features :id=notable-features | |||||
### Consolidate modelm ([#14996](https://github.com/qmk/qmk_firmware/pull/14996) | |||||
Several build targets for the IBM Model M were cluttered in different folders. | |||||
The maintainers of several Model M replacement controller projects agreed to | |||||
consolidate them under one common folder. | |||||
List of the consolidations now in keyboards/modelm/: | |||||
- ashpil_usbc | |||||
- ibm122m | |||||
- mschwingen | |||||
- teensy2 (renamed from modelm101_teensy2) | |||||
- teensypp (renamed from modelm101) | |||||
- teensypp_ssk (renamed from modelm_ssk) | |||||
- ibm122m | |||||
- m122_3270 | |||||
- yugo_m |
@ -1,16 +0,0 @@ | |||||
# ibm122m | |||||
![IBM Model M 122 key](https://i.imgur.com/Oo3Ozqz.jpg) | |||||
This is a keymap for the IBM Model M 122 key terminal keyboard running on a Teensy 2.0++ | |||||
I wired it to weird pins on mine (mainly to accomodate speakers), so make sure to update the pin arrays. | |||||
Keyboard Maintainer: [Luke Stanley](https://github.com/lukexorz) | |||||
Hardware Supported: Teensy 2.0++ | |||||
Hardware Availability: https://www.pjrc.com/store/teensypp.html | |||||
Make example for this keyboard (after setting up your build environment): | |||||
make handwired/ibm122m:default | |||||
See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M 101/102", | "keyboard_name": "IBM Model M 101/102", | ||||
"manufacturer": "ashpil", | "manufacturer": "ashpil", | ||||
"url": "https://github.com/ashpil/qmk_firmware/tree/master/keyboards/ashpil/modelm_usbc", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m/ashpil_usbc", | |||||
"maintainer": "ashpil", | "maintainer": "ashpil", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -0,0 +1,24 @@ | |||||
# IBM Model M | |||||
This is the parent directory for all projects that replace the controller | |||||
of IBM's Model M Keyboard and then run QMK on it. | |||||
These controllers differ in their use of microcontrollers, connection (mainly | |||||
USB) optional speakers etc. | |||||
Some of them can be bought fully assembled others are do-it-yourself. | |||||
## Warning - Model M Variants | |||||
**Not all of these projects will fit into your keyboard!** | |||||
As the Model M was produced over several years there are many variants of the | |||||
controller PCB. Check what fits your keyboard before you build/order one. | |||||
The variants built for PCs differ in: | |||||
* PCB size | |||||
* Connectors (8/12 pin flex, location) | |||||
* Ground wire connector location | |||||
Additionally IBM built Model M variants for terminals with 122 keys, the | |||||
space saving keyboard (SSK, 84-key) etc. |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M 101/102", | |||||
"keyboard_name": "atmega32U4 board for IBM Model M", | |||||
"manufacturer": "mschwingen", | "manufacturer": "mschwingen", | ||||
"url": "", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m/mschwingen", | |||||
"maintainer": "mschwingen", | "maintainer": "mschwingen", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -0,0 +1,21 @@ | |||||
# atmega32U4 board for IBM Model M, LEDs connected with flexible flat cable (FFC) | |||||
![modelm](https://raw.githubusercontent.com/mschwingen/hardware/master/modelm-usb/images/PCB.jpg) | |||||
This is a configuration of QMK intended to be used with the [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb). | |||||
* Keyboard Maintainer: [Michael Schwingen](https://github.com/mschwingen/) | |||||
* Hardware Supported: [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb) | |||||
* Hardware Availability: need to build your own. | |||||
Make example for this keyboard (after setting up your build environment), run one of: | |||||
make ibm/model_m/mschwingen/led_ffc:default | |||||
Flashing example for this keyboard: | |||||
make ibm/model_m/mschwingen/led_ffc:default:flash | |||||
Bootloader: do not use the QMK bootloader, use the bootloader from [here](https://github.com/mschwingen/modelm-lufa-bootloader) | |||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs). |
@ -0,0 +1,21 @@ | |||||
# atmega32U4 board for IBM Model M, LEDs connected with wires | |||||
![modelm](https://raw.githubusercontent.com/mschwingen/hardware/master/modelm-usb/images/PCB.jpg) | |||||
This is a configuration of QMK intended to be used with the [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb). | |||||
* Keyboard Maintainer: [Michael Schwingen](https://github.com/mschwingen/) | |||||
* Hardware Supported: [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb) | |||||
* Hardware Availability: need to build your own. | |||||
Make example for this keyboard (after setting up your build environment), run one of: | |||||
make ibm/model_m/mschwingen/led_wired:default | |||||
Flashing example for this keyboard: | |||||
make ibm/model_m/mschwingen/led_wired:default:flash | |||||
Bootloader: do not use the QMK bootloader, use the bootloader from [here](https://github.com/mschwingen/modelm-lufa-bootloader) | |||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs). |
@ -0,0 +1,21 @@ | |||||
# atmega32U4 board for IBM Model M, old LEDs replaces with WS2812 RGB LEDs | |||||
![modelm](https://raw.githubusercontent.com/mschwingen/hardware/master/modelm-usb/images/PCB.jpg) | |||||
This is a configuration of QMK intended to be used with the [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb). | |||||
* Keyboard Maintainer: [Michael Schwingen](https://github.com/mschwingen/) | |||||
* Hardware Supported: [Model M USB PCB](https://github.com/mschwingen/hardware/tree/master/modelm-usb) | |||||
* Hardware Availability: need to build your own. | |||||
Make example for this keyboard (after setting up your build environment), run one of: | |||||
make ibm/model_m/mschwingen/led_ws2812:default | |||||
Flashing example for this keyboard: | |||||
make ibm/model_m/mschwingen/led_ws2812:default:flash | |||||
Bootloader: do not use the QMK bootloader, use the bootloader from [here](https://github.com/mschwingen/modelm-lufa-bootloader) | |||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs). |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M 101/102", | "keyboard_name": "IBM Model M 101/102", | ||||
"manufacturer": "wangfuco", | "manufacturer": "wangfuco", | ||||
"url": "https://github.com/wangfuco/qmk_firmware/tree/modelm101_teensy2/keyboards/converter/modelm101_teensy2", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m/teensy2", | |||||
"maintainer": "wangfuco", | "maintainer": "wangfuco", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M 101/102", | "keyboard_name": "IBM Model M 101/102", | ||||
"manufacturer": "iw0rm3r", | "manufacturer": "iw0rm3r", | ||||
"url": "https://github.com/iw0rm3r/qmk_firmware/tree/modelm101/keyboards/converter/modelm101", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m/teensypp", | |||||
"maintainer": "iw0rm3r", | "maintainer": "iw0rm3r", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "Yugo-M (Model M replacment controller)", | |||||
"keyboard_name": "Yugo-M (IBM Model M replacment controller)", | |||||
"manufacturer": "IBM", | "manufacturer": "IBM", | ||||
"url": "https://github.com/tomic1785/qmk_firmware/tree/stm32_model_m/keyboards/yugo_m/model_m_101", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m/yugo_m", | |||||
"maintainer": "Nidzo Tomic", | "maintainer": "Nidzo Tomic", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -1,6 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M 122 key", | "keyboard_name": "IBM Model M 122 key", | ||||
"manufacturer": "IBM", | "manufacturer": "IBM", | ||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m_122/ibm122m", | |||||
"maintainer": "qmk", | "maintainer": "qmk", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -0,0 +1,31 @@ | |||||
# ibm122m | |||||
![IBM Model M 122 key](https://i.imgur.com/Oo3Ozqz.jpg) | |||||
This is a keymap for the IBM Model M 122 key terminal keyboard running on a Teensy++ 2.0 | |||||
I wired it to weird pins on mine (mainly to accomodate two speakers), so make sure to update the pin arrays. | |||||
* Keyboard Maintainer: [Luke Stanley](https://github.com/lukexorz) | |||||
* Hardware Supported: Teensy++ 2.0 | |||||
* Hardware Availability: https://www.pjrc.com/store/teensypp.html | |||||
Pins of the Teensy board you should use by default: | |||||
``` | |||||
Columns: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |||||
Pins: E6 B7 D0 D1 D2 D3 D4 D5 D6 D7 E0 E1 C0 C1 C2 C3 C4 C5 C7 F1 | |||||
-------------------------------------------------------- | |||||
Rows: 1 2 3 4 5 6 7 8 | |||||
Pins: F0 B5 B4 B3 B2 B1 B0 E7 | |||||
-------------------------------------------------------- | |||||
Status LEDs: CapsLock +5V ScrollLock NumLock | |||||
Pins: N/A 5V N/A N/A | |||||
-------------------------------------------------------- | |||||
Speaker: 1+ 1- 2+ 2- | |||||
Pins: C6 GND B6 GND | |||||
``` | |||||
Make example for this keyboard (after setting up your build environment): | |||||
make ibm/model_m_122/ibm122m:default | |||||
See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. |
@ -1,6 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "Model M PC/3270 122 key", | "keyboard_name": "Model M PC/3270 122 key", | ||||
"manufacturer": "IBM", | "manufacturer": "IBM", | ||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m_122/m122_3270", | |||||
"maintainer": "jmaynard", | "maintainer": "jmaynard", | ||||
"usb": { | "usb": { | ||||
"vid": "0x1209", | "vid": "0x1209", |
@ -0,0 +1,33 @@ | |||||
# m122-3270 | |||||
![IBM Model M 122 key](https://i.imgur.com/Oo3Ozqzh.jpg) | |||||
This is a replacement controller for the IBM Model M 122 key terminal keyboard | |||||
running on a STM32F411 BlackPill, intended to act as closely to the 3270 | |||||
keyboard's functioning as possible while still being usable on a PC. | |||||
* Keyboard Maintainer: [Jay Maynard](https://github.com/jmaynard) | |||||
* Hardware Supported: BlackPill STM32F411, Teensy++ 2.0 | |||||
* Hardware Availability: [BlackPill](https://www.adafruit.com/product/4877), [Teensy](https://www.pjrc.com/store/teensypp.html) | |||||
Make example for this keyboard (after setting up your build environment): | |||||
make ibm/model_m_122/m122_3270/blackpill:default | |||||
make ibm/model_m_122/m122_3270/bluepill:default | |||||
make ibm/model_m_122/m122_3270/teensy:default | |||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) | |||||
and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) | |||||
for more information. Brand new to QMK? Start with our | |||||
[Complete Newbs Guide](https://docs.qmk.fm/#/newbs). | |||||
A schematic and Gerber files are publicly available for those wishing to have | |||||
carrier boards made professionally instead of handwiring things. The M122 | |||||
matrix connectors plug right into it. It can be found at | |||||
https://github.com/jmaynard/tronguylabs-m122-blackpill. | |||||
This is derived from Luke Stanley's handwired/ibm122m keyboard, with my own | |||||
keymapping and rework of the I/O for the BlackPill. There's also a version for | |||||
the Teensy++ 2.0, since that was my original design and I still use one on one | |||||
board, even though I switched to the BlackPill for future-proofing. | |||||
The Teensy++ 2.0 is not recommended for new designs. |
@ -0,0 +1,24 @@ | |||||
# IBM Model M Terminal with 122 keys | |||||
This is the parent directory for all projects that replace the controller | |||||
of IBM's Model M terminal keyboard with 122 keys and then run QMK on it. | |||||
These controllers differ in their use of microcontrollers, connection (mainly | |||||
USB) optional speakers etc. | |||||
Some of them can be bought fully assembled others are do-it-yourself. | |||||
## Warning - Model M Variants | |||||
**Not all of these projects will fit into your keyboard!** | |||||
As the Model M was produced over several years there are many variants of the | |||||
controller PCB. Check what fits your keyboard before you build/order one. | |||||
The variants built for PCs differ in: | |||||
* PCB size | |||||
* Connectors (8/12 pin flex, location) | |||||
* Ground wire connector location | |||||
Additionally IBM built Model M variants with 101/102 keys, the | |||||
space saving keyboard (SSK, 84-key) etc. |
@ -0,0 +1,24 @@ | |||||
# IBM Model M Space Saving Keyboard (SSK, 84-key) | |||||
This is the parent directory for all projects that replace the controller | |||||
of IBM's Model M space saving keyboard keyboard with 84 keys and then run QMK on it. | |||||
These controllers differ in their use of microcontrollers, connection (mainly | |||||
USB) optional speakers etc. | |||||
Some of them can be bought fully assembled others are do-it-yourself. | |||||
## Warning - Model M Variants | |||||
**Not all of these projects will fit into your keyboard!** | |||||
As the Model M was produced over several years there are many variants of the | |||||
controller PCB. Check what fits your keyboard before you build/order one. | |||||
The variants built for PCs differ in: | |||||
* PCB size | |||||
* Connectors (8/12 pin flex, location) | |||||
* Ground wire connector location | |||||
Additionally IBM built Model M variants with 101/102 keys, the | |||||
terminal keyboard with 122 keys etc. |
@ -1,7 +1,7 @@ | |||||
{ | { | ||||
"keyboard_name": "IBM Model M Space-Saving Keyboard", | "keyboard_name": "IBM Model M Space-Saving Keyboard", | ||||
"manufacturer": "tiltowait", | "manufacturer": "tiltowait", | ||||
"url": "https://github.com/tiltowait/qmk_firmware/tree/modelm_ssk/keyboards/converter/modelm_ssk", | |||||
"url": "https://github.com/qmk/qmk_firmware/tree/master/keyboards/ibm/model_m_ssk/teensypp_ssk", | |||||
"maintainer": "tiltowait", | "maintainer": "tiltowait", | ||||
"usb": { | "usb": { | ||||
"vid": "0xFEED", | "vid": "0xFEED", |
@ -1,22 +0,0 @@ | |||||
# m122-3270 | |||||
![IBM Model M 122 key](https://i.imgur.com/Oo3Ozqzh.jpg) | |||||
This is a replacement controller for the IBM Model M 122 key terminal keyboard running on a STM32F411 BlackPill, intended to act as closely to the 3270 keyboard's functioning as possible while still being usable on a PC. | |||||
* Keyboard Maintainer: [Jay Maynard](https://github.com/jmaynard) | |||||
* Hardware Supported: BlackPill STM32F411, Teensy++ 2.0 | |||||
* Hardware Availability: [BlackPill](https://www.adafruit.com/product/4877), [Teensy](https://www.pjrc.com/store/teensypp.html) | |||||
Make example for this keyboard (after setting up your build environment): | |||||
make tronguylabs/m122_3270/blackpill:default | |||||
make tronguylabs/m122_3270/teensy:default | |||||
See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs). | |||||
A schematic and Gerber files are publicly available for those wishing to have carrier boards made | |||||
professionally instead of handwiring things. The M122 matrix connectors plug right into it. It can | |||||
be found at https://github.com/jmaynard/tronguylabs-m122-blackpill. | |||||
This is derived from Luke Stanley's handwired/ibm122m keyboard, with my own keymapping and rework of the I/O for the BlackPill. There's also a version for the Teensy++ 2.0, since that was my original design and I still use one on one board, even though I switched to the BlackPill for future-proofing. The Teensy++ 2.0 is not recommended for new designs. |
@ -1,19 +0,0 @@ | |||||
# Yugo-M - An STM32-based IBM Model M controller | |||||
A drop-in replacement controller PCB for IBM Model M keyboards. | |||||
Currently available only for 101/102 key keyboards. | |||||
* Keyboard Maintainer: [Nidzo Tomic](https://github.com/tomic1785) | |||||
* Hardware Supported: Yugo-M PCB | |||||
* Rev 0.9b | |||||
* Rev 1.1b | |||||
For more info visit the project repository: [Yugo-M-controller-project](https://github.com/tomic1785/Yugo-M-controller-project) | |||||
Note regarding 2022 matrix update: | |||||
The original author's firmware did not make several lesser-used membrane/matrix positions available to the controller. These are useful for JIS users and/or if you simply want to create a more unique layout. I've added all of the unused membrane positions to the firmware, except for an extremely seldom used one that sits in the left side of the space bar on some later membranes (I would have added it if I knew its matrix position, but I haven't mapped that out yet). The default mappings for these additional keys follow JIS conventions, except for the extra key on the bottom right corner of the numpad (lower half of vertical 2u Enter), which I've mapped to the LGUI key a.k.a. left Windows/Command key for now. Remap as you wish! | |||||
- an_achronism, February 2022 |