Documents and tools for working with CMS
Resources for working with the old, stable, binary release from April 2020 have been moved to the deprecated folder
Background
This project seeks to bridge the gap between the public documentation and resources provided with the upcoming AWS Connected Mobility Solution and what is needed to really work with the solution. If you're new to CMS, suggest reviewing the website and documents first. Then, come back here when you're ready to deploy or start developing.
The AWS Connected Mobility Solution (CMS) is an AWS Solution, that when released, customers and partners may use to build their own workloads. CMS implements a Fleet Management system for connected vehicles that publish telematics. Some of the functions of the system include:
- visualize locations of vehicles on a map in near real time
- manage and command OTA updates to vehicle software
- detect and report anomalies and DTC events
CMS is built on the Connected Device Framework which provides
- a common system for data and event publication over MQTT using AWS IoT Core
- database systems to manage the relationships between assets, owners, users, and data
- a simulation system to help demonstrate and debug the system
- apis, user access management, lambda functions, and other components needed to deliver the system
Using this helper project
If you need to deploy CMS, start with the Install Guide. That will lead you through building and deploying the TWO AWS CloudFormation stacks--CDF and CMS--as well as running a basic simulation to verify the deployment. A script is provided to help ensure the correct versions of tools are present.
Read the Customization Guide to get an understanding of the options for customization that have been considered as part of putting together this project. (NB- the Customization Guide needs updating)
Onboard your own vehicle using the Create Vehicle Guide. A Postman Collection is provided to assist with creating Simulations and issuing other API calls when creating vehicles.
To clean up the UI or otherwise explore data which is stored in Amazon Elasticsearch Service, a Notebook is provided. No instructions for configuring Jupyter, anaconda, or other means for running the notebook, but those are widely available elsewhere. A simple python script is also provided that can be easily read, modified, and used to explore and manipulate Elasticsearch.
Context Notes
The related project AWS Connected Vehicle Solution Telemetry Demo can be used in conjunction with CMS or the original AWS Connected Vehicle Solution to send telematics to AWS IoT Greengrass or AWS IoT Core. You may find it necessary to additionally provision IoT Rules and Lambda functions or other mechanisms to adapt the telemetry to CMS.