2 # Copyright 2017 Luiz Ribeiro <luizribeiro@gmail.com>, Sebastian Kaim <sebb@sebb767.de>
4 # This program is free software: you can redistribute it and/or modify
5 # it under the terms of the GNU General Public License as published by
6 # the Free Software Foundation, either version 2 of the License, or
7 # (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program. If not, see <http://www.gnu.org/licenses/>.
17 from __future__ import print_function
26 def check_keyboard_normal_mode(vendor, product):
27 """Returns a device if a ps2avrGB device in normal made (that is in keyboard mode) or None if it is not found."""
28 return usb.core.find(idVendor=vendor, idProduct=product)
30 def check_keyboard_bootloader_mode():
31 """Returns True if a ps2avrGB device in bootloader (flashable) mode is found and False otherwise."""
32 return (usb.core.find(idVendor=0x16c0, idProduct=0x05df) is not None)
34 def flash_keyboard(firmware_file):
35 """Calls bootloadHID to flash the given file to the device."""
36 print('Flashing firmware to device ...')
37 if os.system('bootloadHID -r "%s"' % firmware_file) == 0:
40 print('\nbootloadHID returned an error.')
42 def print_device_info(dev):
43 """Prints all infos for a given USB device"""
44 print('Device Information:')
45 print(' idVendor: %d (0x%04x)' % (dev.idVendor, dev.idVendor))
46 print(' idProduct: %d (0x%04x)' % (dev.idProduct, dev.idProduct))
47 print('Manufacturer: %s' % (dev.iManufacturer))
48 print('Serial: %s' % (dev.iSerialNumber))
49 print('Product: %s' % (dev.iProduct), end='\n\n')
51 def send_device_to_bootloader_mode(dev):
52 """Tries to send a given ps2avrGB keyboard to bootloader mode to allow flashing."""
54 dev.set_configuration()
56 request_type = usb.util.build_request_type(
58 usb.util.CTRL_TYPE_CLASS,
59 usb.util.CTRL_RECIPIENT_DEVICE)
61 USBRQ_HID_SET_REPORT = 0x09
62 HID_REPORT_OPTION = 0x0301
64 dev.ctrl_transfer(request_type, USBRQ_HID_SET_REPORT, HID_REPORT_OPTION, 0, [0, 0, 0xFF] + [0] * 5)
65 except usb.core.USBError:
66 # for some reason I keep getting USBError, but it works!
70 """Helper for argparse to enable auto base detection"""
73 parser = argparse.ArgumentParser(description='Flash bootloadHID device')
74 parser.add_argument('--vendor', type=auto_int, default=0x20A0, help='Non bootloader idVendor to search for (default: 0x%(default)04x)')
75 parser.add_argument('--product', type=auto_int, default=0x422D, help='Non bootloader idProduct to search for (default: 0x%(default)04x)')
76 parser.add_argument('firmware_hex', type=argparse.FileType('r'), help='Firmware hex file to flash')
77 args = parser.parse_args()
79 kb = check_keyboard_normal_mode(args.vendor, args.product)
82 print('Found a keyboard in normal mode. Attempting to send it to bootloader mode ...', end='')
83 send_device_to_bootloader_mode(kb)
85 print("Hint: If your keyboard can't be set to bootloader mode automatically, plug it in while pressing the bootloader key to do so manually.")
86 print(" You can find more infos about this here: https://github.com/qmk/qmk_firmware/tree/master/keyboards/ps2avrGB#setting-the-board-to-bootloader-mode")
88 attempts = 12 # 60 seconds
90 for attempt in range(1, attempts + 1):
91 print("Searching for keyboard in bootloader mode (%i/%i) ... " % (attempt, attempts), end='')
93 if check_keyboard_bootloader_mode():
94 print('Found', end='\n\n')
95 flash_keyboard(args.firmware_hex.name)
99 print('Nothing.', end='')
101 if attempt != attempts: # no need to wait on the last attempt
102 print(' Sleeping 5 seconds.', end='')
109 print("Couldn't find a flashable keyboard. Aborting.")