// Copyright (c) 2014 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include #include "device/hid/hid_report_descriptor.h" #include "testing/gmock/include/gmock/gmock.h" #include "testing/gtest/include/gtest/gtest.h" using namespace testing; namespace device { namespace { // Digitizer descriptor from HID descriptor tool // http://www.usb.org/developers/hidpage/dt2_4.zip const uint8_t kDigitizer[] = { 0x05, 0x0d, // Usage Page (Digitizer) 0x09, 0x01, // Usage (0x1) 0xa1, 0x01, // Collection (Application) 0x85, 0x01, // Report ID (0x1) 0x09, 0x21, // Usage (0x21) 0xa1, 0x00, // Collection (Physical) 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x30, // Usage (0x30) 0x09, 0x31, // Usage (0x31) 0x75, 0x10, // Report Size (16) 0x95, 0x02, // Report Count (2) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xe0, 0x2e, // Logical Maximum (12000) 0x35, 0x00, // Physical Minimum (0) 0x45, 0x0c, // Physical Maximum (12) 0x65, 0x13, // Unit (19) 0x55, 0x00, // Unit Exponent (0) 0xa4, // Push 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x05, 0x0d, // Usage Page (Digitizer) 0x09, 0x32, // Usage (0x32) 0x09, 0x44, // Usage (0x44) 0x09, 0x42, // Usage (0x42) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x35, 0x00, // Physical Minimum (0) 0x45, 0x01, // Physical Maximum (1) 0x75, 0x01, // Report Size (1) 0x95, 0x03, // Report Count (3) 0x65, 0x00, // Unit (0) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x01, // Report Count (1) 0x75, 0x05, // Report Size (5) 0x81, 0x03, // Input (Con|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xc0, // End Collection 0x85, 0x02, // Report ID (0x2) 0x09, 0x20, // Usage (0x20) 0xa1, 0x00, // Collection (Physical) 0xb4, // Pop 0xa4, // Push 0x09, 0x30, // Usage (0x30) 0x09, 0x31, // Usage (0x31) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x05, 0x0d, // Usage Page (Digitizer) 0x09, 0x32, // Usage (0x32) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x35, 0x00, // Physical Minimum (0) 0x45, 0x01, // Physical Maximum (1) 0x65, 0x00, // Unit (0) 0x75, 0x01, // Report Size (1) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x05, 0x09, // Usage Page (Button) 0x19, 0x00, // Usage Minimum (0) 0x29, 0x10, // Usage Maximum (16) 0x25, 0x10, // Logical Maximum (16) 0x75, 0x05, // Report Size (5) 0x81, 0x40, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|Null|BitF) 0x75, 0x02, // Report Size (2) 0x81, 0x01, // Input (Con|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xc0, // End Collection 0x85, 0x03, // Report ID (0x3) 0x05, 0x0d, // Usage Page (Digitizer) 0x09, 0x20, // Usage (0x20) 0xa1, 0x00, // Collection (Physical) 0xb4, // Pop 0x09, 0x30, // Usage (0x30) 0x09, 0x31, // Usage (0x31) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x05, 0x0d, // Usage Page (Digitizer) 0x09, 0x32, // Usage (0x32) 0x09, 0x44, // Usage (0x44) 0x75, 0x01, // Report Size (1) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x35, 0x00, // Physical Minimum (0) 0x45, 0x01, // Physical Maximum (1) 0x65, 0x00, // Unit (0) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x06, // Report Count (6) 0x81, 0x03, // Input (Con|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x09, 0x30, // Usage (0x30) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x7f, // Logical Maximum (127) 0x35, 0x00, // Physical Minimum (0) 0x45, 0x2d, // Physical Maximum (45) 0x67, 0x11, 0xe1, // Unit (57617) 0x00, 0x00, // Default 0x55, 0x04, // Unit Exponent (4) 0x75, 0x08, // Report Size (8) 0x95, 0x01, // Report Count (1) 0x81, 0x12, // Input (Dat|Arr|Rel|NoWrp|NoLin|Prf|NoNull|BitF) 0xc0, // End Collection 0xc0 // End Collection }; // Keyboard descriptor from HID descriptor tool // http://www.usb.org/developers/hidpage/dt2_4.zip const uint8_t kKeyboard[] = { 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x06, // Usage (0x6) 0xa1, 0x01, // Collection (Application) 0x05, 0x07, // Usage Page (Keyboard) 0x19, 0xe0, // Usage Minimum (224) 0x29, 0xe7, // Usage Maximum (231) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x75, 0x01, // Report Size (1) 0x95, 0x08, // Report Count (8) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x01, // Report Count (1) 0x75, 0x08, // Report Size (8) 0x81, 0x03, // Input (Con|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x05, // Report Count (5) 0x75, 0x01, // Report Size (1) 0x05, 0x08, // Usage Page (Led) 0x19, 0x01, // Usage Minimum (1) 0x29, 0x05, // Usage Maximum (5) 0x91, 0x02, // Output (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x01, // Report Count (1) 0x75, 0x03, // Report Size (3) 0x91, 0x03, // Output (Con|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x06, // Report Count (6) 0x75, 0x08, // Report Size (8) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x65, // Logical Maximum (101) 0x05, 0x07, // Usage Page (Keyboard) 0x19, 0x00, // Usage Minimum (0) 0x29, 0x65, // Usage Maximum (101) 0x81, 0x00, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xc0 // End Collection }; // Monitor descriptor from HID descriptor tool // http://www.usb.org/developers/hidpage/dt2_4.zip const uint8_t kMonitor[] = { 0x05, 0x80, // Usage Page (Monitor 0) 0x09, 0x01, // Usage (0x1) 0xa1, 0x01, // Collection (Application) 0x85, 0x01, // Report ID (0x1) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xff, 0x00, // Logical Maximum (255) 0x75, 0x08, // Report Size (8) 0x95, 0x80, // Report Count (128) 0x09, 0x02, // Usage (0x2) 0xb2, 0x02, 0x01, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|Buff) 0x85, 0x02, // Report ID (0x2) 0x95, 0xf3, // Report Count (243) 0x09, 0x03, // Usage (0x3) 0xb2, 0x02, 0x01, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|Buff) 0x85, 0x03, // Report ID (0x3) 0x05, 0x82, // Usage Page (Monitor 2) 0x95, 0x01, // Report Count (1) 0x75, 0x10, // Report Size (16) 0x26, 0xc8, 0x00, // Logical Maximum (200) 0x09, 0x10, // Usage (0x10) 0xb1, 0x02, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x85, 0x04, // Report ID (0x4) 0x25, 0x64, // Logical Maximum (100) 0x09, 0x12, // Usage (0x12) 0xb1, 0x02, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x06, // Report Count (6) 0x26, 0xff, 0x00, // Logical Maximum (255) 0x09, 0x16, // Usage (0x16) 0x09, 0x18, // Usage (0x18) 0x09, 0x1a, // Usage (0x1A) 0x09, 0x6c, // Usage (0x6C) 0x09, 0x6e, // Usage (0x6E) 0x09, 0x70, // Usage (0x70) 0xb1, 0x02, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x85, 0x05, // Report ID (0x5) 0x25, 0x7f, // Logical Maximum (127) 0x09, 0x20, // Usage (0x20) 0x09, 0x22, // Usage (0x22) 0x09, 0x30, // Usage (0x30) 0x09, 0x32, // Usage (0x32) 0x09, 0x42, // Usage (0x42) 0x09, 0x44, // Usage (0x44) 0xb1, 0x02, // Feature (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xc0 // End Collection }; // Mouse descriptor from HID descriptor tool // http://www.usb.org/developers/hidpage/dt2_4.zip const uint8_t kMouse[] = { 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x02, // Usage (0x2) 0xa1, 0x01, // Collection (Application) 0x09, 0x01, // Usage (0x1) 0xa1, 0x00, // Collection (Physical) 0x05, 0x09, // Usage Page (Button) 0x19, 0x01, // Usage Minimum (1) 0x29, 0x03, // Usage Maximum (3) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x95, 0x03, // Report Count (3) 0x75, 0x01, // Report Size (1) 0x81, 0x02, // Input (Dat|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x95, 0x01, // Report Count (1) 0x75, 0x05, // Report Size (5) 0x81, 0x03, // Input (Con|Arr|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x30, // Usage (0x30) 0x09, 0x31, // Usage (0x31) 0x15, 0x81, // Logical Minimum (129) 0x25, 0x7f, // Logical Maximum (127) 0x75, 0x08, // Report Size (8) 0x95, 0x02, // Report Count (2) 0x81, 0x06, // Input (Dat|Arr|Abs|NoWrp|Lin|Prf|NoNull|BitF) 0xc0, // End Collection 0xc0 // End Collection }; // Logitech Unifying receiver descriptor const uint8_t kLogitechUnifyingReceiver[] = { 0x06, 0x00, 0xFF, // Usage Page (Vendor) 0x09, 0x01, // Usage (0x1) 0xA1, 0x01, // Collection (Application) 0x85, 0x10, // Report ID (0x10) 0x75, 0x08, // Report Size (8) 0x95, 0x06, // Report Count (6) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xFF, 0x00, // Logical Maximum (255) 0x09, 0x01, // Usage (0x1) 0x81, 0x00, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x09, 0x01, // Usage (0x1) 0x91, 0x00, // Output (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xC0, // End Collection 0x06, 0x00, 0xFF, // Usage Page (Vendor) 0x09, 0x02, // Usage (0x2) 0xA1, 0x01, // Collection (Application) 0x85, 0x11, // Report ID (0x11) 0x75, 0x08, // Report Size (8) 0x95, 0x13, // Report Count (19) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xFF, 0x00, // Logical Maximum (255) 0x09, 0x02, // Usage (0x2) 0x81, 0x00, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x09, 0x02, // Usage (0x2) 0x91, 0x00, // Output (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xC0, // End Collection 0x06, 0x00, 0xFF, // Usage Page (Vendor) 0x09, 0x04, // Usage (0x4) 0xA1, 0x01, // Collection (Application) 0x85, 0x20, // Report ID (0x20) 0x75, 0x08, // Report Size (8) 0x95, 0x0E, // Report Count (14) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xFF, 0x00, // Logical Maximum (255) 0x09, 0x41, // Usage (0x41) 0x81, 0x00, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x09, 0x41, // Usage (0x41) 0x91, 0x00, // Output (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x85, 0x21, // Report ID (0x21) 0x95, 0x1F, // Report Count (31) 0x15, 0x00, // Logical Minimum (0) 0x26, 0xFF, 0x00, // Logical Maximum (255) 0x09, 0x42, // Usage (0x42) 0x81, 0x00, // Input (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0x09, 0x42, // Usage (0x42) 0x91, 0x00, // Output (Dat|Var|Rel|NoWrp|Lin|Prf|NoNull|BitF) 0xC0 // End Collection }; } // namespace class HidReportDescriptorTest : public testing::Test { protected: virtual void SetUp() OVERRIDE { descriptor_ = NULL; } virtual void TearDown() OVERRIDE { if (descriptor_) { delete descriptor_; } } public: void ValidateDetails( const std::vector& expected_collections, const int expected_max_input_report_size, const int expected_max_output_report_size, const int expected_max_feature_report_size, const uint8_t* bytes, size_t size) { descriptor_ = new HidReportDescriptor(bytes, size); std::vector actual_collections; int actual_max_input_report_size; int actual_max_output_report_size; int actual_max_feature_report_size; descriptor_->GetDetails(&actual_collections, &actual_max_input_report_size, &actual_max_output_report_size, &actual_max_feature_report_size); ASSERT_EQ(expected_collections.size(), actual_collections.size()); std::vector::const_iterator actual_collections_iter = actual_collections.begin(); std::vector::const_iterator expected_collections_iter = expected_collections.begin(); while (expected_collections_iter != expected_collections.end() && actual_collections_iter != actual_collections.end()) { HidCollectionInfo expected_collection = *expected_collections_iter; HidCollectionInfo actual_collection = *actual_collections_iter; ASSERT_EQ(expected_collection.usage.usage_page, actual_collection.usage.usage_page); ASSERT_EQ(expected_collection.usage.usage, actual_collection.usage.usage); ASSERT_THAT(actual_collection.report_ids, ContainerEq(expected_collection.report_ids)); expected_collections_iter++; actual_collections_iter++; } ASSERT_EQ(expected_max_input_report_size, actual_max_input_report_size); ASSERT_EQ(expected_max_output_report_size, actual_max_output_report_size); ASSERT_EQ(expected_max_feature_report_size, actual_max_feature_report_size); } private: HidReportDescriptor* descriptor_; }; TEST_F(HidReportDescriptorTest, ValidateDetails_Digitizer) { HidCollectionInfo digitizer; digitizer.usage = HidUsageAndPage(0x01, HidUsageAndPage::kPageDigitizer); digitizer.report_ids.insert(1); digitizer.report_ids.insert(2); digitizer.report_ids.insert(3); HidCollectionInfo expected[] = {digitizer}; ValidateDetails(std::vector( expected, expected + ARRAYSIZE_UNSAFE(expected)), 7, 0, 0, kDigitizer, sizeof(kDigitizer)); } TEST_F(HidReportDescriptorTest, ValidateDetails_Keyboard) { HidCollectionInfo keyboard; keyboard.usage = HidUsageAndPage(0x06, HidUsageAndPage::kPageGenericDesktop); HidCollectionInfo expected[] = {keyboard}; ValidateDetails(std::vector( expected, expected + ARRAYSIZE_UNSAFE(expected)), 8, 1, 0, kKeyboard, sizeof(kKeyboard)); } TEST_F(HidReportDescriptorTest, ValidateDetails_Monitor) { HidCollectionInfo monitor; monitor.usage = HidUsageAndPage(0x01, HidUsageAndPage::kPageMonitor0); monitor.report_ids.insert(1); monitor.report_ids.insert(2); monitor.report_ids.insert(3); monitor.report_ids.insert(4); monitor.report_ids.insert(5); HidCollectionInfo expected[] = {monitor}; ValidateDetails(std::vector( expected, expected + ARRAYSIZE_UNSAFE(expected)), 0, 0, 244, kMonitor, sizeof(kMonitor)); } TEST_F(HidReportDescriptorTest, ValidateDetails_Mouse) { HidCollectionInfo mouse; mouse.usage = HidUsageAndPage(0x02, HidUsageAndPage::kPageGenericDesktop); HidCollectionInfo expected[] = {mouse}; ValidateDetails(std::vector( expected, expected + ARRAYSIZE_UNSAFE(expected)), 3, 0, 0, kMouse, sizeof(kMouse)); } TEST_F(HidReportDescriptorTest, ValidateDetails_LogitechUnifyingReceiver) { HidCollectionInfo hidpp_short; hidpp_short.usage = HidUsageAndPage(0x01, HidUsageAndPage::kPageVendor); hidpp_short.report_ids.insert(0x10); HidCollectionInfo hidpp_long; hidpp_long.usage = HidUsageAndPage(0x02, HidUsageAndPage::kPageVendor); hidpp_long.report_ids.insert(0x11); HidCollectionInfo hidpp_dj; hidpp_dj.usage = HidUsageAndPage(0x04, HidUsageAndPage::kPageVendor); hidpp_dj.report_ids.insert(0x20); hidpp_dj.report_ids.insert(0x21); HidCollectionInfo expected[] = {hidpp_short, hidpp_long, hidpp_dj}; ValidateDetails(std::vector( expected, expected + ARRAYSIZE_UNSAFE(expected)), 32, 32, 0, kLogitechUnifyingReceiver, sizeof(kLogitechUnifyingReceiver)); } } // namespace device