Restructured, implemented X52 vendor commands.

Saitek-X52-PPM.ino

@@ -1,38 +1,93 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on the USB Host Library HID Joystick example
+ * https://www.circuitsathome.com/mcu/hid-joystick-code-sample
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
 #include <hid.h>
 #include <hiduniversal.h>
 #include <usbhub.h>
 
-// Satisfy IDE, which only needs to see the include statment in the ino.
-#ifdef dobogusinclude
-#include <spi4teensy3.h>
-#include <SPI.h>
-#endif
-
-#include "hidjoystickrptparser.h"
+#include "hid_parser.h"
+#include "x52.h"
 
-USB Usb;
-USBHub Hub(&Usb);
-HIDUniversal Hid(&Usb);
-JoystickEvents JoyEvents;
-JoystickReportParser Joy(&JoyEvents);
+USB usb;
+USBHub hub(&usb);
+HIDUniversal hid(&usb);
+X52 x52(&usb, &hid);
+JoystickEvents joyevents;
+JoystickReportParser joy(&joyevents);
 
 void setup() {  
-        Serial.begin(115200);
-#if !defined(__MIPSEL__)
-        while (!Serial); // Wait for serial port to connect - used on Leonardo, Teensy and other boards with built-in USB CDC serial connection
-#endif
-        Serial.println("Start");
+    Serial.begin(115200);
+    Serial.println("Start");
 
-        if (Usb.Init() == -1)
-                Serial.println("OSC did not start.");
+    if (usb.Init() == -1) {
+        Serial.println("OSC did not start.");
+    }
 
-        delay(200);
+    delay(200);
 
-        if (!Hid.SetReportParser(0, &Joy))
-                ErrorMessage<uint8_t > (PSTR("SetReportParser"), 1);
+    if (!hid.SetReportParser(0, &joy)) {
+        ErrorMessage<uint8_t >(PSTR("SetReportParser"), 1);
+    }
 }
 
 void loop() {
-        Usb.Task();
+    usb.Task();
+
+    static unsigned long lastTime = 0;
+    static uint8_t d = 0;
+    if ((millis() - lastTime) >= 500) {
+        //x52.setDate(d, d, d);
+        d++;
+        lastTime = millis();
+
+        String tmp = String(d);
+        //x52.setMFDText(0, tmp.c_str());
+    }
+
+    if (Serial.available()) {
+        char c = Serial.read();
+        if (c == 't') {
+            x52.setMFDText(0, "Arduino");
+            x52.setMFDText(1, "Hello");
+            x52.setMFDText(2, "World");
+        } else if (c == '0') {
+            x52.setMFDBrightness(0);
+        } else if (c == '1') {
+            x52.setMFDBrightness(1);
+        } else if (c == '2') {
+            x52.setMFDBrightness(2);
+        } else if (c == '3') {
+            x52.setLEDBrightness(0);
+        } else if (c == '4') {
+            x52.setLEDBrightness(1);
+        } else if (c == '5') {
+            x52.setLEDBrightness(2);
+        } else if (c == 'q') {
+            x52.setShift(1);
+        } else if (c == 'w') {
+            x52.setShift(0);
+        } else if (c == 'a') {
+            x52.setBlink(1);
+        } else if (c == 's') {
+            x52.setBlink(0);
+        } else if (c == 'z') {
+            x52.setDate(1, 1, 1);
+        } else if (c == 'x') {
+            x52.setTime(12, 42);
+            x52.setTimeOffset(0, -120);
+            x52.setTimeOffset(0, 240);
+        } else {
+            Serial.println("Unknown command!");
+        }
+    }
 }
 

hid_parser.cpp

