scottrfrancis / aws-iot-fleetwise-edge

AWS IoT FleetWise Edge Agent

Home Page:https://aws.amazon.com/iot-fleetwise/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AWS IoT FleetWise Edge

ℹ️ To quickly get started, jump to the Developer Guide or the Raspberry Pi Tutorial

AWS IoT FleetWise is a service that makes it easy for Automotive OEMs to collect, store, organize, and monitor data from vehicles at scale. AWS IoT FleetWise Edge provides C++ libraries that allow you to run the application on your vehicle. You can then use AWS IoT FleetWise's pre-configured analytic capabilities to process the collected data, gain insights about the vehicle's health and use the service’s visual interface to help diagnose and troubleshoot potential issues with your vehicles. Furthermore, AWS IoT FleetWise's capability to collect ECU data and store them on cloud databases enables you to utilize different AWS services (Analytics Services, ML, etc.) to develop novel use-cases that augment your existing vehicle functionality.

In particular, AWS IoT FleetWise can leverage fleet data (Big Data) and enable you to develop use cases that create business value, for example: improve electric vehicle range estimation, optimized battery life charging, optimized vehicle routing, etc. AWS IoT FleetWise can be extended to utilize cloud computing capabilities for use-cases such as pet/child detection, Driver Monitoring System applications, Predictive Diagnostics, electric vehicle's battery cells outlier detection, etc.

You can use the included sample C++ application to learn more about AWS IoT FleetWise Edge interfaces and to test interactions before integration.

AWS IoT FleetWise Architecture

AWS IoT FleetWise is an AWS service that enables automakers to collect, store, organize, and monitor data from vehicles. Automakers need the ability to connect remotely to their fleet of vehicles and collect vehicle ECU/sensor data. AWS IoT FleetWise can be used by OEM engineers and data scientists to build vehicle models that can be used to build custom data collection schemes. These data collection schemes enables the OEM to optimize the data collection process by defining what signals to collect, how often to collect them, and most importantly the trigger conditions ("events") that enable the collection process.

Customers can define the data collection schemes to trigger based on a schedule or on specific conditions such as, but not limited to: 1. Ambient temperature dropping to below 0 degree or 2. Vehicle crosses state lines or 3. Active diagnostic trouble codes. These conditions are sent to the vehicle through a set of documents called data collection schemes. In summary, AWS IoT FleetWise Edge collects the data of interest according to the data collection schemes and decoding rules as specified by the OEM on the AWS IoT FleetWise Console.

The following diagram illustrates a high-level architecture of the system.

AWS IoT FleetWise Edge receives two documents:

  1. Decoder Manifest - this document describes how signals are collected from the vehicle, and will include details such as, but not limited to: Bus ID, network name, decoding information, etc.

  2. Data Collection Schemes - this document describes what signals to collect. It also describes the condition logic that defines the enablement of the trigger logic that allows these signals to be collected, for example, when Vehicle Speed > 100 km/Hr and Driver Seatbelt is Off and Ambient Temperature < 0 degree C.

AWS IoT FleetWise Edge Deployment & Supported Platforms

AWS IoT FleetWise Edge functional flexibility and its use of dynamic memory allocation means that it cannot reside in the real-time safe vehicle ECUs. AWS IoT FleetWise Edge must also be connected to the internet and preferably has access to a “good” portion of vehicle ECU data. OEMs have the flexibility to decide where they can deploy AWS IoT FleetWise Edge binary. Possible options include (if present):

  1. Vehicle Gateway such as the NXP S32G
  2. Vehicle Head-Unit
  3. Vehicle’s High Performance Computer
  4. Telecommunication Control Unit

AWS IoT FleetWise Edge was built and tested on 64-bit architectures. It has been tested on both ARM and X86 multicore based machines, with a Linux Kernel version of 5.4 and above. The kernel module for ISO-TP (can-isotp ) would need to be installed in addition for Kernels below 5.10.

AWS IoT FleetWise Edge was also tested on an EC2 Instance with the following details:

  • Platform: Ubuntu
  • Platform Details: Linux/UNIX
  • Server: AmazonEC2
  • InstanceType: c4.8xlarge
  • AvailabilityZone: us-east-1
  • Architecture: x86_64
  • CpuOptions: {'CoreCount': 18, 'ThreadsPerCore': 2}
  • AMI name: ubuntu-bionic-18.04-amd64-server-20210224

AWS IoT FleetWise Client-Server Communication

AWS IoT FleetWise Edge relies on AWS SDK for C++ to send and receive data from and to AWS IoT FleetWise Server. All data sent to AWS IoT is sent over an encrypted TLS connection using MQTT, HTTPS, and WebSocket protocols, making it secure by default while in transit. AWS IoT FleetWise uses MQTT quality of service zero (QoS = 0).

Security

See SECURITY for more information

License Summary and Build Dependencies

AWS IoT FleetWise Edge depends on the following open source libraries. Refer to the corresponding links for more information.

Optional: The following dependencies are only required when the experimental option FWE_FEATURE_CAMERA is enabled.

See LICENSE for more information.

Getting Help

Contact AWS Support if you have any technical questions about AWS IoT FleetWise Edge.

Resources

The following documents provide more information about AWS IoT FleetWise Edge.

  1. Change Log provides a summary of feature enhancements, updates, and resolved and known issues.
  2. AWS IoT FleetWise Edge Offboarding provides a summary of the steps needed on the Client side to off board from the service.
  3. AWS IoT FleetWise Edge Agent Developer Guide provides step-by-step instructions for building and running AWS IoT FleetWise Edge.

The following documents provide more information about AWS IoT FleetWise Cloud.

  1. AWS IoT FleetWise API Reference describes all the API operations for FleetWise

About

AWS IoT FleetWise Edge Agent

https://aws.amazon.com/iot-fleetwise/


Languages

Language:C++ 91.2%Language:Shell 4.5%Language:CMake 2.9%Language:Python 1.3%Language:BitBake 0.1%Language:C 0.1%