nanoFramework.Aws.IoTCore.Devices 1.1.74

The ID prefix of this package has been reserved for one of the owners of this package by Prefix Reserved
.NET Framework
dotnet add package nanoFramework.Aws.IoTCore.Devices --version 1.1.74
NuGet\Install-Package nanoFramework.Aws.IoTCore.Devices -Version 1.1.74
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Aws.IoTCore.Devices" Version="1.1.74" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Aws.IoTCore.Devices --version 1.1.74
#r "nuget: nanoFramework.Aws.IoTCore.Devices, 1.1.74"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.Aws.IoTCore.Devices as a Cake Addin
#addin nuget:?package=nanoFramework.Aws.IoTCore.Devices&version=1.1.74

// Install nanoFramework.Aws.IoTCore.Devices as a Cake Tool
#tool nuget:?package=nanoFramework.Aws.IoTCore.Devices&version=1.1.74

Quality Gate Status Reliability Rating NuGet #yourfirstpr Discord

nanoFramework logo

Welcome to the .NET nanoFramework Aws.IoTCore.Devices repository

Build status

Component Build Status NuGet Package
nanoFramework.Aws.IoTCore.Devices Build Status NuGet

See it in action

TODO! Please help us to add some samples!


Important: Due to TLS, You must be connected to the internet (which means already having an IP address from your router) and a valid (minimum of today) date and time. Please check the examples that use networking (especially those that include TLS/NTP) to help you ensure it will work.

This AWS IoT SDK is using MQTT. So you need to ensure you have an outbound firewall port open to the TCP port 8883. If you are in an enterprise network, this may be blocked.

If it is, in future, we plan to add WebSocket support.

The the name of the classes and the methods try to get close to the .NET nanoFramework C# Azure IoT SDK. This should allow an easier portability of the code between both cloud provider environments.


You have 2 options to provide the right Azure IoT TLS certificate:

  • Pass it in the constructor
  • Store it into the device

The X.509Certificates contain, for your convenience, the default root certificate used to connect to AWS IoT.

Thru the constructor

You will have to embed the certificate into your code, or add it as a resource:

const string AwsRootCA = @"-----BEGIN CERTIFICATE-----
MqttConnectionClient awsIoT = new MqttConnectionClient(IotBrokerAddress, ThingId, clientCert, MqttConnectionClient.QoSLevel.AtLeastOnce, awsRootCACert: new X509Certificate(AzureRootCA));

You can place your binary certificate in the resources as well and just get the certificate from it:

X509Certificate awsRootCACert = new X509Certificate(Resources.GetBytes(Resources.BinaryResources.AwsCAcertificate));
MqttConnectionClient awsIoT = new MqttConnectionClient(IotBrokerAddress, ThingId, clientCert, MqttConnectionClient.QoSLevel.AtLeastOnce, awsRootCACert);

Note: when the certificate expires, you will have to fully reflash the device with the new certificates and keys, or build a mechanism into your code to include primary and secondary versions of them.

Storing the certificate into the device

You can store the certificate in the device flash and not in the code, so if you have to change the certificate, you'll just have to clean the current store and upload the new one. Edit the network properties:

edit device network

Navigate to the General tab:

device network certificate

Browse to choose your certificate, it can be in a binary (crt, der) or string form (pem, txt) and select ok. The certificate to connect will be selected automatically during the connection.

Creating an MqttConnectionClient

You can connect to AWS IoT Core using a certificate containing the private certificate and key, or IAM (not currently supported). The following example shows how to create it:

const string ThingId = "nanoDeviceShadow";
const string IotBrokerAddress = "<account>-ats.iot.<region>";
//make sure to add a correct pfx certificate
X509Certificate2 clientCert = new X509Certificate2(ClientRsaSha256Crt, ClientRsaKey, "");
MqttConnectionClient awseIoT = new MqttConnectionClient(IotBrokerAddress, ThingId, clientCert, MqttConnectionClient.QoSLevel.AtLeastOnce, awsRootCACert);

Note: please see the previous section to understand how to better pass the certificate for your usage. The example shows the certificate uploaded into the device and not in the code.

Getting and updating Device Shadow

You can request your Shadow simply by calling the GetShadow function.

var shadow = awsIoT.GetShadow(new CancellationTokenSource(20000).Token);
if (shadow == null)
    Debug.WriteLine($"Can't get the shadow");