@@ -0,0 +1,111 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on the USB Host Library HID Joystick example
+ * https://www.circuitsathome.com/mcu/hid-joystick-code-sample
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#include "hid_parser.h"
+
+JoystickReportParser::JoystickReportParser(JoystickEvents* evt)
+        : joyEvents(evt), oldHat(0), oldButtons(0), oldMouse(0) {
+    for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++) {
+        oldPad[i] = 0;
+    }
+}
+
+void JoystickReportParser::Parse(HID* hid, bool is_rpt_id, uint8_t len, uint8_t* bufPart) {
+    if (len == 8) {
+        // First part of buffer, store and do nothing
+        for (uint8_t i = 0; i < 8; i++) {
+            buf[i] = bufPart[i];
+        }
+        return;
+    } else {
+        // Append second part, then evaluate
+        for (uint8_t i = 0; i < len; i++) {
+            buf[i + 8] = bufPart[i];
+        }
+    }
+
+    /*
+    Serial.println("");
+    Serial.print("Packet: ");
+    for (uint8_t i = 0; i < (8 + len); i++) {
+        PrintHex<uint8_t >(buf[i], 0x80);
+        Serial.print(" ");
+    }
+    Serial.println("");
+    Serial.println("");
+    */
+
+    // Checking if there are changes in report since the method was last called
+    bool match = true;
+    for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++) {
+        if (buf[i] != oldPad[i]) {
+            match = false;
+            break;
+        }
+    }
+
+    // Calling Game Pad event handler
+    if (!match && joyEvents) {
+        buffer.X = buf[0] | ((buf[1] & 0x07) << 8);
+        buffer.Y = ((buf[1] & 0xF8) >> 3) | ((buf[2] & 0x3F) << 5);
+        buffer.Rz = ((buf[2] & 0xC0) >> 6) | (buf[3] << 2);
+        buffer.Z = buf[4];
+        buffer.Rx = buf[5];
+        buffer.Ry = buf[6];
+        buffer.Slider = buf[7];
+
+        joyEvents->OnGamePadChanged((const GamePadEventData*)&buffer);
+
+        for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++) {
+            oldPad[i] = buf[i];
+        }
+    }
+
+    // Calling Hat Switch event handler`
+    uint8_t hat = (buf[12] & 0xF0) >> 4;
+    if (hat != oldHat && joyEvents) {
+        joyEvents->OnHatSwitch(hat);
+        oldHat = hat;
+    }
+
+    uint64_t buttons = buf[12] & 0x03;
+    buttons <<= 8;
+    buttons |= buf[11];
+    buttons <<= 8;
+    buttons |= buf[10];
+    buttons <<= 8;
+    buttons |= buf[9];
+    buttons <<= 8;
+    buttons |= buf[8];
+
+    // Calling Button Event Handler for every button changed
+    uint64_t changes = (buttons ^ oldButtons);
+    if (changes) {
+        for (uint8_t i = 0; i < 34; i++) {
+            uint64_t mask = (1ull << i);
+            if ((mask & changes) && joyEvents) {
+                if (buttons & mask) {
+                    joyEvents->OnButtonDn(i);
+                } else {
+                    joyEvents->OnButtonUp(i);
+                }
+            }
+        }
+        oldButtons = buttons;
+    }
+
+    if (oldMouse != buf[13] && joyEvents) {
+        oldMouse = buf[13];
+        joyEvents->OnMouseMoved((buf[13] & 0xF0) >> 4, buf[13] & 0x0F);
+    }
+}
+

hid_parser.h

@@ -0,0 +1,39 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on the USB Host Library HID Joystick example
+ * https://www.circuitsathome.com/mcu/hid-joystick-code-sample
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#ifndef __HID_PARSER_H__
+#define __HID_PARSER_H__
+
+#include <hid.h>
+#include "joystick_events.h"
+
+#define RPT_GEMEPAD_LEN 8
+#define BUFFER_SIZE 16
+
+class JoystickReportParser : public HIDReportParser {
+    JoystickEvents* joyEvents;
+
+    uint8_t buf[BUFFER_SIZE];
+    uint8_t oldPad[RPT_GEMEPAD_LEN];
+    uint8_t oldHat;
+    uint64_t oldButtons;
+    uint8_t oldMouse;
+    GamePadEventData buffer;
+
+  public:
+    JoystickReportParser(JoystickEvents* evt);
+
+    virtual void Parse(HID* hid, bool is_rpt_id, uint8_t len, uint8_t* bufPart);
+};
+
+#endif // __HID_PARSER_H__
+

hidjoystickrptparser.cpp

