device_if, device_unless
Change an event if/unless the event is from specified device.
{
"type": "device_if",
"identifiers": [
{
"vendor_id": 1111,
"product_id": 2222,
"description": "my keyboard 1"
},
{
"vendor_id": 3333,
"product_id": 4444,
"description": "my keyboard 2"
},
...
]
}
Name | Required | Description |
---|---|---|
type |
Required | "device_if" or "device_unless" |
identifiers |
Required | Target device definitions |
description |
Optional | A human-readable comment |
identifiers
identifiers
is an array of objects.
Name | Required | Description |
---|---|---|
vendor_id |
Optional | Vendor ID of device which is fixed value for each device |
product_id |
Optional | Product ID of device which is fixed value for each device |
location_id |
Optional | Location ID of device which is changed by where the port your device is connected |
is_keyboard |
Optional | true or false |
is_pointing_device |
Optional | true or false |
is_touch_bar |
Optional | true or false |
Multiple identifiers
If you specify multiple identifiers (vendor_id
, product_id
, location_id
, …), these are joined by “and”.
The following condition is matched if Vendor ID is 1111 and Product ID is 2222.
{
"type": "device_if",
"identifiers": [
{
"vendor_id": 1111,
"product_id": 2222
}
]
}
Multiple entries
If you specify multiple entries at identifiers
, conditions are joined by “or”.
The following condition is matched if Vendor ID is 1111 or 1112.
{
"type": "device_if",
"identifiers": [
{
"vendor_id": 1111
},
{
"vendor_id": 1112
}
]
}
Investigate the device identifiers
You can find them by EventViewer > Devices tab.