Debug.WriteLine($"Shadow ClientToken: {shadow.DeviceId}, #desired: {shadow.status.desired}, #reported: {shadow.status.reported}");

Note: it's important to use a CancellationToken that be cancelled after a certain amount of time. Otherwise, this will be blocking the thread up to the point the shadow will be received.

Shadows have status properties, reported and desired. They are a hashtable and you can get or try to get any element.

You can report your Shadow as simple as this:

TODO: does not work yet!!!

ShadowCollection reported = new ShadowCollection();
reported.Add("firmware", "myNano");
reported.Add("sdk", 0.2);

You also have the option to wait for the shadow update confirmation, in this case use a CancellationToken that can be cancelled. Otherwise the check will be ignored.

Note: the function will return false if the shadow reception confirmation is not checked or if it did not arrive on time.

You can also register for any shadow update:

awsIoT.ShadowUpated += ShadowUpdatedEvent;

void ShadowUpdatedEvent(object sender, ShadowUpdateEventArgs e)
    Debug.WriteLine($"Shadow update received:  {e.Shadow}");

Sending message

You have to use the SendMessage function to send any kind of message or telemetry to AWS IoT. As with the other function, you have the possibility to ensure delivery using a CancellationToken than can be cancelled. If one that can't be cancelled is used, the delivery insurance will be ignored and the function will return false.

var isReceived = awsIoT.SendMessage($"{{\"Temperature\":42,\"Pressure\":1024}}", new CancellationTokenSource(5000).Token);
Debug.WriteLine($"Message received by IoT Core: {isReceived}");

Note: The message will be send with the same quality of service you created the connection with. You won't get any answer for the quality 0. In this case, you can simplify it to:


Cloud to device messages

You can register an event to receive Cloud to device messages:

TODO: check works!!!

awsIoT.CloudToDeviceMessage += CloudToDeviceMessageEvent;

// The following example shows how to display all keys in debug
void CloudToDeviceMessageEvent(object sender, CloudToDeviceMessageEventArgs e)
    Debug.WriteLine($"Message arrived: {e.Message}");
    foreach (string key in e.Properties.Keys)
        Debug.Write($"  Key: {key} = ");
        if (e.Properties[key] == null)

    // e.Message contains the message itself
    if(e.Message == "stop")
        ShoudIStop = true;

Note: the sender is a MqttConnectionClient class, you can then send a message back with a confirmation or any logic you've put in place.

Status update event

A status update event is available:

awsIoT.StatusUpdated += StatusUpdatedEvent;

void StatusUpdatedEvent(object sender, StatusUpdatedEventArgs e)
    Debug.WriteLine($"Status changed: {e.Status.State}, {e.Status.State}");
    // You may want to reconnect or use a similar retry mechanism
    ////if (e.Status.State == Status.Disconnected)
    ////    mqtt.Open();

Note that they are status change based, so once the connect or disconnect event arrives, they'll be replaced by other events as soon as something else happened like receiving a shadow.

Future work items for discussion

  • Better documentation about ensuring "persistent" connections (or not) with documentation (including cloud policy doc for support)
  • Add some integration tests, including (scripts to auto provision cloud broker (and/or)) manual setup documents to ensure ease of use.-
  • Partial Greengrass support?!
  • Websocket support?!
  • fleet provisioning support?!

Feedback and documentation

For documentation, providing feedback, issues and finding out how to contribute please refer to the Home repo.

Join our Discord community here.


The list of contributors to this project can be found at CONTRIBUTORS.


The .NET nanoFramework Class Libraries are licensed under the MIT license.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behaviour in our community. For more information see the .NET Foundation Code of Conduct.

.NET Foundation

