Guide to setting up OnLogic AWS Greengrass Compatible IoT Edge Gateways for edge-to-cloud deployments, including hardware, software, and Greengrass component setup.
1- Revision History
Document Version
Date
Changes
1.0
2.16.24
Initial Version
The OnLogic AWS Greengrass Compatible IoT Edge Gateways are designed to simplify deployment of embedded PCs for your AWS Edge projects. Using a Fanless PC increases equipment reliability and decreases downtime at the edge. OnLogic AWS Greengrass Compatible devices come tested for compatibility with to easily integrate into your AWS IoT applications.
Datasheets are available for your OnLogic AWS Greengrass Compatible IoT Edge Gateway on its’ product page under the download section. All list of systems is provided here:
Cl200 Small Form Factor Series
ML100 Industrial Edge NUC Series
Each OnLogic Gateway includes the computer itself, depending on chosen accessories the following may be included. Accessories may be purchased separately on onlogic.com where stated.
Mounting Hardware (Available for individual purchase)
Accessory Phoenix Connectors for DIO/AIO/GPIO/CANBUS, Power Terminal Block, Serial Cables
AC Power Adapter, if selected (Available for individual purchase)
OnLogic PCs for AWS IoT Greengrass are designed to integrate into your edge compute applications and as such are only a part of the solution. An IoT solution should include:
Data collection devices such as sensors and PLCs to connect to local equipment
Cloud resources to run your application in the AWS Cloud which includes any associated AWS cloud services that you need such as AWS IoT Sitewise, AWS IoT Core, AWS Lambda among others.
To take advantage of advanced features such as Microcontroller (MCU) access to control DIO, CanBUS, GPIO, automotive ignition timings (on applicable systems). Please consult OnLogic product support pages for the applicable systems for a full guide and links to Git repositories (where applicable).
The following link to individual product support pages:
Cl200 Small Form Factor Series
Helix Industrial Computers Series
For an in-depth guide on a product by product basis, visit the OnLogic support page for the product you purchase or consult the product manual. In general:
To get started remove the PC and power supply (if you purchased one) from the box. If you have a system with a pre-wired AC power adapter you can plug that into a wall outlet. If you selected a system with a terminal block you may need to wire the system into your DC power supply or an AC power adapter.
In order to set up the system you’ll need a keyboard, mouse, and display in order to perform the first time setup. Start the system by pressing the power button (if you selected auto-power on your system will start when plugged in).
If you selected a pre-install operating system from OnLogic such as Ubuntu or Windows you will be prompted to create a user account or login to an existing account. If installing your own operating system, follow your preferred provisioning method.
Ensure you are using a PC that is rated for your environment: operating temperature, input voltage, shock, vibration
Ensure to adhere to any certification requirements for IT equipment: Class 1 Division 2, UL Requirements, etc.
Use a weather resistant enclosure when appropriate to shield IT equipment from ambient conditions
Users that have these expertise should expect device setup to take less than 15 minutes for your device to be ready to connect to your existing AWS IoT Console depending on network availability.
As the OnLogic solution does not include any production environments in AWS cloud as such the user is responsible for setup, deployment, and maintenance of their AWS applications and following AWS best practices to ensure operational excellence and security. OnLogic AWS Greengrass Compatible IoT Edge Gateways can be used in any AWS Region or Availability Zone that supports Greengrass. Please ensure to adhere to any importation requirements if deploying outside the United States or European Union as there may be additional regulatory requirements for IT equipment.
To learn more about AWS IoT Greengrass, see and.
Refer to the online documentation detailing the needed for AWS IoT Greengrass. Follow the instructions in the following sections:
Follow the online guide to . Refer to the instructions in the following steps:
. 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>
Follow the instructions online under the section to create a simple component on your device.
Follow the instructions online at to upload your component to the cloud, where it can be deployed to other devices as needed.
Follow the instructions online at to deploy and verify that your component is running.
OnLogic does not offer technical support for software issues related to AWS services. Contact your technology integration resources or partner to help resolve software issues. Due to the number of different systems OnLogic offers we have a to answer commonly asked questions and offer preliminary troubleshooting information.
For Hardware support you can contact the OnLogic support team at or 802-861-2300 ext. 2 (8:30 AM to 5:00 PM EST). For responses via email and voicemail we strive to respond the same business day. If received after normal business hours we will respond in the order that they were received. Once an RMA is received normal turnaround when parts are available is 5 business days
All OnLogic systems come with a standard 2 year warranty (unless otherwise stated). For additional information the following resources are available: