Tutorial: Using the AWS IoT Device SDK for Embedded C

1. Copy the certificate and private key you created in Getting started with AWS IoT Core tutorials into the build/bin/certificates directory.

   Note

   Device and root CA certificates are subject to expiration or revocation. If these certificates expire or are revoked, you must copy a new CA certificate or private key and device certificate onto your device.

2. You must configure the sample with your personal AWS IoT Core endpoint, private key, certificate, and root CA certificate. Navigate to the aws-iot-device-sdk-embedded-c/demos/mqtt/mqtt_demo_mutual_auth directory.

   If you have the AWS CLI installed, you can use this command to find your account's endpoint URL.

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

   If you don't have the AWS CLI installed, open your AWS IoT console. From the navigation pane, choose Manage, and then choose Things. Choose the IoT thing for your device, and then choose Interact. Your endpoint is displayed in the HTTPS section of the thing details page.

3. Open the demo_config.h file and update the values for the following:

   AWS_IOT_ENDPOINT

   Your personal endpoint.

   CLIENT_CERT_PATH

   Your certificate file path, for example certificates/device.pem.crt".

   CLIENT_PRIVATE_KEY_PATH

   Your private key file name, for example certificates/private.pem.key.

   For example:

   // Get from demo_config.h
   // =================================================
   #define AWS_IOT_ENDPOINT               "my-endpoint-ats.iot.us-east-1.amazonaws.com"
   #define AWS_MQTT_PORT                  8883
   #define CLIENT_IDENTIFIER              "testclient"
   #define ROOT_CA_CERT_PATH              "certificates/AmazonRootCA1.crt"
   #define CLIENT_CERT_PATH               "certificates/my-device-cert.pem.crt"
   #define CLIENT_PRIVATE_KEY_PATH        "certificates/my-device-private-key.pem.key"
   // ================================================= 

4. Check to see if you have CMake installed on your device by using this command.

   cmake --version

   If you see the version information for the compiler, you can continue to the next section.

   If you get an error or don't see any information, then you'll need to install the cmake package using this command.

   sudo apt-get install cmake

   Run the cmake --version command again and confirm that CMake has been installed and that you are ready to continue.

5. Check to see if you have the development tools installed on your device by using this command.

   gcc --version

   If you see the version information for the compiler, you can continue to the next section.

   If you get an error or don't see any compiler information, you'll need to install the build-essential package using this command.

   sudo apt-get install build-essential

   Run the gcc --version command again and confirm that the build tools have been installed and that you are ready to continue.

To run the AWS IoT Device SDK for Embedded C sample applications

1. Navigate to aws-iot-device-sdk-embedded-c and create a build directory.

   mkdir build && cd build

2. Enter the following CMake command to generate the Makefiles needed to build.

   cmake ..  

3. Enter the following command to build the executable app file.

   make

4. Run the mqtt_demo_mutual_auth app with this command.

   cd bin
   ./mqtt_demo_mutual_auth 

   You should see output similar to the following: