https://github.com/ikolomiko/ikotv-ir-remote-keyboard

Linux USB gadget driver that maps LIRC events to HID keyboard events
https://github.com/ikolomiko/ikotv-ir-remote-keyboard

hid-keyboard ir-receiver ir-remote linux linux-usb lirc raspberry-pi usb-gadget

Last synced: about 2 months ago
JSON representation

Linux USB gadget driver that maps LIRC events to HID keyboard events

• Host: GitHub
• URL: https://github.com/ikolomiko/ikotv-ir-remote-keyboard
• Owner: ikolomiko
• License: gpl-3.0
• Created: 2024-09-08T12:10:20.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-08T20:20:08.000Z (4 months ago)
• Last Synced: 2024-10-16T20:35:18.199Z (2 months ago)
• Topics: hid-keyboard, ir-receiver, ir-remote, linux, linux-usb, lirc, raspberry-pi, usb-gadget
• Language: C
• Homepage:
• Size: 24.4 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ikoTV IR Remote Keyboard

This project is an amalgamation of [ir-keytable](https://linux.die.net/man/1/ir-keytable), [Composite USB Gadgets on the Raspberry Pi Zero](https://www.isticktoit.net/?p=1383) and [this GitHub Gist containing USB HID keycodes](https://gist.github.com/MightyPork/6da26e382a7ad91b5496ee55fdc73db2).

The IR receiver connected to the GPIO pins of Raspberry Pi Zero receives IR signals and those signals gets decoded by the LIRC modules in the kernel. These IR events are accessible from `/dev/lirc0` and `/dev/input/event0`. This program reads events from these files

and creates corresponding USB HID reports if the received IR remote key is mapped to a specific USB keyboard key. These mappings are hard-coded into the source code to avoid unnecessary complexity. Then, the USB HID reports are transmitted to the host PC via writing them

to the device file `/dev/hidg0`. Essentially, this program makes the Raspberry Pi Zero act like a IR-controlled USB keyboard.

## Build

`` is a placeholder for the actual installation prefix path. The default is `/usr/local` if none is supplied. Should be set to `/usr` when creating a system package.

```sh

meson setup build --prefix=

ninja -C build

```

## Install

```sh

ninja -C build install

```

## Run

Enable and start the systemd unit.

```sh

systemctl enable --now ikotv-usb

```