"""Functions that help us generate and use info.json files. """ import re from pathlib import Path import jsonschema from dotty_dict import dotty from milc import cli from qmk.constants import CHIBIOS_PROCESSORS, LUFA_PROCESSORS, VUSB_PROCESSORS from qmk.c_parse import find_layouts, parse_config_h_file, find_led_config from qmk.json_schema import deep_update, json_load, validate from qmk.keyboard import config_h, rules_mk from qmk.commands import parse_configurator_json from qmk.makefile import parse_rules_mk_file from qmk.math import compute true_values = ['1', 'on', 'yes'] false_values = ['0', 'off', 'no'] def _keyboard_in_layout_name(keyboard, layout): """Validate that a layout macro does not contain name of keyboard """ # TODO: reduce this list down safe_layout_tokens = { 'ansi', 'iso', 'jp', 'jis', 'ortho', 'wkl', 'tkl', 'preonic', 'planck', } # Ignore tokens like 'split_3x7_4' or just '2x4' layout = re.sub(r"_split_\d+x\d+_\d+", '', layout) layout = re.sub(r"_\d+x\d+", '', layout) name_fragments = set(keyboard.split('/')) - safe_layout_tokens return any(fragment in layout for fragment in name_fragments) def _valid_community_layout(layout): """Validate that a declared community list exists """ return (Path('layouts/default') / layout).exists() def _get_key_left_position(key): # Special case for ISO enter return key['x'] - 0.25 if key.get('h', 1) == 2 and key.get('w', 1) == 1.25 else key['x'] def _find_invalid_encoder_index(info_data): """Perform additional validation of encoders """ enc_count = len(info_data.get('encoder', {}).get('rotary', [])) enc_count += len(info_data.get('split', {}).get('encoder', {}).get('right', {}).get('rotary', [])) ret = [] layouts = info_data.get('layouts', {}) for layout_name, layout_data in layouts.items(): found = set() for key in layout_data['layout']: if 'encoder' in key: if enc_count == 0: ret.append((layout_name, key['encoder'], 'non-configured')) elif key['encoder'] >= enc_count: ret.append((layout_name, key['encoder'], 'out of bounds')) elif key['encoder'] in found: ret.append((layout_name, key['encoder'], 'duplicate')) found.add(key['encoder']) return ret def _additional_validation(keyboard, info_data): """Non schema checks """ layouts = info_data.get('layouts', {}) layout_aliases = info_data.get('layout_aliases', {}) community_layouts = info_data.get('community_layouts', []) community_layouts_names = list(map(lambda layout: f'LAYOUT_{layout}', community_layouts)) # Make sure we have at least one layout if len(layouts) == 0 or all(not layout.get('json_layout', False) for layout in layouts.values()): _log_error(info_data, 'No LAYOUTs defined! Need at least one layout defined in info.json.') # Warn if physical positions are offset (at least one key should be at x=0, and at least one key at y=0) for layout_name, layout_data in layouts.items(): offset_x = min([_get_key_left_position(k) for k in layout_data['layout']]) if offset_x > 0: _log_warning(info_data, f'Layout "{layout_name}" is offset on X axis by {offset_x}') offset_y = min([k['y'] for k in layout_data['layout']]) if offset_y > 0: _log_warning(info_data, f'Layout "{layout_name}" is offset on Y axis by {offset_y}') # Providing only LAYOUT_all "because I define my layouts in a 3rd party tool" if len(layouts) == 1 and 'LAYOUT_all' in layouts: _log_warning(info_data, '"LAYOUT_all" should be "LAYOUT" unless additional layouts are provided.') # Extended layout name checks - ignoring community_layouts and "safe" values potential_layouts = set(layouts.keys()) - set(community_layouts_names) for layout in potential_layouts: if _keyboard_in_layout_name(keyboard, layout): _log_warning(info_data, f'Layout "{layout}" should not contain name of keyboard.') # Filter out any non-existing community layouts for layout in community_layouts: if not _valid_community_layout(layout): # Ignore layout from future checks info_data['community_layouts'].remove(layout) _log_error(info_data, 'Claims to support a community layout that does not exist: %s' % (layout)) # Make sure we supply layout macros for the community layouts we claim to support for layout_name in community_layouts_names: if layout_name not in layouts and layout_name not in layout_aliases: _log_error(info_data, 'Claims to support community layout %s but no %s() macro found' % (layout, layout_name)) # keycodes with length > 7 must have short forms for visualisation purposes for decl in info_data.get('keycodes', []): if len(decl["key"]) > 7: if not decl.get("aliases", []): _log_error(info_data, f'Keycode {decl["key"]} has no short form alias') # encoder IDs in layouts must be in range and not duplicated found = _find_invalid_encoder_index(info_data) for layout_name, encoder_index, reason in found: _log_error(info_data, f'Layout "{layout_name}" contains {reason} encoder index {encoder_index}.') def _validate(keyboard, info_data): """Perform various validation on the provided info.json data """ # First validate against the jsonschema try: validate(info_data, 'qmk.api.keyboard.v1') _additional_validation(keyboard, info_data) except jsonschema.ValidationError as e: json_path = '.'.join([str(p) for p in e.absolute_path]) cli.log.error('Invalid API data: %s: %s: %s', keyboard, json_path, e.message) exit(1) def info_json(keyboard): """Generate the info.json data for a specific keyboard. """ cur_dir = Path('keyboards') root_rules_mk = parse_rules_mk_file(cur_dir / keyboard / 'rules.mk') if 'DEFAULT_FOLDER' in root_rules_mk: keyboard = root_rules_mk['DEFAULT_FOLDER'] info_data = { 'keyboard_name': str(keyboard), 'keyboard_folder': str(keyboard), 'keymaps': {}, 'layouts': {}, 'parse_errors': [], 'parse_warnings': [], 'maintainer': 'qmk', } # Populate layout data layouts, aliases = _search_keyboard_h(keyboard) if aliases: info_data['layout_aliases'] = aliases for layout_name, layout_json in layouts.items(): if not layout_name.startswith('LAYOUT_kc'): layout_json['c_macro'] = True layout_json['json_layout'] = False info_data['layouts'][layout_name] = layout_json # Merge in the data from info.json, config.h, and rules.mk info_data = merge_info_jsons(keyboard, info_data) info_data = _process_defaults(info_data) info_data = _extract_rules_mk(info_data, rules_mk(str(keyboard))) info_data = _extract_config_h(info_data, config_h(str(keyboard))) # Ensure that we have matrix row and column counts info_data = _matrix_size(info_data) # Merge in data from info_data = _extract_led_config(info_data, str(keyboard)) # Validate _validate(keyboard, info_data) # Check that the reported matrix size is consistent with the actual matrix size _check_matrix(info_data) return info_data def _extract_features(info_data, rules): """Find all the features enabled in rules.mk. """ # Process booleans rules for key, value in rules.items(): if key.endswith('_ENABLE'): key = '_'.join(key.split('_')[:-1]).lower() value = True if value.lower() in true_values else False if value.lower() in false_values else value if 'config_h_features' not in info_data: info_data['config_h_features'] = {} if 'features' not in info_data: info_data['features'] = {} if key in info_data['features']: _log_warning(info_data, 'Feature %s is specified in both info.json and rules.mk, the rules.mk value wins.' % (key,)) info_data['features'][key] = value info_data['config_h_features'][key] = value return info_data def _pin_name(pin): """Returns the proper representation for a pin. """ pin = pin.strip() if not pin: return None elif pin.isdigit(): return int(pin) elif pin == 'NO_PIN': return None return pin def _extract_pins(pins): """Returns a list of pins from a comma separated string of pins. """ return [_pin_name(pin) for pin in pins.split(',')] def _extract_2d_array(raw): """Return a 2d array of strings """ out_array = [] while raw[-1] != '}': raw = raw[:-1] for row in raw.split('},{'): if row.startswith('{'): row = row[1:] if row.endswith('}'): row = row[:-1] out_array.append([]) for val in row.split(','): out_array[-1].append(val) return out_array def _extract_2d_int_array(raw): """Return a 2d array of ints """ ret = _extract_2d_array(raw) return [list(map(int, x)) for x in ret] def _extract_direct_matrix(direct_pins): """extract direct_matrix """ direct_pin_array = _extract_2d_array(direct_pins) for i in range(len(direct_pin_array)): for j in range(len(direct_pin_array[i])): if direct_pin_array[i][j] == 'NO_PIN': direct_pin_array[i][j] = None return direct_pin_array def _extract_audio(info_data, config_c): """Populate data about the audio configuration """ audio_pins = [] for pin in 'B5', 'B6', 'B7', 'C4', 'C5', 'C6': if config_c.get(f'{pin}_AUDIO'): audio_pins.append(pin) if audio_pins: info_data['audio'] = {'pins': audio_pins} def _extract_encoders_values(config_c, postfix=''): """Common encoder extraction logic """ a_pad = config_c.get(f'ENCODERS_PAD_A{postfix}', '').replace(' ', '')[1:-1] b_pad = config_c.get(f'ENCODERS_PAD_B{postfix}', '').replace(' ', '')[1:-1] resolutions = config_c.get(f'ENCODER_RESOLUTIONS{postfix}', '').replace(' ', '')[1:-1] default_resolution = config_c.get('ENCODER_RESOLUTION', None) if a_pad and b_pad: a_pad = list(filter(None, a_pad.split(','))) b_pad = list(filter(None, b_pad.split(','))) resolutions = list(filter(None, resolutions.split(','))) if default_resolution: resolutions += [default_resolution] * (len(a_pad) - len(resolutions)) encoders = [] for index in range(len(a_pad)): encoder = {'pin_a': a_pad[index], 'pin_b': b_pad[index]} if index < len(resolutions): encoder['resolution'] = int(resolutions[index]) encoders.append(encoder) return encoders def _extract_encoders(info_data, config_c): """Populate data about encoder pins """ encoders = _extract_encoders_values(config_c) if encoders: if 'encoder' not in info_data: info_data['encoder'] = {} if 'rotary' in info_data['encoder']: _log_warning(info_data, 'Encoder config is specified in both config.h and info.json (encoder.rotary) (Value: %s), the config.h value wins.' % info_data['encoder']['rotary']) info_data['encoder']['rotary'] = encoders def _extract_split_encoders(info_data, config_c): """Populate data about split encoder pins """ encoders = _extract_encoders_values(config_c, '_RIGHT') if encoders: if 'split' not in info_data: info_data['split'] = {} if 'encoder' not in info_data['split']: info_data['split']['encoder'] = {} if 'right' not in info_data['split']['encoder']: info_data['split']['encoder']['right'] = {} if 'rotary' in info_data['split']['encoder']['right']: _log_warning(info_data, 'Encoder config is specified in both config.h and info.json (encoder.rotary) (Value: %s), the config.h value wins.' % info_data['split']['encoder']['right']['rotary']) info_data['split']['encoder']['right']['rotary'] = encoders def _extract_secure_unlock(info_data, config_c): """Populate data about the secure unlock sequence """ unlock = config_c.get('SECURE_UNLOCK_SEQUENCE', '').replace(' ', '')[1:-1] if unlock: unlock_array = _extract_2d_int_array(unlock) if 'secure' not in info_data: info_data['secure'] = {} if 'unlock_sequence' in info_data['secure']: _log_warning(info_data, 'Secure unlock sequence is specified in both config.h (SECURE_UNLOCK_SEQUENCE) and info.json (secure.unlock_sequence) (Value: %s), the config.h value wins.' % info_data['secure']['unlock_sequence']) info_data['secure']['unlock_sequence'] = unlock_array def _extract_split_handedness(info_data, config_c): # Migrate split = info_data.get('split', {}) if 'matrix_grid' in split: split['handedness'] = split.get('handedness', {}) split['handedness']['matrix_grid'] = split.pop('matrix_grid') def _extract_split_transport(info_data, config_c): # Figure out the transport method if config_c.get('USE_I2C') is True: if 'split' not in info_data: info_data['split'] = {} if 'transport' not in info_data['split']: info_data['split']['transport'] = {} if 'protocol' in info_data['split']['transport']: _log_warning(info_data, 'Split transport is specified in both config.h (USE_I2C) and info.json (split.transport.protocol) (Value: %s), the config.h value wins.' % info_data['split']['transport']) info_data['split']['transport']['protocol'] = 'i2c' # Ignore transport defaults if "SPLIT_KEYBOARD" is unset elif 'enabled' in info_data.get('split', {}): if 'split' not in info_data: info_data['split'] = {} if 'transport' not in info_data['split']: info_data['split']['transport'] = {} if 'protocol' not in info_data['split']['transport']: info_data['split']['transport']['protocol'] = 'serial' # Migrate transport = info_data.get('split', {}).get('transport', {}) if 'sync_matrix_state' in transport: transport['sync'] = transport.get('sync', {}) transport['sync']['matrix_state'] = transport.pop('sync_matrix_state') if 'sync_modifiers' in transport: transport['sync'] = transport.get('sync', {}) transport['sync']['modifiers'] = transport.pop('sync_modifiers') def _extract_split_right_pins(info_data, config_c): # Figure out the right half matrix pins row_pins = config_c.get('MATRIX_ROW_PINS_RIGHT', '').replace('{', '').replace('}', '').strip() col_pins = config_c.get('MATRIX_COL_PINS_RIGHT', '').replace('{', '').replace('}', '').strip() direct_pins = config_c.get('DIRECT_PINS_RIGHT', '').replace(' ', '')[1:-1] if row_pins or col_pins or direct_pins: if info_data.get('split', {}).get('matrix_pins', {}).get('right', None): _log_warning(info_data, 'Right hand matrix data is specified in both info.json and config.h, the config.h values win.') if 'split' not in info_data: info_data['split'] = {} if 'matrix_pins' not in info_data['split']: info_data['split']['matrix_pins'] = {} if 'right' not in info_data['split']['matrix_pins']: info_data['split']['matrix_pins']['right'] = {} if col_pins: info_data['split']['matrix_pins']['right']['cols'] = _extract_pins(col_pins) if row_pins: info_data['split']['matrix_pins']['right']['rows'] = _extract_pins(row_pins) if direct_pins: info_data['split']['matrix_pins']['right']['direct'] = _extract_direct_matrix(direct_pins) def _extract_matrix_info(info_data, config_c): """Populate the matrix information. """ row_pins = config_c.get('MATRIX_ROW_PINS', '').replace('{', '').replace('}', '').strip() col_pins = config_c.get('MATRIX_COL_PINS', '').replace('{', '').replace('}', '').strip() direct_pins = config_c.get('DIRECT_PINS', '').replace(' ', '')[1:-1] info_snippet = {} if 'MATRIX_ROWS' in config_c and 'MATRIX_COLS' in config_c: if 'matrix_size' in info_data: _log_warning(info_data, 'Matrix size is specified in both info.json and config.h, the config.h values win.') info_data['matrix_size'] = { 'cols': compute(config_c.get('MATRIX_COLS', '0')), 'rows': compute(config_c.get('MATRIX_ROWS', '0')), } if row_pins and col_pins: if 'matrix_pins' in info_data and 'cols' in info_data['matrix_pins'] and 'rows' in info_data['matrix_pins']: _log_warning(info_data, 'Matrix pins are specified in both info.json and config.h, the config.h values win.') info_snippet['cols'] = _extract_pins(col_pins) info_snippet['rows'] = _extract_pins(row_pins) if direct_pins: if 'matrix_pins' in info_data and 'direct' in info_data['matrix_pins']: _log_warning(info_data, 'Direct pins are specified in both info.json and config.h, the config.h values win.') info_snippet['direct'] = _extract_direct_matrix(direct_pins) if config_c.get('CUSTOM_MATRIX', 'no') != 'no': if 'matrix_pins' in info_data and 'custom' in info_data['matrix_pins']: _log_warning(info_data, 'Custom Matrix is specified in both info.json and config.h, the config.h values win.') info_snippet['custom'] = True if config_c['CUSTOM_MATRIX'] == 'lite': info_snippet['custom_lite'] = True if info_snippet: info_data['matrix_pins'] = info_snippet return info_data def _config_to_json(key_type, config_value): """Convert config value using spec """ if key_type.startswith('array'): if '.' in key_type: key_type, array_type = key_type.split('.', 1) else: array_type = None config_value = config_value.replace('{', '').replace('}', '').strip() if array_type == 'int': return list(map(int, config_value.split(','))) else: return list(map(str.strip, config_value.split(','))) elif key_type == 'bool': if isinstance(config_value, bool): return config_value return config_value in true_values elif key_type == 'hex': return '0x' + config_value[2:].upper() elif key_type == 'list': return config_value.split() elif key_type == 'int': return int(config_value) elif key_type == 'str': return config_value.strip('"').replace('\\"', '"').replace('\\\\', '\\') elif key_type == 'bcd_version': major = int(config_value[2:4]) minor = int(config_value[4]) revision = int(config_value[5]) return f'{major}.{minor}.{revision}' return config_value def _extract_config_h(info_data, config_c): """Pull some keyboard information from existing config.h files """ # Pull in data from the json map dotty_info = dotty(info_data) info_config_map = json_load(Path('data/mappings/info_config.hjson')) for config_key, info_dict in info_config_map.items(): info_key = info_dict['info_key'] key_type = info_dict.get('value_type', 'raw') try: replace_with = info_dict.get('replace_with') if config_key in config_c and info_dict.get('invalid', False): if replace_with: _log_error(info_data, '%s in config.h is no longer a valid option and should be replaced with %s' % (config_key, replace_with)) else: _log_error(info_data, '%s in config.h is no longer a valid option and should be removed' % config_key) elif config_key in config_c and info_dict.get('deprecated', False): if replace_with: _log_warning(info_data, '%s in config.h is deprecated in favor of %s and will be removed at a later date' % (config_key, replace_with)) else: _log_warning(info_data, '%s in config.h is deprecated and will be removed at a later date' % config_key) if config_key in config_c and info_dict.get('to_json', True): if dotty_info.get(info_key) and info_dict.get('warn_duplicate', True): _log_warning(info_data, '%s in config.h is overwriting %s in info.json' % (config_key, info_key)) dotty_info[info_key] = _config_to_json(key_type, config_c[config_key]) except Exception as e: _log_warning(info_data, f'{config_key}->{info_key}: {e}') info_data.update(dotty_info) # Pull data that easily can't be mapped in json _extract_matrix_info(info_data, config_c) _extract_audio(info_data, config_c) _extract_secure_unlock(info_data, config_c) _extract_split_handedness(info_data, config_c) _extract_split_transport(info_data, config_c) _extract_split_right_pins(info_data, config_c) _extract_encoders(info_data, config_c) _extract_split_encoders(info_data, config_c) return info_data def _process_defaults(info_data): """Process any additional defaults based on currently discovered information """ defaults_map = json_load(Path('data/mappings/defaults.hjson')) for default_type in defaults_map.keys(): thing_map = defaults_map[default_type] if default_type in info_data: merged_count = 0 thing_items = thing_map.get(info_data[default_type], {}).items() for key, value in thing_items: if key not in info_data: info_data[key] = value merged_count += 1 if merged_count == 0 and len(thing_items) > 0: _log_warning(info_data, 'All defaults for \'%s\' were skipped, potential redundant config or misconfiguration detected' % (default_type)) return info_data def _extract_rules_mk(info_data, rules): """Pull some keyboard information from existing rules.mk files """ info_data['processor'] = rules.get('MCU', info_data.get('processor', 'atmega32u4')) if info_data['processor'] in CHIBIOS_PROCESSORS: arm_processor_rules(info_data, rules) elif info_data['processor'] in LUFA_PROCESSORS + VUSB_PROCESSORS: avr_processor_rules(info_data, rules) else: cli.log.warning("%s: Unknown MCU: %s" % (info_data['keyboard_folder'], info_data['processor'])) unknown_processor_rules(info_data, rules) # Pull in data from the json map dotty_info = dotty(info_data) info_rules_map = json_load(Path('data/mappings/info_rules.hjson')) for rules_key, info_dict in info_rules_map.items(): info_key = info_dict['info_key'] key_type = info_dict.get('value_type', 'raw') try: replace_with = info_dict.get('replace_with') if rules_key in rules and info_dict.get('invalid', False): if replace_with: _log_error(info_data, '%s in rules.mk is no longer a valid option and should be replaced with %s' % (rules_key, replace_with)) else: _log_error(info_data, '%s in rules.mk is no longer a valid option and should be removed' % rules_key) elif rules_key in rules and info_dict.get('deprecated', False): if replace_with: _log_warning(info_data, '%s in rules.mk is deprecated in favor of %s and will be removed at a later date' % (rules_key, replace_with)) else: _log_warning(info_data, '%s in rules.mk is deprecated and will be removed at a later date' % rules_key) if rules_key in rules and info_dict.get('to_json', True): if dotty_info.get(info_key) and info_dict.get('warn_duplicate', True): _log_warning(info_data, '%s in rules.mk is overwriting %s in info.json' % (rules_key, info_key)) dotty_info[info_key] = _config_to_json(key_type, rules[rules_key]) except Exception as e: _log_warning(info_data, f'{rules_key}->{info_key}: {e}') info_data.update(dotty_info) # Merge in config values that can't be easily mapped _extract_features(info_data, rules) return info_data def find_keyboard_c(keyboard): """Find all .c files """ keyboard = Path(keyboard) current_path = Path('keyboards/') files = [] for directory in keyboard.parts: current_path = current_path / directory keyboard_c_path = current_path / f'{directory}.c' if keyboard_c_path.exists(): files.append(keyboard_c_path) return files def _extract_led_config(info_data, keyboard): """Scan all .c files for led config """ cols = info_data['matrix_size']['cols'] rows = info_data['matrix_size']['rows'] # Determine what feature owns g_led_config features = info_data.get("features", {}) feature = None if features.get("rgb_matrix", False): feature = "rgb_matrix" elif features.get("led_matrix", False): feature = "led_matrix" if feature: # Process for file in find_keyboard_c(keyboard): try: ret = find_led_config(file, cols, rows) if ret: info_data[feature] = info_data.get(feature, {}) info_data[feature]["layout"] = ret except Exception as e: _log_warning(info_data, f'led_config: {file.name}: {e}') if info_data[feature].get("layout", None) and not info_data[feature].get("led_count", None): info_data[feature]["led_count"] = len(info_data[feature]["layout"]) return info_data def _matrix_size(info_data): """Add info_data['matrix_size'] if it doesn't exist. """ if 'matrix_size' not in info_data and 'matrix_pins' in info_data: info_data['matrix_size'] = {} if 'direct' in info_data['matrix_pins']: info_data['matrix_size']['cols'] = len(info_data['matrix_pins']['direct'][0]) info_data['matrix_size']['rows'] = len(info_data['matrix_pins']['direct']) elif 'cols' in info_data['matrix_pins'] and 'rows' in info_data['matrix_pins']: info_data['matrix_size']['cols'] = len(info_data['matrix_pins']['cols']) info_data['matrix_size']['rows'] = len(info_data['matrix_pins']['rows']) # Assumption of split common if 'split' in info_data: if info_data['split'].get('enabled', False): info_data['matrix_size']['rows'] *= 2 return info_data def _check_matrix(info_data): """Check the matrix to ensure that row/column count is consistent. """ if 'matrix_pins' in info_data and 'matrix_size' in info_data: actual_col_count = info_data['matrix_size'].get('cols', 0) actual_row_count = info_data['matrix_size'].get('rows', 0) col_count = row_count = 0 if 'direct' in info_data['matrix_pins']: col_count = len(info_data['matrix_pins']['direct'][0]) row_count = len(info_data['matrix_pins']['direct']) elif 'cols' in info_data['matrix_pins'] and 'rows' in info_data['matrix_pins']: col_count = len(info_data['matrix_pins']['cols']) row_count = len(info_data['matrix_pins']['rows']) elif 'cols' not in info_data['matrix_pins'] and 'rows' not in info_data['matrix_pins']: # This case caters for custom matrix implementations where normal rows/cols are specified return if col_count != actual_col_count and col_count != (actual_col_count / 2): # FIXME: once we can we should detect if split is enabled to do the actual_col_count/2 check. _log_error(info_data, f'MATRIX_COLS is inconsistent with the size of MATRIX_COL_PINS: {col_count} != {actual_col_count}') if row_count != actual_row_count and row_count != (actual_row_count / 2): # FIXME: once we can we should detect if split is enabled to do the actual_row_count/2 check. _log_error(info_data, f'MATRIX_ROWS is inconsistent with the size of MATRIX_ROW_PINS: {row_count} != {actual_row_count}') def _search_keyboard_h(keyboard): keyboard = Path(keyboard) current_path = Path('keyboards/') aliases = {} layouts = {} for directory in keyboard.parts: current_path = current_path / directory keyboard_h = '%s.h' % (directory,) keyboard_h_path = current_path / keyboard_h if keyboard_h_path.exists(): new_layouts, new_aliases = find_layouts(keyboard_h_path) layouts.update(new_layouts) for alias, alias_text in new_aliases.items(): if alias_text in layouts: aliases[alias] = alias_text return layouts, aliases def _log_error(info_data, message): """Send an error message to both JSON and the log. """ info_data['parse_errors'].append(message) cli.log.error('%s: %s', info_data.get('keyboard_folder', 'Unknown Keyboard!'), message) def _log_warning(info_data, message): """Send a warning message to both JSON and the log. """ info_data['parse_warnings'].append(message) cli.log.warning('%s: %s', info_data.get('keyboard_folder', 'Unknown Keyboard!'), message) def arm_processor_rules(info_data, rules): """Setup the default info for an ARM board. """ info_data['processor_type'] = 'arm' info_data['protocol'] = 'ChibiOS' info_data['platform_key'] = 'chibios' if 'STM32' in info_data['processor']: info_data['platform'] = 'STM32' elif 'MCU_SERIES' in rules: info_data['platform'] = rules['MCU_SERIES'] elif 'ARM_ATSAM' in rules: info_data['platform'] = 'ARM_ATSAM' info_data['platform_key'] = 'arm_atsam' return info_data def avr_processor_rules(info_data, rules): """Setup the default info for an AVR board. """ info_data['processor_type'] = 'avr' info_data['platform'] = rules['ARCH'] if 'ARCH' in rules else 'unknown' info_data['platform_key'] = 'avr' info_data['protocol'] = 'V-USB' if info_data['processor'] in VUSB_PROCESSORS else 'LUFA' # FIXME(fauxpark/anyone): Eventually we should detect the protocol by looking at PROTOCOL inherited from mcu_selection.mk: # info_data['protocol'] = 'V-USB' if rules.get('PROTOCOL') == 'VUSB' else 'LUFA' return info_data def unknown_processor_rules(info_data, rules): """Setup the default keyboard info for unknown boards. """ info_data['bootloader'] = 'unknown' info_data['platform'] = 'unknown' info_data['processor'] = 'unknown' info_data['processor_type'] = 'unknown' info_data['protocol'] = 'unknown' return info_data def merge_info_jsons(keyboard, info_data): """Return a merged copy of all the info.json files for a keyboard. """ for info_file in find_info_json(keyboard): # Load and validate the JSON data new_info_data = json_load(info_file) if not isinstance(new_info_data, dict): _log_error(info_data, "Invalid file %s, root object should be a dictionary." % (str(info_file),)) continue try: validate(new_info_data, 'qmk.keyboard.v1') except jsonschema.ValidationError as e: json_path = '.'.join([str(p) for p in e.absolute_path]) cli.log.error('Not including data from file: %s', info_file) cli.log.error('\t%s: %s', json_path, e.message) continue # Merge layout data in if 'layout_aliases' in new_info_data: info_data['layout_aliases'] = {**info_data.get('layout_aliases', {}), **new_info_data['layout_aliases']} del new_info_data['layout_aliases'] for layout_name, layout in new_info_data.get('layouts', {}).items(): if layout_name in info_data.get('layout_aliases', {}): _log_warning(info_data, f"info.json uses alias name {layout_name} instead of {info_data['layout_aliases'][layout_name]}") layout_name = info_data['layout_aliases'][layout_name] if layout_name in info_data['layouts']: if len(info_data['layouts'][layout_name]['layout']) != len(layout['layout']): msg = 'Number of keys for %s does not match! info.json specifies %d keys, C macro specifies %d' _log_error(info_data, msg % (layout_name, len(layout['layout']), len(info_data['layouts'][layout_name]['layout']))) else: info_data['layouts'][layout_name]['json_layout'] = True for new_key, existing_key in zip(layout['layout'], info_data['layouts'][layout_name]['layout']): existing_key.update(new_key) else: if not all('matrix' in key_data.keys() for key_data in layout['layout']): _log_error(info_data, f'Layout "{layout_name}" has no "matrix" definition in either "info.json" or ".h"!') else: layout['c_macro'] = False layout['json_layout'] = True info_data['layouts'][layout_name] = layout # Update info_data with the new data if 'layouts' in new_info_data: del new_info_data['layouts'] deep_update(info_data, new_info_data) return info_data def find_info_json(keyboard): """Finds all the info.json files associated with a keyboard. """ # Find the most specific first base_path = Path('keyboards') keyboard_path = base_path / keyboard keyboard_parent = keyboard_path.parent info_jsons = [keyboard_path / 'info.json'] # Add DEFAULT_FOLDER before parents, if present rules = rules_mk(keyboard) if 'DEFAULT_FOLDER' in rules: info_jsons.append(Path(rules['DEFAULT_FOLDER']) / 'info.json') # Add in parent folders for least specific for _ in range(5): if keyboard_parent == base_path: break info_jsons.append(keyboard_parent / 'info.json') keyboard_parent = keyboard_parent.parent # Return a list of the info.json files that actually exist return [info_json for info_json in info_jsons if info_json.exists()] def keymap_json_config(keyboard, keymap): """Extract keymap level config """ # TODO: resolve keymap.py and info.py circular dependencies from qmk.keymap import locate_keymap keymap_folder = locate_keymap(keyboard, keymap).parent km_info_json = parse_configurator_json(keymap_folder / 'keymap.json') ret = km_info_json.get('config', {}) # TODO: dummy code is only to PoC kb/user keycodes if 'keycodes' in km_info_json: ret['user_keycodes'] = km_info_json['keycodes'] return ret def keymap_json(keyboard, keymap): """Generate the info.json data for a specific keymap. """ # TODO: resolve keymap.py and info.py circular dependencies from qmk.keymap import locate_keymap keymap_folder = locate_keymap(keyboard, keymap).parent # Files to scan keymap_config = keymap_folder / 'config.h' keymap_rules = keymap_folder / 'rules.mk' keymap_file = keymap_folder / 'keymap.json' # Build the info.json file kb_info_json = info_json(keyboard) # Merge in the data from keymap.json km_info_json = keymap_json_config(keyboard, keymap) if keymap_file.exists() else {} deep_update(kb_info_json, km_info_json) # Merge in the data from config.h, and rules.mk _extract_rules_mk(kb_info_json, parse_rules_mk_file(keymap_rules)) _extract_config_h(kb_info_json, parse_config_h_file(keymap_config)) return kb_info_json