Crate azure_iot_sdk[−][src]

Azure IoT device client for writing iot device code in rust

Feature flags

SDK client uses feature flags to configure capabilities of the client sdk. By default all features are enabled.

Device to cloud messaging is always available.

c2d-messages: Enables cloud to device messaging
twin-properties: Enables device twin property updates
direct-methods: Enables listening for direct method invocations

Disabling capabilities

If not all features are required, disable the default features and add only desired.

azure_iot_sdk = { version = "0.3.0", features = [], default-features = false }

Examples

A simple client

use tokio::time;
use azure_iot_sdk::{IoTHubClient, DeviceKeyTokenSource, Message};

#[tokio::main]
async fn main() -> azure_iot_sdk::Result<()> {
    let iothub_hostname = "iothubname.azure-devices.net";
    let device_id = "MyDeviceId";
    let token_source = DeviceKeyTokenSource::new(
        iothub_hostname,
        device_id,
        "TheAccessKey",
    ).unwrap();

    let mut client =
        IoTHubClient::new(iothub_hostname, device_id.into(), token_source).await?;

    let mut interval = time::interval(time::Duration::from_secs(1));
    let mut count: u32 = 0;

    loop {
        interval.tick().await;

        let msg = Message::builder()
            .set_body(format!("Message #{}", count).as_bytes().to_vec())
            .set_message_id(format!("{}-t", count))
            .build();

        client.send_message(msg).await?;

        count += 1;
    }

    Ok(())
}

Re-exports

`pub use client::*;`
`pub use message::*;`
`pub use token::*;`

Modules

client	The IoT Hub client
message	Message types for communicating with the IoT Hub
provision	Provision support using Azure device provisioning service
token
transport	Transport types

Constants

SDK_VERSION

IoT SDK package version

Type Definitions

Result

Convenience type alias for std::result::Result<T, Box<dyn std::error::Error>>

Crate azure_iot_sdk⎘[−][src]