Struct DeviceString 

pub struct DeviceString(/* private fields */);

String limited to 30 UTF-16 code units.

The strings stored in the MCP2221 flash memory (used during USB enumeration) are limited to at most 60 bytes of UTF-16-encoded text.

Create a DeviceString by calling str::parse on a string slice, or DeviceString::try_from with an owned String.

let manufacturer: DeviceString = "Acme Widgets Company (UK) Ltd".parse()?;

let product = String::from("Internet of Widgets Hub v3.0");
let product: DeviceString = product.try_into()?;

Note that some characters require two UTF-16 code units to express (4 bytes).

let serial = "4 bytes each: 🫐🫑🫒🫓🫔🫕🫖🫗🫘🫙";
let result: Result<DeviceString, _> = serial.parse();
assert!(result.is_err(), "More than 60 bytes when UTF-16 encoded.");

Datasheet

See table 3-7 and table 3-14 for details of how the device strings are read from and written to the MCP2221, including the length limitation. (Those tables are for the manufacturer string, but the following tables are identical except for the subcommand code.)

Trait Implementations

impl Clone for DeviceString

fn clone(&self) -> DeviceString

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceString

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for DeviceString

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for DeviceString

type Err = &'static str

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl TryFrom<String> for DeviceString

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(value: String) -> Result<Self, Self::Error>

Performs the conversion.