This post provides an example of how to build a connected Trash Can IoT solution for local councils. As the IoT use cases involve complex ecosystem of technologies right from sensor, device management all the way through to analytics layer, the serverless architecture is a great way to start small, validate and deploy at scale.

Hence, this post walks you through AWS serverless key architecture components around device provisioning, ingesting trash images and waste weight data through AWS IoT Core into AWS IoT Analytics, analyze trash image using Amazon Rekognition to enrich waste data and finally store into Amazon S3 storage for building waste heat map using Amazon QuickSight

Target architecture:

To deploy the solution,

1. you need an AWS account. If you don’t already have an AWS account, create one at https://aws.amazon.com by following the on-screen instructions. Your access to the AWS account must have IAM permissions to launch AWS CloudFormation templates that create IAM roles.
2. clone the repository
3. An S3 bucket to upload all the artifacts from the cloned repository under src/greengrass-app-component directory
4. Upload all the artifacts to AWS S3 Bucket
   1. On AWS Console, choose "S3" service
   2. Choose your bucket created as mentioned step 3
   3. Press "Create folder" button
   4. Enter "greengrass-app-component" in folder name field and press "Create folder" button
   5. Choose the "greengrass-app-component" folder and press "Upload" button
   6. Press "Add files" button on upload screen and choose all the files from greengrass-app-component
   7. Finally, press "Upload" button
   8. Please make sure that all the artifacts are under "s3:///greengrass-app-component". This is very important to ensure that path is correct for successful deployment on edge gateway

The application is deployed as an AWS CloudFormation template.

Note You are responsible for the cost of the AWS services used while running this sample deployment. There is no additional cost for using this sample. For full details, see the pricing pages for each AWS service that you use in this sample. Prices are subject to change.

1. Deploy the latest CloudFormation template by following the link below for your preferred AWS region:

Region	Launch Template
US East (N. Virginia) (us-east-1)
US West (Oregon) (us-west-2)
EU (Ireland) (eu-west-1)
EU (Frankfurt) (eu-central-1)
AP (Sydney) (ap-southeast-2)

2. If prompted, login using your AWS account credentials.
3. You should see a screen titled "Create Stack" at the "Specify template" step. The fields specifying the CloudFormation template are pre-populated. Choose the Next button at the bottom of the page.
4. On the "Specify stack details" screen you can customize the following parameters of the CloudFormation stack:

When completed, choose Next

1. Configure stack options if desired, then choose Next.

2. On the review you screen, you must check the boxes for:

   • "I acknowledge that AWS CloudFormation might create IAM resources"
   • "I acknowledge that AWS CloudFormation might create IAM resources with custom names"
   • "I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND"

   These are required to allow CloudFormation to create a Role to grant access to the resources needed by the stack and name the resources in a dynamic way.

3. Choose Create Stack

4. Wait for the CloudFormation stack to launch. Completion is indicated when the "Stack status" is "CREATE_COMPLETE".

   • You can monitor the stack creation progress in the "Events" tab.

Once the resources are set up on AWS cloud, please deploy AWS greengrass and application on your IoT gateway i.e. Raspberry PI for testing E2E solution. Please refer the steps Deploy AWS IoT Greengrass on IoT Gateway

See the Local Development guide to get a copy of the project up and running on your local machine for development and testing purposes.

To avoid incurring future charges, please clean up the resources created.

To make cloud formation stack delete successfully, please carry out below steps first. Otherwise, stack deletion might fail.

1. Please delete all the contents from the S3 bucket that was created by cloud formation script to upload sensor readings
2. On AWS IoT Core Console, choose Things option under Manage section. Then press DemoWasteBin thing link.
3. Choose "Certificates" tab. Then choose each certificate and press "detach" button.
4. Follow step 3 by choosing "Certificates" option under "Secure" section
5. Finally "Deactivate" and "Delete" all certificates one by one selecting Deactivate and Delete option from "Actions" drop down under "Secure" section.

To remove the stack:

1. Open the AWS CloudFormation Console.
2. Choose the aws-iot-smart-wastebin-solution project, press "Delete Stack" button.
3. Your stack might take some time to be deleted. You can track its progress in the "Events" tab.
4. When it is done, the status changes from "DELETE_IN_PROGRESS" to "DELETE_COMPLETE". It then disappears from the list.

See CONTRIBUTING for more information.

This library is licensed under the MIT-0 License. See the LICENSE file.