This project is supported by the .NET Foundation.

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.74 41 5/29/2023
1.1.65 202 1/14/2023
1.1.62 212 12/28/2022
1.1.60 211 12/27/2022
1.1.53 338 11/24/2022
1.1.48 242 11/15/2022
1.1.46 266 11/4/2022
1.1.43 278 10/28/2022
1.1.41 299 10/28/2022
1.1.39 296 10/27/2022
1.1.37 282 10/26/2022
1.1.34 299 10/16/2022
1.1.29 284 10/4/2022
1.1.27 296 9/30/2022
1.1.25 338 9/23/2022
1.1.23 320 9/20/2022
1.1.21 330 9/16/2022
1.1.18 332 9/9/2022
1.1.14 352 8/5/2022
1.1.12 352 7/26/2022
1.1.10 346 7/19/2022
1.1.8 353 6/14/2022
1.1.6 362 6/14/2022
1.1.4 362 6/10/2022
1.1.1 349 5/30/2022
1.0.0 365 3/29/2022
1.0.0-preview.132 86 3/29/2022
1.0.0-preview.130 85 3/28/2022
1.0.0-preview.128 85 3/28/2022
1.0.0-preview.126 87 3/28/2022
1.0.0-preview.124 84 3/28/2022
1.0.0-preview.120 90 3/17/2022
1.0.0-preview.117 90 3/17/2022
1.0.0-preview.115 89 3/15/2022
1.0.0-preview.113 87 3/15/2022
1.0.0-preview.111 90 3/15/2022
1.0.0-preview.109 87 3/15/2022
1.0.0-preview.108 82 3/15/2022
1.0.0-preview.107 80 3/11/2022
1.0.0-preview.106 91 3/4/2022
1.0.0-preview.105 80 3/1/2022
1.0.0-preview.102 90 2/17/2022
1.0.0-preview.101 83 2/15/2022
1.0.0-preview.100 91 2/8/2022
1.0.0-preview.99 92 2/8/2022
1.0.0-preview.98 105 2/4/2022
1.0.0-preview.97 101 2/4/2022
1.0.0-preview.96 99 2/4/2022
1.0.0-preview.95 106 2/1/2022
1.0.0-preview.94 103 1/28/2022
1.0.0-preview.93 99 1/28/2022
1.0.0-preview.92 97 1/28/2022
1.0.0-preview.91 100 1/28/2022
1.0.0-preview.90 96 1/28/2022
1.0.0-preview.89 102 1/28/2022
1.0.0-preview.88 99 1/25/2022
1.0.0-preview.87 99 1/21/2022
1.0.0-preview.86 101 1/21/2022
1.0.0-preview.85 96 1/21/2022
1.0.0-preview.84 103 1/21/2022
1.0.0-preview.83 105 1/21/2022
1.0.0-preview.82 97 1/21/2022
1.0.0-preview.80 107 1/14/2022
1.0.0-preview.79 105 1/14/2022
1.0.0-preview.76 105 1/6/2022
1.0.0-preview.74 103 1/5/2022
1.0.0-preview.72 105 1/5/2022
1.0.0-preview.71 107 1/4/2022
1.0.0-preview.70 106 1/4/2022
1.0.0-preview.69 108 12/31/2021
1.0.0-preview.68 101 12/31/2021
1.0.0-preview.67 97 12/31/2021
1.0.0-preview.66 109 12/29/2021
1.0.0-preview.65 105 12/29/2021
1.0.0-preview.63 111 12/17/2021
1.0.0-preview.61 122 12/4/2021
1.0.0-preview.59 119 12/4/2021
1.0.0-preview.57 122 12/3/2021
1.0.0-preview.55 120 12/3/2021
1.0.0-preview.53 113 12/3/2021
1.0.0-preview.51 113 12/3/2021
1.0.0-preview.49 114 12/2/2021
1.0.0-preview.47 111 12/2/2021
1.0.0-preview.45 109 12/2/2021
1.0.0-preview.43 113 12/2/2021
1.0.0-preview.41 115 12/1/2021
1.0.0-preview.38 114 11/23/2021
1.0.0-preview.36 112 11/14/2021
1.0.0-preview.34 218 11/13/2021
1.0.0-preview.32 155 11/12/2021
1.0.0-preview.30 134 11/12/2021
1.0.0-preview.28 121 11/10/2021
1.0.0-preview.25 152 10/22/2021
1.0.0-preview.23 110 10/19/2021
1.0.0-preview.20 156 10/18/2021
1.0.0-preview.18 160 10/15/2021
1.0.0-preview.16 165 10/15/2021
1.0.0-preview.14 172 10/15/2021
1.0.0-preview.12 181 10/15/2021
1.0.0-preview.10 179 10/15/2021
1.0.0-preview.8 185 10/15/2021
1.0.0-preview.6 186 10/15/2021
1.0.0-preview.5 197 10/15/2021