AWS IoT Greengrass V2 Quickstart
================================

.. list-table:: Revision History
   :widths: 50 50 100
   :header-rows: 1

   * - Document Version
     - Date
     - Description of change
   * - v1.0
     - 10/27/2022
     - Initial version of AWS IoT Greengrass guide targeting the phyCORE-AM64x SOM running BSP-Yocto-TISDK-AM64x-ALPHA2 based Linux.
   * - v1.1
     - 1/19/2023
     - Minor style, grammar, and clarity edits.
   * - v2.0
     - 4/17/2023
     - Updated the AWS IoT Greengrass guide targeting the phyCORE-AM64x SOM running BSP-Yocto-AM64x-PD23.1.0 based Linux.
   * - v3.0
     - 10/04/2023
     - Updated the AWS IoT Greengrass guide targeting the phyCORE-AM64x SOM running BSP-Yocto-Ampliphy-AM64x-PD23.2.0 based Linux.

The phyCORE®-AM64x System on Module is a robust and reliable embedded solution designed for headless industrial communication systems. The 50mm x 37mm SOM has an extensive 280-pin interconnect supporting common factory communication protocols such as CAN, EtherCAT, UART, I2C and also automation specific interfaces such as EPWM, ECAP, and EQEP. Due to the heterogeneous architecture of the TI AM64x processor, you can run the majority of your application using Linux and offload critical components to the specialized low latency real-time cores. AWS IoT Greengrass is an excellent solution for your phyCORE-AM64x SOM to connect those critical, real-time processes to the cloud.

This guide will help you get started with integrating AWS IoT Greengrass V2 onto your phyCORE-AM64x Development kit running software based on the BSP-Yocto-Ampliphy-AM64x-PD23.2.0 Linux release.

.. note::
    BSP-Yocto-Ampliphy-AM64x-PD23.2.0 doesn't have AWS IoT Greengrass V2 support integrated by default but this will be available in a future release as a pre-built image. For now, this guide will help you to manually install the necessary dependencies by modifying the base BSP-Yocto-Ampliphy-AM64x-PD23.2.0 Linux release using Yocto.

To learn more about AWS IoT Greengrass, see `How It Works <https://docs.aws.amazon.com/greengrass/v2/developerguide/how-it-works.html>`_ and `What's New <https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-v2-whats-new.html>`_.

Requirements
------------

In order to follow this guide, you will need:

* The `phyCORE-AM64x development kit <https://www.phytec.com/product/phycore-am64x/>`_. This includes:

  * phyCORE-AM64x System on Module, PL1565 (PCM-072)
  * phyBOARD-AM64x (Electra) Carrier Board, PL1566 (PBA-C-25)
  * Micro USB cable
  * Ethernet cable
  * Two 2x5 .1" header to DB9 cables
  * Pre-flashed Bootable SD Card (BSP-Yocto-Ampliphy-AM64x-PD23.2.0)
  * 12V/2A Power Supply Barrel Adapter
  * USB-MicroSD Card Reader
* An `AWS account <https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html#aws-registration>`_. More information can be found in the steps below.

The only thing not included in the development kit is the recommended Host Machine and development environment (see the steps below).

.. include:: ../substitutions.rst
.. include:: ../../common/kirkstone/3rdpartyintegrations/aws-gg.rst