Struct nitrokey3::Device

source · [−]

pub struct Device<H: HidDevice> { /* private fields */ }

Expand description

A connected Nitrokey 3 device.

Implementations

source

impl<H: HidDevice> Device<H>

source

pub fn new(device: Device<H>) -> Self

Creates a new Nitrokey 3 instance from the given ctaphid::Device, assuming that it is a Nitrokey 3 device.

Use list to get a list of all available Nitrokey 3 devices and DeviceInfo::connect to connect to one of them.

source

pub fn firmware_version(&self) -> Result<Version, Error>

Queries the firmware version of the device.

source

pub fn uuid(&self) -> Result<Uuid, Error>

Queries the UUID of the device.

This command requires the firmware version v1.0.1.

source

pub fn rng(&self) -> Result<Vec<u8>, Error>

Generates random data on the device.

source

pub fn reboot(&self, mode: BootMode) -> Result<(), Error>

Reboots the device into the given boot mode.

source

pub fn wink(&self) -> Result<(), Error>

Executes the wink command.

For devices with firmware v1.0.1 or newer, this causes the LED to blink. For older firmware versions, this does nothing.

Trait Implementations

source

impl<H: Debug + HidDevice> Debug for Device<H>

source

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

Formats the value using the given formatter. Read more

Auto Trait Implementations

impl<H> !RefUnwindSafe for Device<H>

impl<H> Send for Device<H> where
H: Send,
<H as Device>::Info: Send,

impl<H> !Sync for Device<H>

impl<H> Unpin for Device<H> where
H: Unpin,
<H as Device>::Info: Unpin,

impl<H> UnwindSafe for Device<H> where
H: UnwindSafe,
<H as Device>::Info: UnwindSafe,

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct nitrokey3::Device

Implementations

impl<H: HidDevice> Device<H>

pub fn new(device: Device<H>) -> Self

pub fn firmware_version(&self) -> Result<Version, Error>

pub fn uuid(&self) -> Result<Uuid, Error>

pub fn rng(&self) -> Result<Vec<u8>, Error>

pub fn reboot(&self, mode: BootMode) -> Result<(), Error>

pub fn wink(&self) -> Result<(), Error>

Trait Implementations

impl<H: Debug + HidDevice> Debug for Device<H>

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

Auto Trait Implementations

impl<H> !RefUnwindSafe for Device<H>

impl<H> Send for Device<H> where
H: Send,
<H as Device>::Info: Send,

impl<H> !Sync for Device<H>

impl<H> Unpin for Device<H> where
H: Unpin,
<H as Device>::Info: Unpin,

impl<H> UnwindSafe for Device<H> where
H: UnwindSafe,
<H as Device>::Info: UnwindSafe,

Blanket Implementations

impl<T> Any for T where
T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where
T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where
T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where
U: From<T>,

fn into(self) -> U

impl<T, U> TryFrom<U> for T where
U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Struct nitrokey3::Device

Implementations

impl<H: HidDevice> Device<H>

pub fn new(device: Device<H>) -> Self

pub fn firmware_version(&self) -> Result<Version, Error>

pub fn uuid(&self) -> Result<Uuid, Error>

pub fn rng(&self) -> Result<Vec<u8>, Error>

pub fn reboot(&self, mode: BootMode) -> Result<(), Error>

pub fn wink(&self) -> Result<(), Error>

Trait Implementations

impl<H: Debug + HidDevice> Debug for Device<H>

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

Auto Trait Implementations

impl<H> !RefUnwindSafe for Device<H>

impl<H> Send for Device<H> where H: Send, <H as Device>::Info: Send,

impl<H> !Sync for Device<H>

impl<H> Unpin for Device<H> where H: Unpin, <H as Device>::Info: Unpin,

impl<H> UnwindSafe for Device<H> where H: UnwindSafe, <H as Device>::Info: UnwindSafe,

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<H> Send for Device<H> where
H: Send,
<H as Device>::Info: Send,

impl<H> Unpin for Device<H> where
H: Unpin,
<H as Device>::Info: Unpin,

impl<H> UnwindSafe for Device<H> where
H: UnwindSafe,
<H as Device>::Info: UnwindSafe,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,