Hardware Information¶
Overview¶
The HW Info API provides access to hardware information such as device identifiers.
API Reference¶
-
group
hwinfo_interface Hardware Information Interface.
Functions
-
ssize_t
hwinfo_get_device_id(uint8_t *buffer, size_t length)¶ Copy the device id to a buffer.
This routine copies “length” number of bytes of the device ID to the buffer. If the device ID is smaller then length, the rest of the buffer is left unchanged. The ID depends on the hardware and is not guaranteed unique.
Drivers are responsible for ensuring that the ID data structure is a sequence of bytes. The returned ID value is not supposed to be interpreted based on vendor-specific assumptions of byte order. It should express the identifier as a raw byte sequence, doing any endian conversion necessary so that a hex representation of the bytes produces the intended serial number.
- Parameters
buffer – Buffer to write the ID to.
length – Max length of the buffer.
- Returns size
of the device ID copied.
- Returns -ENOTSUP
if there is no implementation for the particular device.
- Returns any
negative value on driver specific errors.
-
ssize_t