#logitech #sdk #gaming #lcd #bindings #keyboard #screen

logitech-lcd-sys

FFI bindings and loader for the Logitech LCD SDK

2 stable releases

Uses old Rust 2015

2.0.0 May 24, 2018
1.0.4 Jun 20, 2017

#1432 in Hardware support


Used in logitech-lcd

MIT/Apache

13KB
221 lines

logitech-lcd

Build status crates.io docs.rs

Rust bindings for the Logitech Gaming LCD/Gamepanel SDK

Overview

The Logitech LCD/GamePanel SDK introduces second screen capability that allows GamePanel-enabled Logitech gaming keyboards to display in-game info, system statistics, and more. The SDK enables integration of GamePanel functionality within your code.

Documentation

Supported Devices

  • G19 - 320x240 Full RGBA (Untested)
  • G510 - 160x43 Monochrome (Working)
  • G13 - 160x43 Monochrome (Untested)
  • G15 v1 - 160x43 Monochrome (Untested)
  • G15 v2 - 160x43 Monochrome (Untested)
  • LCD emulator - 160x43 Monochrome (Working)
  • LCD emulator - 320x240 Full RGBA (Working)

LCD Emulator

The Logitech Gaming Software comes with an LCD emulator. You can access it by going to your task bar tray CTRL + SHIFT + RIGHT CLICK on Logitech Gaming Software tray icon and press "LCD Emulator"

Requirements

Dynamic Loading

This crate will try to locate and load LogitechLcd.dll at runtime. We start by looking up the CLSID in the Windows registry, if it’s found we load the library with a call to LoadLibrary() with the full path. If it fails we call LoadLibrary() with just the DLL name. This will search your PATH for the library.

Examples

Hello World Monochrome

extern crate logitech_lcd;

fn main() {
    let mut driver = logitech_lcd::Driver::init_mono("Hello World").unwrap();

    driver.set_mono_text(1, "        Hello World!").unwrap();
    driver.update();

    std::thread::sleep(std::time::Duration::from_millis(5000));
}

hello-world-mono

Hello World Color

extern crate logitech_lcd;
use logitech_lcd::{Driver, COLOR_WIDTH, COLOR_HEIGHT, COLOR_BYTES_PER_PIXEL};

fn main() {
    let blank_screen = std::iter::repeat(255u8).take(
        COLOR_WIDTH * COLOR_HEIGHT * COLOR_BYTES_PER_PIXEL).collect::<Vec<u8>>();

    let mut driver = Driver::init_color("Color image app").unwrap();
    driver.set_color_background(&blank_screen[..]).unwrap();

    driver.set_color_title("  Hello World!", 0, 0, 0).unwrap();

    driver.set_color_text(0, "Red",     0xFF, 0x00, 0x00).unwrap();
    driver.set_color_text(1, "Green",   0x00, 0xFF, 0x00).unwrap();
    driver.set_color_text(2, "Blue",    0x00, 0x00, 0xFF).unwrap();
    driver.set_color_text(3, "Yellow",  0xFF, 0xFF, 0x00).unwrap();
    driver.set_color_text(4, "Cyan ",   0x00, 0xFF, 0xFF).unwrap();
    driver.set_color_text(5, "Magenta", 0xFF, 0x00, 0xFF).unwrap();
    driver.update();

    std::thread::sleep(std::time::Duration::from_millis(10000));
}

hello-world-color

The artifacts should only be visible in the emulator.

Monochrome Image

/examples/mono-image.rs

image-mono

Color Image

/examples/color-image.rs

image-color

License

Code

Licensed under either of

Art

The Rust and Cargo logos (bitmap and vector) are owned by Mozilla and distributed under the terms of the Creative Commons Attribution license (CC-BY)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.


lib.rs:

FFI bindings and loader for the Logitech LCD SDK

LogitechLcd will try to locate and load LogitechLcd.dll at Runtime for dynamic linking.

Dependencies

~135KB