{"id":853,"date":"2026-03-03T00:07:13","date_gmt":"2026-03-02T22:07:13","guid":{"rendered":"http:\/\/docklight.de\/dl_faq040\/"},"modified":"2026-03-03T00:07:14","modified_gmt":"2026-03-02T22:07:14","slug":"dl_faq040","status":"publish","type":"post","link":"https:\/\/docklight.de\/dl_faq040\/","title":{"rendered":"How can I test and debug my USB HID or Bluetooth HID device?"},"content":{"rendered":"

Applies to: Docklight Scripting, Article ID: dl_faq040<\/em><\/p>\n

You can use Docklight Scripting to access HID “Custom Class” devices and other HID input devices like game controllers that are not exclusively reserved by Windows. Docklight Scripting allows you to send HID Output Reports or receive HID Input Reports.<\/p>\n

In Docklight you can choose between a HID report-based approach that shows you the individual outgoing \/ incoming report frames. Or an application-layer approach (“protocol mode”, “P”) where Docklight only shows the actual payload data, e.g. a text-based protocol you implemented. In “protocol mode”, HID report details like Report ID or trailing zero bytes are not shown in the TX\/RX communication data. <\/p>\n

NOTES:
\n* You cannot access Mouse\/Keyboard devices that are a standard Windows input device. Windows immediately opens these for exclusive access and does not allow a second client application to control them.<\/p>\n

* Docklight opens HID devices using “Access Mode = Shared”. You can tap into other application connections and use Docklight to view the device responses, but you will not see the reports the other Windows application (besides Docklight Scripting) sends to the device.<\/p>\n

* The current standard release supports Output Reports and Input Reports. Send\/Get Feature Reports will be reported in the next (free) update, and a preview of the functionality is already available – please see the Docklight Preview download link and the “HID Feature Reports” link below. <\/p>\n

* A quick way to obtain a list of all HID devices available on your PC are the hidtest.exe and testgui.exe tools. These are part of the popular HIDAPI project, which Docklight Scripting also uses. We have pre-compiled and tested these tools for you and provide a download package with code-signed executables, see the hidapi_test.zip link below. (Another useful application for finding your HID device is Uwe Sieber’s UsbTreeView \/ USB Device Tree Viewer at https:\/\/www.uwe-sieber.de\/usbtreeview_e.html ).<\/p>\n

Docklight Troubleshooting – HID Feature Reports<\/a><\/p>\n

Precompiled HIDAPI testgui.exe and hidtest.exe to enumerate \/ list available HID devices and determine the suitable Docklight channel settings<\/a><\/p>\n

Download Docklight Scripting V2.5 Preview Version<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Applies to: Docklight Scripting, Article ID: dl_faq040 You can use Docklight Scripting to access HID “Custom Class” devices and other HID input devices like game controllers that are not exclusively reserved by Windows. Docklight Scripting allows you to send HID Output Reports or receive HID Input Reports. In Docklight you can choose between a HID report-based approach that shows you […]<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7,6],"tags":[24],"class_list":["post-853","post","type-post","status-publish","format-standard","hentry","category-faq","category-support","tag-dl_faq040"],"yoast_head":"\nUSB HID terminal - Docklight example for device testing and debugging<\/title>\n<meta name=\"description\" content=\"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID "Custom Class" devices, and test protocol through HID report data\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docklight.de\/dl_faq040\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"USB HID terminal - Docklight example for device testing and debugging\" \/>\n<meta property=\"og:description\" content=\"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID "Custom Class" devices, and test protocol through HID report data\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docklight.de\/dl_faq040\/\" \/>\n<meta property=\"og:site_name\" content=\"Docklight\" \/>\n<meta property=\"article:published_time\" content=\"2026-03-02T22:07:13+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-02T22:07:14+00:00\" \/>\n<meta name=\"author\" content=\"Flachmann & Heggelbacher\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Flachmann & Heggelbacher\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/\"},\"author\":{\"name\":\"Flachmann & Heggelbacher\",\"@id\":\"https:\\\/\\\/docklight.de\\\/#\\\/schema\\\/person\\\/d6855d60ab4ee87f6482ab881c7151a3\"},\"headline\":\"How can I test and debug my USB HID or Bluetooth HID device?\",\"datePublished\":\"2026-03-02T22:07:13+00:00\",\"dateModified\":\"2026-03-02T22:07:14+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/\"},\"wordCount\":360,\"publisher\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/#organization\"},\"keywords\":[\"dl_faq040\"],\"articleSection\":[\"FAQ\",\"Support\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/\",\"url\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/\",\"name\":\"USB HID terminal - Docklight example for device testing and debugging\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/#website\"},\"datePublished\":\"2026-03-02T22:07:13+00:00\",\"dateModified\":\"2026-03-02T22:07:14+00:00\",\"description\":\"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID \\\"Custom Class\\\" devices, and test protocol through HID report data\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/docklight.de\\\/dl_faq040\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/workersplaytime.www.docklight.ch\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\\\/\\\/docklight.de\\\/category\\\/support\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"FAQ\",\"item\":\"https:\\\/\\\/docklight.de\\\/category\\\/support\\\/faq\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"How can I test and debug my USB HID or Bluetooth HID device?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/docklight.de\\\/#website\",\"url\":\"https:\\\/\\\/docklight.de\\\/\",\"name\":\"Docklight\",\"description\":\"Test and analyze serial communications (RS232, RS485, TCP, HID)\",\"publisher\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/docklight.de\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/docklight.de\\\/#organization\",\"name\":\"Flachmann und Heggelbacher GbR\",\"url\":\"https:\\\/\\\/docklight.de\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/docklight.de\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/docklight.de\\\/wp-content\\\/uploads\\\/2015\\\/07\\\/Flachmann-und-Heggelbacher_960x768.png\",\"contentUrl\":\"https:\\\/\\\/docklight.de\\\/wp-content\\\/uploads\\\/2015\\\/07\\\/Flachmann-und-Heggelbacher_960x768.png\",\"width\":960,\"height\":768,\"caption\":\"Flachmann und Heggelbacher GbR\"},\"image\":{\"@id\":\"https:\\\/\\\/docklight.de\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/docklight.de\\\/#\\\/schema\\\/person\\\/d6855d60ab4ee87f6482ab881c7151a3\",\"name\":\"Flachmann & Heggelbacher\",\"url\":\"https:\\\/\\\/docklight.de\\\/author\\\/fuhboss\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"USB HID terminal - Docklight example for device testing and debugging","description":"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID \"Custom Class\" devices, and test protocol through HID report data","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docklight.de\/dl_faq040\/","og_locale":"en_US","og_type":"article","og_title":"USB HID terminal - Docklight example for device testing and debugging","og_description":"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID \"Custom Class\" devices, and test protocol through HID report data","og_url":"https:\/\/docklight.de\/dl_faq040\/","og_site_name":"Docklight","article_published_time":"2026-03-02T22:07:13+00:00","article_modified_time":"2026-03-02T22:07:14+00:00","author":"Flachmann & Heggelbacher","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Flachmann & Heggelbacher","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/docklight.de\/dl_faq040\/#article","isPartOf":{"@id":"https:\/\/docklight.de\/dl_faq040\/"},"author":{"name":"Flachmann & Heggelbacher","@id":"https:\/\/docklight.de\/#\/schema\/person\/d6855d60ab4ee87f6482ab881c7151a3"},"headline":"How can I test and debug my USB HID or Bluetooth HID device?","datePublished":"2026-03-02T22:07:13+00:00","dateModified":"2026-03-02T22:07:14+00:00","mainEntityOfPage":{"@id":"https:\/\/docklight.de\/dl_faq040\/"},"wordCount":360,"publisher":{"@id":"https:\/\/docklight.de\/#organization"},"keywords":["dl_faq040"],"articleSection":["FAQ","Support"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/docklight.de\/dl_faq040\/","url":"https:\/\/docklight.de\/dl_faq040\/","name":"USB HID terminal - Docklight example for device testing and debugging","isPartOf":{"@id":"https:\/\/docklight.de\/#website"},"datePublished":"2026-03-02T22:07:13+00:00","dateModified":"2026-03-02T22:07:14+00:00","description":"USB HID terminal example for debuging. Use Docklight Scripting to access USB HID \"Custom Class\" devices, and test protocol through HID report data","breadcrumb":{"@id":"https:\/\/docklight.de\/dl_faq040\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docklight.de\/dl_faq040\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docklight.de\/dl_faq040\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/workersplaytime.www.docklight.ch\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/docklight.de\/category\/support\/"},{"@type":"ListItem","position":3,"name":"FAQ","item":"https:\/\/docklight.de\/category\/support\/faq\/"},{"@type":"ListItem","position":4,"name":"How can I test and debug my USB HID or Bluetooth HID device?"}]},{"@type":"WebSite","@id":"https:\/\/docklight.de\/#website","url":"https:\/\/docklight.de\/","name":"Docklight","description":"Test and analyze serial communications (RS232, RS485, TCP, HID)","publisher":{"@id":"https:\/\/docklight.de\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docklight.de\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docklight.de\/#organization","name":"Flachmann und Heggelbacher GbR","url":"https:\/\/docklight.de\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docklight.de\/#\/schema\/logo\/image\/","url":"https:\/\/docklight.de\/wp-content\/uploads\/2015\/07\/Flachmann-und-Heggelbacher_960x768.png","contentUrl":"https:\/\/docklight.de\/wp-content\/uploads\/2015\/07\/Flachmann-und-Heggelbacher_960x768.png","width":960,"height":768,"caption":"Flachmann und Heggelbacher GbR"},"image":{"@id":"https:\/\/docklight.de\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/docklight.de\/#\/schema\/person\/d6855d60ab4ee87f6482ab881c7151a3","name":"Flachmann & Heggelbacher","url":"https:\/\/docklight.de\/author\/fuhboss\/"}]}},"_links":{"self":[{"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/posts\/853","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/comments?post=853"}],"version-history":[{"count":33,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/posts\/853\/revisions"}],"predecessor-version":[{"id":2758,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/posts\/853\/revisions\/2758"}],"wp:attachment":[{"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/media?parent=853"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/categories?post=853"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docklight.de\/wp-json\/wp\/v2\/tags?post=853"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}