<F3RP70-2L> Getting Started Guide for AWS IoT Greengrass

# Introduction
今回は横河電機のエッジコントローラe-RT3 Plus F3RP70-2LでAWS IoT Greengrass V2を使用する手順をご紹介します。
In this article, we describe how to start using AWS IoT Greengrass V2 on e-RT3 Plus F3RP70-2L.

# Table of Contents
1. [Document information](#1-document-information)
1. [Overview](#2-overview)
1. [Hardware description](#3-hardware-description)
1. [Set up your development environment](#4-set-up-your-development-environment)
1. [Set up device hardware](#5-set-up-device-hardware)
1. [About AWS IoT Greengrass](#6-about-aws-iot-greengrass)
1. [Greengrass prerequisites](#7-greengrass-prerequisites)
1. [Install AWS IoT Greengrass](#8-install-aws-iot-greengrass)
1. [Create a “Hello World” component](#9-create-a-hello-world-component)
1. [Troubleshooting](#10-troubleshooting)

# 1 Document information
## Revision history
|Date|Notes|
|---|---|
|2024/6/1|First Edition|

## Applicable operating systems for this guide
Based on Ubuntu 20.04 TLS or Debian 11 TLS
Software and OS image for F3RP70-2L can be downloaded from following URL.
https://www.yokogawa.co.jp/member-site-info/
※You need to Yokogawa Member Site registration to access member site.
※OS image is not installed “AWS IoT Greengrass core” software.
※The product overview is as follows.
 https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/rtos-cpu/rtos-osfree-cpu/

 # 2 Overview

The F3RP70-2L is a compact IoT Edge device CPU module in FA-M3V series. It is implemented only BOOT-Loader(u-boot), then you can use our special Linux OS that can downloaded from our member-site or your customized Linux OS or any special original application with ARM32 bit architecture. and also. you can use our variety of I/O module of FA-M3V series with simple BSP software.
 The F3RP70-2L is based on ARM32 bit architecture (AMD, Xilinx Zynq7000), it provides our I/O control interfaces, RTC, 2 x Ethernet interfaces, 2 x SD memory cards. it can also be stably used as an industrial IoT platform.

See our Product website, below.
 https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/rtos-cpu/rtos-osfree-cpu/

# 3 Hardware description
## 3.1	Datasheet
<img width="738" alt="F3RP70_specification.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/682603/1f38bcc3-349a-cc25-fda6-38ec65ce6bac.png">

## 3.2 Standard kit contents

The standard shipping hardware packages is indicated below.
•	F3RP70-2L: main unit.

Must be purchased separately.
•	Base module: Back plane board for connecting Power Module, I/O Modules.
•	Power module: 100-240 V AC type or 24V DC type.
•	I/O module: Analog I/O, Digital I/O and special I/O modules is available.
•	KM72-2N: RS-232-C conversion cable for serial console.
•	SD memory card: more than 8GB for OS. (SDHC, MLC or SLC recommended)
•	PC: Setting up a SD memory card.
•	Other: RS-232-C cross cable, Ethernet cable, etc. depending on your system.

Please also check our website, below.
 https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/rtos-cpu/rtos-osfree-cpu/
 https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/

## 3.3 User provided items

If necessary, the following items.
•	PC: Linux PC or Virtual environment for Application Cross Developing.
•	Terminal Software: for Debugging or system setting, etc.
•	Serial cable: USB-Serial adapter (and RS-232-C cross cable) for system setting, maintenance and debugging.

## 3.4 3rd party purchasable items
Not Applicable.

# 4 Set up your development environment
## 4.1 Tools installation (IDEs, Toolchains, SDKs)

No IDE.

Our custom Linux OS images is including a development environment and BSP software.
Check our website, below.
https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/rtos-cpu/rtos-osfree-cpu/#%E8%A9%B3%E7%B4%B0__OS%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8

# 5 Set up device hardware
See our Product website, below.
 https://www.yokogawa.co.jp/solutions/products-and-services/control/control-devices/real-time-os-controller/rtos-cpu/rtos-osfree-cpu/

# 6 About AWS IoT Greengrass
To learn more about AWS IoT Greengrass, see [How AWS IoT Greengrass works](https://docs.aws.amazon.com/greengrass/v2/developerguide/how-it-works.html) and [What's new in AWS IoT Greengrass Version 2](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-v2-whats-new.html).

# 7 Greengrass prerequisites
Refer to the online documentation detailing the [prerequisites](https://docs.aws.amazon.com/greengrass/v2/developerguide/getting-started-prerequisites.html) needed for AWS IoT Greengrass.  Follow the instructions in the following sections:
[Step 1: Set up an AWS account](https://docs.aws.amazon.com/greengrass/v2/developerguide/getting-started-set-up-aws-account.html)
[Step 2: Set up your environment](https://docs.aws.amazon.com/greengrass/v2/developerguide/getting-started-set-up-environment.html)

# 8 Install AWS IoT Greengrass
Follow the online guide to [Install with automatic provisioning](https://docs.aws.amazon.com/greengrass/v2/developerguide/quick-installation.html).  Refer to the instructions in the following steps:
•	[Set up the device environment](https://docs.aws.amazon.com/greengrass/v2/developerguide/quick-installation.html#set-up-device-environment)
•	[Provide AWS credentials to the device](https://docs.aws.amazon.com/greengrass/v2/developerguide/quick-installation.html#provide-installer-aws-credentials).  For development environments, you can use the option “Use long-term credentials from an IAM User”.  An example of how to do this is shown below:
```
export AWS_ACCESS_KEY_ID=<the access key id for your user>
export AWS_SECRET_ACCESS_KEY=<the secret access key for your user>
```
•  [Download the AWS IoT Greengrass Core software](https://docs.aws.amazon.com/greengrass/v2/developerguide/quick-installation.html#download-greengrass-core-v2)
•  [Install the AWS IoT Greengrass Core software](https://docs.aws.amazon.com/greengrass/v2/developerguide/quick-installation.html#run-greengrass-core-v2-installer)

# 9 Create a “Hello World” component

## 9.1	Create the component on your edge device
Follow the instructions online under the section [Develop and test a component on your device](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-first-component.html) to create a simple component on your device.
## 9.2	Upload the “Hello World” component
Follow the instructions online at [Create your component in the AWS IoT Greengrass service](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-first-component.html) to upload your component to the cloud, where it can be deployed to other devices as needed.
## 9.3	Deploy your component
Follow the instructions online at [Deploy your component](https://docs.aws.amazon.com/greengrass/v2/developerguide/deploy-first-component.html) to deploy and verify that your component is running.

# 10 Troubleshooting

For more information, refer to the online documentation [Troubleshooting Greengrass v2](https://docs.aws.amazon.com/greengrass/v2/developerguide/troubleshooting.html).
If you have any questions about F3RP70-2L, please contact us as follow URL.
 https://www.yokogawa.co.jp/contact/#Contact-Us
 ※Select you country at the top of webpage.