@@ -1,141 +0,0 @@
-#include "hidjoystickrptparser.h"
-
-/*
- * Adapted for the Saitek X52 flight controller
- */
-
-JoystickReportParser::JoystickReportParser(JoystickEvents *evt) :
-joyEvents(evt), oldHat(0), oldButtons(0), oldMouse(0) {
-        for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++)
-                oldPad[i] = 0;
-}
-
-void JoystickReportParser::Parse(HID *hid, bool is_rpt_id, uint8_t len, uint8_t *bufPart) {
-        if (len == 8) {
-          // First part of buffer, store and do nothing
-          for (uint8_t i = 0; i < 8; i++) {
-            buf[i] = bufPart[i];
-          }
-          return;
-        } else {
-          // Append second part, then evaluate
-          for (uint8_t i = 0; i < len; i++) {
-            buf[i + 8] = bufPart[i];
-          }
-        }
-
-        /*
-        Serial.println("");
-        Serial.print("Packet: ");
-        for (uint8_t i = 0; i < (8 + len); i++) {
-          PrintHex<uint8_t >(buf[i], 0x80);
-          Serial.print(" ");
-        }
-        Serial.println("");
-        Serial.println("");
-        */
-
-        // Checking if there are changes in report since the method was last called
-        bool match = true;
-        for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++)
-                if (buf[i] != oldPad[i]) {
-                        match = false;
-                        break;
-                }
-
-        // Calling Game Pad event handler
-        if (!match && joyEvents) {
-                buffer.X = buf[0] | ((buf[1] & 0x07) << 8);
-                buffer.Y = ((buf[1] & 0xF8) >> 3) | ((buf[2] & 0x3F) << 5);
-                buffer.Rz = ((buf[2] & 0xC0) >> 6) | (buf[3] << 2);
-                buffer.Z = buf[4];
-                buffer.Rx = buf[5];
-                buffer.Ry = buf[6];
-                buffer.Slider = buf[7];
-                
-                joyEvents->OnGamePadChanged((const GamePadEventData*)&buffer);
-
-                for (uint8_t i = 0; i < RPT_GEMEPAD_LEN; i++) oldPad[i] = buf[i];
-        }
-
-        // Calling Hat Switch event handler`
-        uint8_t hat = (buf[12] & 0xF0) >> 4;
-        if (hat != oldHat && joyEvents) {
-                joyEvents->OnHatSwitch(hat);
-                oldHat = hat;
-        }
-
-        uint64_t buttons = buf[12] & 0x03;
-        buttons <<= 8;
-        buttons |= buf[11];
-        buttons <<= 8;
-        buttons |= buf[10];
-        buttons <<= 8;
-        buttons |= buf[9];
-        buttons <<= 8;
-        buttons |= buf[8];
-
-        // Calling Button Event Handler for every button changed
-        uint64_t changes = (buttons ^ oldButtons);
-        if (changes) {
-                for (uint8_t i = 0; i < 34; i++) {
-                        uint64_t mask = (1ull << i);
-                        if ((mask & changes) && joyEvents) {
-                                if (buttons & mask) {
-                                        joyEvents->OnButtonDn(i);
-                                } else {
-                                        joyEvents->OnButtonUp(i);
-                                }
-                        }
-                }
-                oldButtons = buttons;
-        }
-
-        if (oldMouse != buf[13] && joyEvents) {
-          oldMouse = buf[13];
-          joyEvents->OnMouseMoved((buf[13] & 0xF0) >> 4, buf[13] & 0x0F);
-        }
-}
-
-void JoystickEvents::OnGamePadChanged(const GamePadEventData *evt) {
-        Serial.print("X: ");
-        PrintHex<uint16_t > (evt->X, 0x80);
-        Serial.print("\tY: ");
-        PrintHex<uint16_t > (evt->Y, 0x80);
-        Serial.print("\tZ: ");
-        PrintHex<uint8_t > (evt->Z, 0x80);
-        Serial.print("\tRx: ");
-        PrintHex<uint8_t > (evt->Rx, 0x80);
-        Serial.print("\tRy: ");
-        PrintHex<uint8_t > (evt->Ry, 0x80);
-        Serial.print("\tRz: ");
-        PrintHex<uint16_t > (evt->Rz, 0x80);
-        Serial.print("\tSlider: ");
-        PrintHex<uint8_t > (evt->Slider, 0x80);
-        Serial.println("");
-}
-
-void JoystickEvents::OnHatSwitch(uint8_t hat) {
-        Serial.print("Hat Switch: ");
-        PrintHex<uint8_t > (hat, 0x80);
-        Serial.println("");
-}
-
-void JoystickEvents::OnButtonUp(uint8_t but_id) {
-        Serial.print("Up: ");
-        Serial.println(but_id, DEC);
-}
-
-void JoystickEvents::OnButtonDn(uint8_t but_id) {
-        Serial.print("Dn: ");
-        Serial.println(but_id, DEC);
-}
-
-void JoystickEvents::OnMouseMoved(uint8_t x, uint8_t y) {
-        Serial.print("Mouse X: ");
-        PrintHex<uint8_t >(x, 0x80);
-        Serial.print("\tY: ");
-        PrintHex<uint8_t >(y, 0x80);
-        Serial.println("");
-}
-

