Skip to content

Latest commit

 

History

History
75 lines (66 loc) · 2.15 KB

README.md

File metadata and controls

75 lines (66 loc) · 2.15 KB
Raw

EvTranslator

Turn any input device to any input device(s) on Linux

Usage

evtranslator /dev/input/eventX /path/to/configuration.lua [--grab] You need to have permissions to open /dev/uinput and the event device you want to use. --grab option will prevent other programs from recieving events from specified input device.

Lua configuration

Before you start read this article to get better understanding how Linux input events work.

Evtranslator uses for inicialization table Devices. It conains specification(s) of device(s).

Devices = { {device1 }, ... }

Device specification might look like this:

Devices = {
  {
    deviceBus = 0, -- optional
    deviceVendor = 0, -- optional
    deviceProduct = 0, -- optional
    deviceVersion = 0, -- optional
    deviceName = "YourDeviceName",
    -- informations about axies
    absInfo = {
      ABS_X = {
        value = 0,
        minimum = -32768,
        maximum = 32767,
        fuzz = 16,
        flat = 128,
        resolution = 0
      },
    },
    -- events that will be advertised on this device
    -- advertise = "input" will advertise all event types and codes from input device
    advertise = {
      EV_KEY = { -- event type
        "KEY_W", -- event code
        "KEY_S",
        "KEY_A",
        "KEY_D"
      }
    }
  }
}

Evtranslator calls to fucntions from Lua file:

  • HandleEvent(event)
    • called for every event from input device
  • Update(deltaTime) (optional)
    • called aproximatelly every 10 miliseconds

Both functions needs to return table of events or nil. Example for sending key press to first device:

return {
  { device = 0, type = "EV_KEY", code = "KEY_W", value = 1 },
  { device = 0, type = "EV_SYN", code = "SYN_REPORT", value = 0 },
}

Chheckout configs directory for examples. You can also use these functions to querry input device for more information:

  • EvTranslator.getABSInfo(axisCode)
    • returns table absInfo for given axis
  • EvTranslator.hasProperty(propertyName)
    • returns bool
  • EvTranslator.hasEventType(evType)
    • returns bool
  • EvTranslator.hasEventCode(evType,evCode)
    • returns bool