History

Christopher Browne dbfbe0d7f0 Adopted LAYOUT, added some keys (#5320 ) * Add HOME/END keys as upper/lower on arrow-up/down * Reduce .hex file size by turning off unneeded options * Put digit keypad onto left hand upon RAISE; this will sometimes be preferable to double-hits of right hand * Latest super latest version merge * cbbrowne keymap for XD75re * starting notes on XD75re keymap plans * First draft of bottom row of QWERTY * Switch my special bottom line over to QCENT * Dunno * Filling in wanted keys, bit by bit... * Add copyright, extra macro * Clean up comments, remove some experimental code I didn't like * TODO plans for xd75re * clean up keyboard layout * QCENT2 is my new experiment for the main keyboard... * Add a few more main layer keys, and modify LOWER to shift things outwards to conform with main layer * Clean up RAISE layer to conform with main layer, remove QCENT layer as QCENT2 is the new thing * More xd75 changes, now that I actually have it in hand * shift keymap around, as original attempt was a bit too aggressive in keeping to the edges * more revs to XD75 * Dropping parts of the centre keypad in favor of Keys I Really Need * Improve documentation to conform with how builds are done now * Improve documentation to conform with how builds are done now * Add cbbrowne rules file as alternative to having the rules in Makefile * Makefile not needed anymore for individual keymap * Some revs to my keymapping * Add {} * Add PGUP/PGDN * Shifted some middle-range keys around * Needed Tilde, Backquote, and to shift RESET onto FUNCTION layer * Wanted ~ * cbbrowne hasn't anything to do with hadron keymaps * trim unneeded bits * I prefer OrgMode for my notes * Have a right-alt * Layer keys make LED colors change * Add sample user rules for cbbrowne * Add source of xd75 rules * Individualized xd75 rules * Adopt LAYOUT to genericize the layout as an ortholinear 5x15 keyboard		2019-03-05 12:22:51 -08:00
..
keymaps	Adopted LAYOUT, added some keys (#5320 )	2019-03-05 12:22:51 -08:00
config.h	Remove CUSTOM_MATRIX option from diode direction (#5090 )	2019-02-18 08:49:51 -08:00
readme.md	adds led control functions to XD75 layout	2017-12-04 18:16:07 -05:00
rules.mk	Replace outdated RGB/Audio information	2018-10-22 14:55:05 -04:00
xd75.c	adds led control functions to XD75 layout	2017-12-04 18:16:07 -05:00
xd75.h	adds led control functions to XD75 layout	2017-12-04 18:16:07 -05:00

readme.md

xd75 keyboard firmware

The XD75Re is a 15x5 full-grid ortholinear keyboard manufactured by XIUDI. This port of the QMK firmware is my first shot at using QMK, so if you see any features done wrong (or just plain missing), feel free to fix them and put in a pull request!

Quantum MK Firmware

For more info on this firmware (and how to make it your own), head over to qmk.fm.

Building

Download or clone the whole firmware and navigate to the keyboards/xd75 folder. Once your dev env is setup, you'll be able to type make to generate your .hex - you can then use the Teensy Loader to install the resulting .hex file, or have the make process install it using DFU.

Default

To build with the default keymap, simply run make xd75:default from the root directory (i.e. two levels above this file), and to install via DFU, make xd75:default:dfu, also from the root directory.

Note that DFU is likely to require root permissions, so installing the firmware likely requires a command line like:

$ sudo make xd75:default:dfu

LED control

There are 3 individual LEDs that can be turned on and off, plus the keycap LEDs (which are all wired into the same pin). The functions are named according to how they're labeled on the PCB.

TODO: it would be nice to have PWM support on these LEDs for fade-in/fade-out effects.

capslock_led_on();
gp100_led_on();
gp103_led_on();
keycaps_led_on();


// led_set_user example - you could also turn these on/off in response
// to events in process_record_user or matrix_scan_user
void led_set_user(uint8_t usb_led) {
    if (usb_led & (1<<USB_LED_CAPS_LOCK)) {
        capslock_led_on();
    } else {
        capslock_led_off();
    }

    if (some_custom_state) {
      gp100_led_on();
    }
    else {
      gp100_led_off();
    }
}

For the curious:

CAPSLOCK_LED    B2
GP103_LED       F4
KEYCAPS_LED     F5
GP100_LED       F7

Other Keymaps

The "default" keymap included is basically the OLKB Atomic keymap with a few buttons added for RGB underglow control. This should be usable as a starting point, but most people will be best served creating their own keymap and flashing it - more info on creating your own keymap is available in the official QMK documentation.

Keymaps follow the format <name>.c and are stored in subdirectories under keyboards/xd75/keymaps

To build the firmware binary hex file for a specific keymap, and install it, using DFU, just do make with a keymap like this:

$ make xd75:[default|<name>]