hidjoystickrptparser.h

@@ -1,44 +0,0 @@
-#if !defined(__HIDJOYSTICKRPTPARSER_H__)
-#define __HIDJOYSTICKRPTPARSER_H__
-
-#include <hid.h>
-
-/*
- * Adapted for the Saitek X52 flight controller
- */
-
-struct GamePadEventData {
-        uint16_t X, Y, Rz; // 11bit, 11bit, 10bit
-        uint8_t Z, Rx, Ry, Slider;
-};
-
-class JoystickEvents {
-public:
-        virtual void OnGamePadChanged(const GamePadEventData *evt);
-        virtual void OnHatSwitch(uint8_t hat);
-        virtual void OnButtonUp(uint8_t but_id);
-        virtual void OnButtonDn(uint8_t but_id);
-        virtual void OnMouseMoved(uint8_t x, uint8_t y);
-};
-
-#define RPT_GEMEPAD_LEN 8
-#define BUFFER_SIZE 16
-
-class JoystickReportParser : public HIDReportParser {
-        JoystickEvents *joyEvents;
-
-        uint8_t buf[BUFFER_SIZE];
-        uint8_t oldPad[RPT_GEMEPAD_LEN];
-        uint8_t oldHat;
-        uint64_t oldButtons;
-        uint8_t oldMouse;
-        GamePadEventData buffer;
-
-public:
-        JoystickReportParser(JoystickEvents *evt);
-
-        virtual void Parse(HID *hid, bool is_rpt_id, uint8_t len, uint8_t *bufPart);
-};
-
-#endif // __HIDJOYSTICKRPTPARSER_H__
-

joystick_events.cpp

@@ -0,0 +1,56 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on the USB Host Library HID Joystick example
+ * https://www.circuitsathome.com/mcu/hid-joystick-code-sample
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#include "hid_parser.h"
+
+void JoystickEvents::OnGamePadChanged(const GamePadEventData *evt) {
+    Serial.print("X: ");
+    PrintHex<uint16_t > (evt->X, 0x80);
+    Serial.print("\tY: ");
+    PrintHex<uint16_t > (evt->Y, 0x80);
+    Serial.print("\tZ: ");
+    PrintHex<uint8_t > (evt->Z, 0x80);
+    Serial.print("\tRx: ");
+    PrintHex<uint8_t > (evt->Rx, 0x80);
+    Serial.print("\tRy: ");
+    PrintHex<uint8_t > (evt->Ry, 0x80);
+    Serial.print("\tRz: ");
+    PrintHex<uint16_t > (evt->Rz, 0x80);
+    Serial.print("\tSlider: ");
+    PrintHex<uint8_t > (evt->Slider, 0x80);
+    Serial.println("");
+}
+
+void JoystickEvents::OnHatSwitch(uint8_t hat) {
+    Serial.print("Hat Switch: ");
+    PrintHex<uint8_t > (hat, 0x80);
+    Serial.println("");
+}
+
+void JoystickEvents::OnButtonUp(uint8_t but_id) {
+    Serial.print("Up: ");
+    Serial.println(but_id, DEC);
+}
+
+void JoystickEvents::OnButtonDn(uint8_t but_id) {
+    Serial.print("Dn: ");
+    Serial.println(but_id, DEC);
+}
+
+void JoystickEvents::OnMouseMoved(uint8_t x, uint8_t y) {
+    Serial.print("Mouse X: ");
+    PrintHex<uint8_t >(x, 0x80);
+    Serial.print("\tY: ");
+    PrintHex<uint8_t >(y, 0x80);
+    Serial.println("");
+}
+

joystick_events.h

