AWS Greengrass Component SDK

The aws-greengrass-component-sdk is a small-footprint library providing APIs for making AWS IoT Greengrass IPC calls in C, Rust, and C++. It enables Greengrass components to interact with the Greengrass runtime (Greengrass nucleus or Greengrass nucleus lite) with less binary overhead. Components can use this SDK as an alternative to the aws-iot-device-sdk-cpp-v2 or other language-specific device SDKs.

Building

For building the SDK and samples for C and/or C++, see the build guide.

For Rust, the rust subdirectory provides a Rust crate.

Supported Operations

The following Greengrass v2 IPC operations are currently supported by this SDK:

• PublishToTopic
• SubscribeToTopic
• PublishToIoTCore
• SubscribeToIoTCore
• UpdateState
• RestartComponent
• GetConfiguration
• UpdateConfiguration
• SubscribeToConfigurationUpdate
• GetThingShadow
• UpdateThingShadow
• DeleteThingShadow
• ListNamedShadowsForThing

Sample Greengrass Components

For deployment instructions, see the samples deployment guide.

• C samples
• C++ samples
• Rust samples

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.