0x0007 · deviceFriendlyName

读取或写入设备的用户自定义名称，并支持将其重置为出厂默认名称。

设备的用户自定义名称：你可以给鼠标或键盘起的自定义标签，与 0x0005 deviceTypeAndName 中固定的市场名称不同。getFriendlyNameLength 报告当前、最大与默认名称长度；getFriendlyName / getDefaultFriendlyName 以 15 字节分块读取名称（或使用整名便捷封装）；setFriendlyName 写入名称，resetFriendlyName 恢复出厂默认。

OpenLogi 在设备发现时读取该自定义名称，并在它与默认值不同时显示出来。

规格： Logitech HID++ 2.0 —— x0007 deviceFriendlyName。用于： 设备识别。

Function reference

The DeviceFriendlyNameFeature wrapper (0x0007) exposes:

Methods

Function	HID++ fn	Signature	Returns
`get_friendly_name_length`	0	`()`	`DeviceFriendlyNameLength`
`get_friendly_name`	1	`(index: u8)`	`[u8; 15]`
`get_whole_friendly_name`	—	`()`	`String`
`get_default_friendly_name`	2	`(index: u8)`	`[u8; 15]`
`get_whole_default_friendly_name`	—	`()`	`String`
`set_friendly_name`	3	`(index: u8, chunk: [u8; 15])`	`u8`
`set_whole_device_name`	—	`(name: String)`	`u8`
`reset_friendly_name`	4	`()`	`u8`

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

The three rows marked — are convenience wrappers that compose multiple HID++ calls internally; they have no single function index.

Types

`DeviceFriendlyNameLength`

Represents the length data returned by get_friendly_name_length.

Field	Type	Description
`name_length`	`u8`	The current length of the friendly device name.
`name_max_length`	`u8`	The maximum length of the friendly device name.
`default_name_length`	`u8`	The length of the default friendly device name.

Wire format

Short getters carry a 3-byte request payload and return a 16-byte long payload; set_friendly_name uses a 16-byte long request. Byte offsets below are into the feature-level payload (after the HID++ header, feature index, and function/software ID byte).

`get_friendly_name_length` (fn 0)

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

Response (byte → field):

Byte	Field	Notes
0	`name_length`	Current UTF-8 byte length of the friendly name
1	`name_max_length`	Maximum writable length the device accepts
2	`default_name_length`	Byte length of the factory-default name

`get_friendly_name` (fn 1)

Request: [index, 0x00, 0x00] — index is the byte offset into the name to start reading from.

Response (byte → field):

Byte	Field	Notes
0	(echoed index)	Skipped by the wrapper
1–15	name chunk	Up to 15 UTF-8 bytes; unused trailing bytes are `0x00`

`get_default_friendly_name` (fn 2)

Request: [index, 0x00, 0x00] — same offset semantics as fn 1.

Response (byte → field):

Byte	Field	Notes
0	(echoed index)	Skipped by the wrapper
1–15	default name chunk	Up to 15 UTF-8 bytes; unused trailing bytes are `0x00`

`set_friendly_name` (fn 3)

Uses a long request (16-byte payload):

Request: [index, chunk[0], chunk[1], …, chunk[14]]

Byte	Field	Notes
0	`index`	Byte offset at which to begin writing
1–15	`chunk`	Exactly 15 bytes; pad with `0x00` for the final partial chunk

Response (byte → field):

Byte	Field	Notes
0	new total name length	Byte count of the name as stored after this write

`reset_friendly_name` (fn 4)

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

Response (byte → field):

Byte	Field	Notes
0	name length after reset	Equals `default_name_length` from fn 0

Usage (Rust)

use hidpp::{device::Device, feature::device_friendly_name::DeviceFriendlyNameFeature};

// mut device: Device, already created via Device::new(channel, index)
device.enumerate_features().await?;

if let Some(feat) = device.get_feature::<DeviceFriendlyNameFeature>() {
    // Read current name lengths
    let lengths = feat.get_friendly_name_length().await?;
    println!("name length: {}, max: {}", lengths.name_length, lengths.name_max_length);

    // Read the full current friendly name in one call
    let name = feat.get_whole_friendly_name().await?;
    println!("friendly name: {name}");

    // Read the factory-default name
    let default_name = feat.get_whole_default_friendly_name().await?;
    println!("default name: {default_name}");

    // Write a new friendly name (truncated automatically to name_max_length)
    let new_len = feat.set_whole_device_name("My MX Master".to_string()).await?;
    println!("name set, new length: {new_len}");

    // Reset back to the factory default
    let reset_len = feat.reset_friendly_name().await?;
    println!("reset, length now: {reset_len}");
}

0x0007 · deviceFriendlyName

本页目录