@@ -0,0 +1,31 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on the USB Host Library HID Joystick example
+ * https://www.circuitsathome.com/mcu/hid-joystick-code-sample
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#ifndef __JOYSTICK_EVENTS_H__
+#define __JOYSTICK_EVENTS_H__
+
+struct GamePadEventData {
+    uint16_t X, Y, Rz; // 11bit, 11bit, 10bit
+    uint8_t Z, Rx, Ry, Slider;
+};
+
+class JoystickEvents {
+  public:
+    virtual void OnGamePadChanged(const GamePadEventData *evt);
+    virtual void OnHatSwitch(uint8_t hat);
+    virtual void OnButtonUp(uint8_t but_id);
+    virtual void OnButtonDn(uint8_t but_id);
+    virtual void OnMouseMoved(uint8_t x, uint8_t y);
+};
+
+#endif // __JOYSTICK_EVENTS_H__
+

x52.cpp

@@ -0,0 +1,163 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on "x52pro-linux" by Nirenjan Krishnan
+ * https://github.com/nirenjan/x52pro-linux
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#include "x52.h"
+
+#define TIME_24H_FORMAT
+#define DEBUG_OUTPUT
+
+X52::X52(USB* u, HID* h) : usb(u), hid(h) { }
+
+void X52::setTime(uint8_t h, uint8_t m) {
+    uint8_t ret = sendCommand(X52_TIME_CLOCK1, m | ((h & 0x7F) << 8)
+#ifdef TIME_24H_FORMAT
+            | (1 << 15)
+#endif
+            );
+    if (ret) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error setting time: ");
+        Serial.println(ret, DEC);
+#endif
+    }
+}
+
+void X52::setTimeOffset(uint8_t cl, int16_t offset) {
+    if (offset < -1023) {
+        offset = -1023;
+    }
+    
+    if (offset > 1023) {
+        offset = 1023;
+    }
+    
+    uint8_t negative = 0;
+    if (offset < 0) {
+        negative = 1;
+        offset = -offset;
+    }
+
+    uint8_t ret = sendCommand(cl ? X52_OFFS_CLOCK3 : X52_OFFS_CLOCK2,
+            (negative << 10) | (offset & 0x03FF)
+#ifdef TIME_24H_FORMAT
+            | (1 << 15)
+#endif
+            );
+    if (ret) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error setting offset: ");
+        Serial.println(ret, DEC);
+#endif
+    }
+}
+
+void X52::setDate(uint8_t dd, uint8_t mm, uint8_t yy) {
+    uint8_t ret = sendCommand(X52_DATE_DDMM, dd | (mm << 8));
+    if (!ret) {
+        ret = sendCommand(X52_DATE_YEAR, yy);
+    }
+    if (ret) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error setting date: ");
+        Serial.println(ret, DEC);
+#endif
+    }
+}
+
+void X52::setBlink(uint8_t state) {
+    uint8_t ret = sendCommand(X52_BLINK_INDICATOR, state ? X52_BLINK_ON : X52_BLINK_OFF);
+    if (ret != 0) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error setting blink: ");
+        Serial.println(ret, DEC);
+#endif
+    }
+}
+
+void X52::setShift(uint8_t state) {
+    uint8_t ret = sendCommand(X52_SHIFT_INDICATOR, state ? X52_SHIFT_ON : X52_SHIFT_OFF);
+    if (ret != 0) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error setting shift: ");
+        Serial.println(ret, DEC);
+#endif
+    }
+}
+
+void X52::setMFDText(uint8_t line, const char* text) {
+    const static uint16_t lines[3] = {
+        X52_MFD_LINE1,
+        X52_MFD_LINE2,
+        X52_MFD_LINE3
+    };
+
+    if (line >= 3) {
+        return;
+    }
+
+    uint8_t ret = sendCommand(X52_MFD_CLEAR_LINE | lines[line], 0);
+    if (ret) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Error clearing line: ");
+        Serial.println(ret, DEC);
+#endif
+        return;
+    }
+
+    for (uint8_t i = 0; i < 16; i += 2) {
+        if (text[i] == '\0') {
+            break;
+        }
+
+        uint16_t value = text[i];
+
+        if (text[i + 1] != '\0') {
+            value |= text[i + 1] << 8;
+        }
+
+        ret = sendCommand(X52_MFD_WRITE_LINE | lines[line], value);
+        if (ret) {
+#ifdef DEBUG_OUTPUT
+            Serial.print("Error writing to line: ");
+            Serial.println(ret, DEC);
+#endif
+            return;
+        }
+
+        if (text[i + 1] == '\0') {
+            break;
+        }
+    }
+}
+
+uint8_t X52::sendCommand(uint16_t command, uint16_t val) {
+    const uint8_t valLo = (val & 0x00FF);
+    const uint8_t valHi = (val & 0xFF00) >> 8;
+
+#ifdef DEBUG_OUTPUT
+    Serial.println("Sending X52 Ctrl-Req...");
+#endif
+
+    uint8_t ret = usb->ctrlReq(hid->GetAddress(), 0,
+                              USB_SETUP_TYPE_VENDOR | USB_SETUP_RECIPIENT_DEVICE,
+                              X52_VENDOR_REQUEST, valLo, valHi, command,
+                              0, 0, NULL, NULL);
+    if (ret != 0) {
+#ifdef DEBUG_OUTPUT
+        Serial.print("Ctrl-Req Error Code: ");
+        Serial.println(val, DEC);
+#endif
+    }
+
+    return ret;
+}
+

