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

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

   * - Document Version
     - Date
     - Description of change
   * - v1.0
     - 2/28/2018
     - Initial version of AWS IoT Greengrass V1 guide targeting the phyCORE-i.MX7 SOM running BSP-Yocto-FSL-iMX7-PD18.2.1 based Linux.
   * - v2.0
     - 1/3/2024
     - Updated this guide to AWS IoT Greengrass V2 for the phyCORE-i.MX7 SOM running BSP-Yocto-NXP-i.MX7-PD23.1.0 based Linux.

The phyCORE-i.MX7 System on Module supports the NXP i.MX7 single and dual-core application processors. Within a compact form factor, the SOM supports on-board DDR3, NAND, NOR, eMMC, Gigabit Ethernet PHY, RTC, power management, and provides a high number of interfaces for connecting peripherals, such as PCIe, WiFi, Bluetooth, GPS, displays, camera, and sensors. Ideal for patient monitoring, industrial HMI, portable test and measurement applications. AWS IoT Greengrass is an excellent solution for your phyCORE-i.MX7 SOM to connect your edge devices to the cloud.

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

.. note::
    BSP-Yocto-NXP-i.MX7-PD23.1.0 doesn't have AWS IoT Greengrass V2 support integrated by default but this may 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-NXP-i.MX7-PD23.1.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-i.MX7 development kit <https://www.phytec.com/product/phycore-imx7/>`_. This includes:

  * phyCORE-i.MX7 System on Module, PL1458 (PCM-061)
  * phyCORE-i.MX7 (Zeta) Carrier Board, PL1459 (PBA-C-09)
  * Micro-USB cable
  * Ethernet cable
  * Two 2x5 .1" header to DB9 cables
  * Pre-flashed Bootable SD Card (BSP-Yocto-NXP-i.MX7-PD23.1.0)
  * 12V/2A USB-C Power Supply
  * 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