2 # SPDX-License-Identifier: MIT
4 # This file is distributed under the MIT license, see below.
6 # The MIT License (MIT)
8 # Permission is hereby granted, free of charge, to any person obtaining a copy
9 # of this software and associated documentation files (the "Software"), to deal
10 # in the Software without restriction, including without limitation the rights
11 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 # copies of the Software, and to permit persons to whom the Software is
13 # furnished to do so, subject to the following conditions:
15 # The above copyright notice and this permission notice shall be included in
16 # all copies or substantial portions of the Software.
18 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
21 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
32 from pyparsing
import (Word
, White
, Literal
, ParserElement
, Regex
, LineEnd
,
33 OneOrMore
, Combine
, Or
, Optional
, Suppress
, Group
,
34 nums
, alphanums
, printables
,
35 stringEnd
, pythonStyleComment
,
38 print('pyparsing is not available')
42 from evdev
.ecodes
import ecodes
45 print('WARNING: evdev is not available')
48 from functools
import lru_cache
50 # don't do caching on old python
51 lru_cache
= lambda: (lambda f
: f
)
53 EOL
= LineEnd().suppress()
55 COMMENTLINE
= pythonStyleComment
+ EOL
57 REAL
= Combine((INTEGER
+ Optional('.' + Optional(INTEGER
))) ^
('.' + INTEGER
))
58 SIGNED_REAL
= Combine(Optional(Word('-+')) + REAL
)
59 UDEV_TAG
= Word(string
.ascii_uppercase
, alphanums
+ '_')
61 # Those patterns are used in type-specific matches
62 TYPES
= {'mouse': ('usb', 'bluetooth', 'ps2', '*'),
63 'evdev': ('name', 'atkbd', 'input'),
64 'id-input': ('modalias'),
65 'touchpad': ('i8042', 'rmi', 'bluetooth', 'usb'),
66 'joystick': ('i8042', 'rmi', 'bluetooth', 'usb'),
67 'keyboard': ('name', ),
68 'sensor': ('modalias', ),
71 # Patterns that are used to set general properties on a device
72 GENERAL_MATCHES
= {'acpi',
81 def upperhex_word(length
):
82 return Word(nums
+ 'ABCDEF', exact
=length
)
86 ParserElement
.setDefaultWhitespaceChars('')
88 prefix
= Or(category
+ ':' + Or(conn
) + ':'
89 for category
, conn
in TYPES
.items())
91 matchline_typed
= Combine(prefix
+ Word(printables
+ ' ' + '®'))
92 matchline_general
= Combine(Or(GENERAL_MATCHES
) + ':' + Word(printables
+ ' ' + '®'))
93 matchline
= (matchline_typed | matchline_general
) + EOL
95 propertyline
= (White(' ', exact
=1).suppress() +
96 Combine(UDEV_TAG
- '=' - Optional(Word(alphanums
+ '_=:@*.!-;, "'))
97 - Optional(pythonStyleComment
)) +
99 propertycomment
= White(' ', exact
=1) + pythonStyleComment
+ EOL
101 group
= (OneOrMore(matchline('MATCHES*') ^ COMMENTLINE
.suppress()) -
102 OneOrMore(propertyline('PROPERTIES*') ^ propertycomment
.suppress()) -
103 (EMPTYLINE ^
stringEnd()).suppress())
104 commentgroup
= OneOrMore(COMMENTLINE
).suppress() - EMPTYLINE
.suppress()
106 grammar
= OneOrMore(Group(group
)('GROUPS*') ^ commentgroup
) + stringEnd()
111 def property_grammar():
112 ParserElement
.setDefaultWhitespaceChars(' ')
114 dpi_setting
= (Optional('*')('DEFAULT') + INTEGER('DPI') + Suppress('@') + INTEGER('HZ'))('SETTINGS*')
115 mount_matrix_row
= SIGNED_REAL
+ ',' + SIGNED_REAL
+ ',' + SIGNED_REAL
116 mount_matrix
= (mount_matrix_row
+ ';' + mount_matrix_row
+ ';' + mount_matrix_row
)('MOUNT_MATRIX')
117 xkb_setting
= Optional(Word(alphanums
+ '+-/@._'))
119 props
= (('MOUSE_DPI', Group(OneOrMore(dpi_setting
))),
120 ('MOUSE_WHEEL_CLICK_ANGLE', INTEGER
),
121 ('MOUSE_WHEEL_CLICK_ANGLE_HORIZONTAL', INTEGER
),
122 ('MOUSE_WHEEL_CLICK_COUNT', INTEGER
),
123 ('MOUSE_WHEEL_CLICK_COUNT_HORIZONTAL', INTEGER
),
124 ('ID_AUTOSUSPEND', Literal('1')),
125 ('ID_INPUT', Literal('1')),
126 ('ID_INPUT_ACCELEROMETER', Literal('1')),
127 ('ID_INPUT_JOYSTICK', Literal('1')),
128 ('ID_INPUT_KEY', Literal('1')),
129 ('ID_INPUT_KEYBOARD', Literal('1')),
130 ('ID_INPUT_MOUSE', Literal('1')),
131 ('ID_INPUT_POINTINGSTICK', Literal('1')),
132 ('ID_INPUT_SWITCH', Literal('1')),
133 ('ID_INPUT_TABLET', Literal('1')),
134 ('ID_INPUT_TABLET_PAD', Literal('1')),
135 ('ID_INPUT_TOUCHPAD', Literal('1')),
136 ('ID_INPUT_TOUCHSCREEN', Literal('1')),
137 ('ID_INPUT_TRACKBALL', Literal('1')),
138 ('POINTINGSTICK_SENSITIVITY', INTEGER
),
139 ('POINTINGSTICK_CONST_ACCEL', REAL
),
140 ('ID_INPUT_JOYSTICK_INTEGRATION', Or(('internal', 'external'))),
141 ('ID_INPUT_TOUCHPAD_INTEGRATION', Or(('internal', 'external'))),
142 ('XKB_FIXED_LAYOUT', xkb_setting
),
143 ('XKB_FIXED_VARIANT', xkb_setting
),
144 ('XKB_FIXED_MODEL', xkb_setting
),
145 ('KEYBOARD_LED_NUMLOCK', Literal('0')),
146 ('KEYBOARD_LED_CAPSLOCK', Literal('0')),
147 ('ACCEL_MOUNT_MATRIX', mount_matrix
),
148 ('ACCEL_LOCATION', Or(('display', 'base'))),
149 ('PROXIMITY_NEAR_LEVEL', INTEGER
),
151 fixed_props
= [Literal(name
)('NAME') - Suppress('=') - val('VALUE')
152 for name
, val
in props
]
153 kbd_props
= [Regex(r
'KEYBOARD_KEY_[0-9a-f]+')('NAME')
155 ('!' ^
(Optional('!') - Word(alphanums
+ '_')))('VALUE')
157 abs_props
= [Regex(r
'EVDEV_ABS_[0-9a-f]{2}')('NAME')
159 Word(nums
+ ':')('VALUE')
162 grammar
= Or(fixed_props
+ kbd_props
+ abs_props
) + EOL
167 def error(fmt
, *args
, **kwargs
):
170 print(fmt
.format(*args
, **kwargs
))
172 def convert_properties(group
):
173 matches
= [m
[0] for m
in group
.MATCHES
]
174 props
= [p
[0] for p
in group
.PROPERTIES
]
175 return matches
, props
178 grammar
= hwdb_grammar()
180 with
open(fname
, 'r', encoding
='UTF-8') as f
:
181 parsed
= grammar
.parseFile(f
)
182 except ParseBaseException
as e
:
183 error('Cannot parse {}: {}', fname
, e
)
185 return [convert_properties(g
) for g
in parsed
.GROUPS
]
187 def check_matches(groups
):
188 matches
= sum((group
[0] for group
in groups
), [])
190 # This is a partial check. The other cases could be also done, but those
191 # two are most commonly wrong.
192 grammars
= { 'usb' : 'v' + upperhex_word(4) + Optional('p' + upperhex_word(4)),
193 'pci' : 'v' + upperhex_word(8) + Optional('d' + upperhex_word(8)),
196 for match
in matches
:
197 prefix
, rest
= match
.split(':', maxsplit
=1)
198 gr
= grammars
.get(prefix
)
202 except ParseBaseException
as e
:
203 error('Pattern {!r} is invalid: {}', rest
, e
)
205 if rest
[-1] not in '*:':
206 error('pattern {} does not end with "*" or ":"', match
)
210 for match
in matches
:
212 error('Match {!r} is duplicated', match
)
215 def check_one_default(prop
, settings
):
216 defaults
= [s
for s
in settings
if s
.DEFAULT
]
217 if len(defaults
) > 1:
218 error('More than one star entry: {!r}', prop
)
220 def check_one_mount_matrix(prop
, value
):
221 numbers
= [s
for s
in value
if s
not in {';', ','}]
222 if len(numbers
) != 9:
223 error('Wrong accel matrix: {!r}', prop
)
225 numbers
= [abs(float(number
)) for number
in numbers
]
227 error('Wrong accel matrix: {!r}', prop
)
228 bad_x
, bad_y
, bad_z
= max(numbers
[0:3]) == 0, max(numbers
[3:6]) == 0, max(numbers
[6:9]) == 0
229 if bad_x
or bad_y
or bad_z
:
230 error('Mount matrix is all zero in {} row: {!r}',
231 'x' if bad_x
else ('y' if bad_y
else 'z'),
234 def check_one_keycode(prop
, value
):
235 if value
!= '!' and ecodes
is not None:
236 key
= 'KEY_' + value
.upper()
237 if not (key
in ecodes
or
238 value
.upper() in ecodes
or
239 # new keys added in kernel 5.5
240 'KBD_LCD_MENU' in key
):
241 error('Keycode {} unknown', key
)
243 def check_properties(groups
):
244 grammar
= property_grammar()
245 for matches
, props
in groups
:
249 prop
= prop
.partition('#')[0].rstrip()
251 parsed
= grammar
.parseString(prop
)
252 except ParseBaseException
as e
:
253 error('Failed to parse: {!r}', prop
)
255 # print('{!r}'.format(parsed))
256 if parsed
.NAME
in prop_names
:
257 error('Property {} is duplicated', parsed
.NAME
)
258 prop_names
.add(parsed
.NAME
)
259 if parsed
.NAME
== 'MOUSE_DPI':
260 check_one_default(prop
, parsed
.VALUE
.SETTINGS
)
261 elif parsed
.NAME
== 'ACCEL_MOUNT_MATRIX':
262 check_one_mount_matrix(prop
, parsed
.VALUE
)
263 elif parsed
.NAME
.startswith('KEYBOARD_KEY_'):
264 val
= parsed
.VALUE
if isinstance(parsed
.VALUE
, str) else parsed
.VALUE
[0]
265 check_one_keycode(prop
, val
)
267 def print_summary(fname
, groups
):
268 n_matches
= sum(len(matches
) for matches
, props
in groups
)
269 n_props
= sum(len(props
) for matches
, props
in groups
)
270 print('{}: {} match groups, {} matches, {} properties'
271 .format(fname
, len(groups
), n_matches
, n_props
))
273 if n_matches
== 0 or n_props
== 0:
274 error('{}: no matches or props'.format(fname
))
276 if __name__
== '__main__':
277 args
= sys
.argv
[1:] or sorted(glob
.glob(os
.path
.dirname(sys
.argv
[0]) + '/[67][0-9]-*.hwdb'))
280 groups
= parse(fname
)
281 print_summary(fname
, groups
)
282 check_matches(groups
)
283 check_properties(groups
)