x52.h

@@ -0,0 +1,86 @@
+/*
+ * Saitek X52 Arduino USB Host Shield Library.
+ * Copyright 2016 by Thomas Buck <xythobuz@xythobuz.de>
+ * 
+ * Based on "x52pro-linux" by Nirenjan Krishnan
+ * https://github.com/nirenjan/x52pro-linux
+ * 
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation, version 2.
+ */
+
+#ifndef __X52_H__
+#define __X52_H__
+
+#include <hid.h>
+
+#define X52_VENDOR_REQUEST 0x91
+#define X52_MFD_BRIGHTNESS 0xB1
+#define X52_LED_BRIGHTNESS 0xB2
+#define X52_MFD_CLEAR_LINE 0x08
+#define X52_MFD_WRITE_LINE 0x00
+#define X52_MFD_LINE1 0xD1
+#define X52_MFD_LINE2 0xD2
+#define X52_MFD_LINE3 0xD4
+#define X52_SHIFT_INDICATOR 0xFD
+#define X52_SHIFT_ON 0x51
+#define X52_SHIFT_OFF 0x50
+#define X52_BLINK_INDICATOR 0xB4
+#define X52_BLINK_ON 0x51
+#define X52_BLINK_OFF 0x50
+#define X52_DATE_DDMM 0xC4
+#define X52_DATE_YEAR 0xC8
+#define X52_TIME_CLOCK1 0xC0
+#define X52_OFFS_CLOCK2 0xC1
+#define X52_OFFS_CLOCK3 0xC2
+
+class X52 {
+  public:
+    X52(USB* u, HID* h);
+
+    /*
+     * Set brightness of LEDs and MFD backlight.
+     * Three states, 0=off, 1=dim, 2=on.
+     */
+    void setLEDBrightness(uint16_t val) { sendCommand(X52_LED_BRIGHTNESS, val); }
+    void setMFDBrightness(uint16_t val) { sendCommand(X52_MFD_BRIGHTNESS, val); }
+    
+    /*
+     * Print text on the MFD lines (0 - 2).
+     * Maximum of 16 characters per line.
+     */
+    void setMFDText(uint8_t line, const char* text);
+
+    /*
+     * Enable (1) or Disable(0) the MFD shift indicator.
+     */
+    void setShift(uint8_t state);
+
+    /*
+     * Fast blinking of Info and Hat LEDs.
+     * State can be 0=off or 1=on.
+     */
+    void setBlink(uint8_t state);
+
+    /*
+     * Set date. The third digit seems to be broken in hardware?
+     */
+    void setDate(uint8_t dd, uint8_t mm, uint8_t yy);
+
+    /*
+     * Set time. There seems to be a problem with time offsets
+     * and the 12h/24h time format conflicting...?
+     */
+    void setTime(uint8_t h, uint8_t m);
+    void setTimeOffset(uint8_t cl, int16_t offset);
+
+  private:
+    uint8_t sendCommand(uint16_t command, uint16_t val);
+    
+    USB* usb;
+    HID* hid;
+};
+
+#endif // __X52_H__
+