0x0005 · deviceTypeAndName

Reports the device's type (mouse, keyboard, trackball, …) and its marketing name. The name is read in chunks: getDeviceNameCount() gives the length, then getDeviceName(offset) returns successive byte ranges.

OpenLogi uses the type to pick the right diagram and the name for the device carousel label.

Spec: Logitech HID++ 2.0 — x0005 deviceTypeAndName (v2).

Function reference

The DeviceTypeAndNameFeature wrapper (0x0005) exposes:

Methods

get_whole_device_name is a convenience wrapper that calls get_device_name_count (fn 0) and then get_device_name (fn 1) in a loop until the full name is assembled.

All methods are async and return Result<…, Hidpp20Error>.

Types

DeviceType

Represents the marketing category of a HID++ 2.0 device, as returned by get_device_type.

Wire format

All three functions use a 3-byte short-report request payload. Responses from get_device_name_count and get_device_type arrive as a short report and are read via extend_payload()[0]; get_device_name returns the raw payload bytes (3 bytes from a short report, 16 bytes from a long report, depending on device and channel capability).

get_device_name_count (fn 0)

Request: [0x00, 0x00, 0x00] (no parameters)

Response (byte → field):

get_device_name (fn 1)

Request: [index, 0x00, 0x00]

Response: the raw payload bytes returned by the device. Up to 3 bytes on a short-report channel or up to 16 bytes on a long-report channel. The caller must accumulate chunks until count bytes have been collected, then strip trailing NUL bytes.

get_device_type (fn 2)

Request: [0x00, 0x00, 0x00] (no parameters)

Response (byte → field):

Usage (Rust)

use hidpp::feature::device_type_and_name::DeviceTypeAndNameFeature;

// mut device: Device, already created via Device::new(channel, index)
device.enumerate_features().await?;
if let Some(feat) = device.get_feature::<DeviceTypeAndNameFeature>() {
    // Read the device type (mouse, keyboard, trackball, …)
    let device_type = feat.get_device_type().await?;
    println!("Device type: {:?}", device_type);

    // Read the full marketing name in one convenience call
    let name = feat.get_whole_device_name().await?;
    println!("Device name: {}", name);

    // Or read it manually: get the length, then fetch chunks
    let count = feat.get_device_name_count().await?;
    let chunk = feat.get_device_name(0).await?;
    println!("Name length: {}, first chunk: {:?}", count, chunk);
}