42Q-MES0184-IIoT Configuration

42Q Home > IIoT > Device Self Service

 

 

 

IIoT Configuration Device Self Service Version MES 15.77 Revision D1  

 

 

 

 

Introduction

The concept of GGC stands for “Green Grass Computer”, the word: “Computer” also refers to any kind of device. This document will teach users how to configure, install, and deploy a GGC, as well as create and set up an Edge Device for the purpose of establishing a connection between the computer (device) and the 42Q portal to send data (payloads).

 

Prerequisites

• Only Linux is supported for the computer or device to install the Green Grass Core. The related shell scripts and test code only work on Linux systems (Windows is not currently supported).
• Python 3.8 or higher must be installed and configured to run the test code.

Operating System and Software Requirements

• Linux kernel version 4.4 or later (Ubuntu 20.04 and CentOS 8.5).
• Java Runtime Environment (JRE) version 8 or greater (included in the installation script).
• Python version 3.8 for functions that use the Python 3.8 runtime (included in the installation script).

 

Cgroups Requirements

The AWS IoT Greengrass Core software currently only supports cgroups v1, not v2. In order to satisfy AWS Greengrass Core dependencies as stated in the official documentation "Setting up AWS IoT Greengrass core devices"  (Setting up AWS IoT Greengrass core devices - AWS IoT Greengrass ), the system should be configured with the following Linux kernel parameters and restarted:

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

 

Adjusting cgroup configuration

1. Edit /etc/default/grub - Find the line that starts with "GRUB_CMDLINE_LINUX=" and append or change the following values: cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=false - Save the file
2. Apply the configuration change by running: update-grub
3. Restart the system
4. Verify that the cgroup configuration has been set to v1 by running the following command and ensuring that the response is "tmpfs": stat -fc %T /sys/fs/cgroup/;

 

Network requirements

The Green Grass Core device  must be able to access the following endpoints through specific ports:

• https://www.amazontrust.com/repository/AmazonRootCA1.pem.
• https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.6.0.zip.
• greengrass-ats.iot.us-east-1.amazonaws.com. Ports:   8443, 443.
  • .iot.us-east-1.amazonaws.com. Ports:  8883, 8443, 443.
  • .credentials.iot.us-east-1.amazonaws.com. Ports: 443

For more details on what traffic needs to be authorized and why, please visit the official AWS documentation.

 

Functional Description

There are three different functional components: CloudPrinting, MachineInterface, and DataIngestion.
To access the Edge Devices portlet, navigate to: Shop Floor Control > Configuration > IIoT Configuration > Edge Devices.

Figure 1: Accessing Edge Devices

 

 

Figure 2: Edge Devices Functions

DSS Edge Devices Functions.png

 

1. Users can query the list of all devices by Edge Device Name or Group Name.
2. Users can create a new edge device.
3. Users can view the details of the edge device.
4. Users can download the software of the edge device.
5. Users can upgrade this edge device with more features.
6. Users can get all functional components through this button when no functional components are deployed on their local core device.
7. Users can delete the edge device.

 

 

 

Install 42Q Edge Software

CloudPrinting

 

Figure 3: Cloud Printing

 

Please follow the steps below to create a 42Q Cloud Printing Edge Device in 42Q:

1. Navigate to: Shop Floor Control > Configuration > IIoT Configuration > Edge Devices.
2. Select CREATE EDGE DEVICE to create a new Green Grass Core.

 

Figure 4: CREATE EDGE DEVICE Button

DSS CREATE EDGE DEVICE Button.png

 

3. Enter the Edge Device Name of the Green Grass Core. The name can be up to 128 characters. Valid characters are: a-z, A-Z, 0-9, colon (:), underscore (_), and hyphen (-).
4. Select the Group Name as CloudPrintingGroup.

Note: After selecting the Group Name, the Group Version will automatically be selected.

 

Figure 5: Create Edge Device Form

DSS Create Edge Device Form.png

 

5. Select the checkbox next to the desired Edge Device.
6. Select the Download icon to download the Edge Device ZIP file.

 

 

Figure 6: Downloading The Files

 

7. Right-click on the ZIP file.
8. Select Extract Here to unzip the file.
9. Open the Terminal.
10. Enter the command: sudo su, and then press Enter.
11. Enter the root user’s password, and then press Enter.

Note: If the word: root@ appears before the computer’s username as in the image below, it means that you are logged in as a root user.

 

Figure 7: User Logged In as a Root User

 

12. Enter the next command: sh ggcV2.sh, and then press Enter.

Note: After the script is installed successfully, users can navigate to the local device’s path: /greengrass/v2 to check the installed folder; logs are contained in the path: /greengrass/v2/logs.

 

Figure 8: Edge Device Folder

 

Testing Label Printing Function Using Label Engine Screens

1. Navigate to: Administration > Label Engine Admin > Printer.
2. Select Add.

 

Figure 9: Add Printer Button

 

3. Enter the Printer Name.
4. Select the Resolution from the drop-down list.
5. Select the Connectivity Type as Edge Device.

 

Figure 10: Entering The Printer Details

 

Note: The TCP IP Address should be the address of the printer or start a TCP Server as a simulator by executing the next command in the Terminal: python3 tcpServer.py.

 

6. Navigate to: Production > Label Engine Labels > LE Labels.
7. Search for the label called “entry”, which will print whatever "Entry" value is passed.
8. Select the checkbox next to the printer name.
9. Select Print.

 

Figure 11: Print Button

 

10. Select the Printer Name previously created.
11. Enter a value in the Entry field.
12. Select Test Print.

 

 

Figure 12: Entering Test Print Data

 

13. Open the Terminal.
14. Navigate to the local device’s path: /greengrass/v2/logs.
15. Enter the next command: tail -f {envide}_CloudPrinting.log. After that, a message will be received to confirm the successful testing.

---

 

Figure 13: Successful Testing Message

 

 

 

MachineInterface

This function is used for sending commands to machines from the cloud.
Below there is an example of stopping a machine when the server finds MSD material expired.

 

Figure 14: Server Stopping A Machine Due To Material Expired Diagram

 

The diagram above is divided into three steps:

1. Install an Edge Device on a server in the plant.
2. The plant creates a new local application that can communicate with the Edge Device by TCP and also can send commands to machines.
3. The Cloud application will send commands to the Edge Device, then the Edge Device will forward the message to the local application through TCP/IP.

Please follow the steps below to create a 42Q Cloud Machine Interface Edge Device in 42Q:

1. Navigate to: Shop Floor Control > Configuration > IIoT Configuration > Edge Devices.
2. Select CREATE EDGE DEVICE to create a new Green Grass Core.
3. Enter the Edge Device Name of the Green Grass Core. The name can be up to 128 characters. Valid characters are: a-z, A-Z, 0-9, colon (:), underscore (_), and hyphen (-).
4. Select the Group Name as MachineInterfaceGroup.

Note: After selecting the Group Name, the Group Version will automatically be selected.

 

5. Select the checkbox next to the desired Edge Device.
6. Select the Download icon to download the ZIP file.
7. Right-click on the ZIP file.
8. Select Extract Here to unzip the file.
9. Open the Terminal.
10. Enter the command: sudo su, and then press Enter.
11. Enter the root user’s password, and then press Enter.
12. Navigate to the extract folder by using the command: cd {folder path}.
13. Enter the next command: sh ggcV2.sh, and then press Enter.

Note: After the script is installed successfully, users can navigate to the computer’s path: /greengrass/v2 to check the installed folder; logs are contained in the path: /greengrass/v2/logs.

 

14. Open Postman to test its functionality.
15. Select POST as HTTP Method.
16. Enter the URL.
17. Enter the Topic.
18. Enter the Output.
19. Enter the Error.

 

Data nomenclature example:
URL: https://portal-uat.42-q.com/mes-api/[SiteName]/greengrass/v2/publish
Topic: [Envide]/machine-interface/[Envide]_[Edge device name]
Output: [Envide]/machine-interface/results
Error: [Envide]/machine-interface/errors

 

Figure 15: Sending The Payload Using Postman

 

20. Open the Terminal.
21. Navigate to the local device’s path: /greengrass/v2/log to view the logs.

 

 

Figure 16: Successful Payload Sending Logs

 

Note: If the message from the previous image is printed in your local log, the function has succeeded.
Adding the corresponding configuration for PTS allows PTS to send messages to Edge Device.

 

DataIngestion

Please follow the steps below to create a 42Q Cloud Data Ingestion Edge Device in 42Q:

1. Navigate to: Shop Floor Control > Configuration > IIoT Configuration > Edge Devices.
2. Select CREATE EDGE DEVICE to create a new Green Grass Core.
3. Enter the Edge Device Name of the Green Grass Core. The name can be up to 128 characters. Valid characters are: a-z, A-Z, 0-9, colon (:), underscore (_), and hyphen (-).
4. Select the Group Name as DataIngestionGroup.

Note: After selecting the Group Name, the Group Version will automatically be selected.

 

5. Select the checkbox next to the desired Edge Device.
6. Select the Download icon to download the ZIP file.
7. Right-click on the ZIP file.
8. Select Extract Here to unzip the file.
9. Open the Terminal.
10. Enter the command: sudo su, and then press Enter.
11. Enter the root user’s password, and then press Enter.
12. Enter the next command: sh ggcV2.sh, and then press Enter.

Note: After the script is installed successfully, users can navigate to the computer’s path: /greengrass/v2 to check the installed folder; logs are contained in the path: /greengrass/v2/logs.

 

13. When the status of this Edge Device is "Healthy", select the Edit button to enter the Edge Device information.

 

Figure 17: Edit Button

 

14. Select the CLIENT DEVICES tab.
15. Select CREATE CLIENT DEVICES.

 

Figure 18: CLIENT DEVICES TAB

 

16. Enter the name of the Client Device to be created.

Note: The name can be up to 128 characters. Valid characters: a-z, A-Z, 0-9, colon (:), underscore (_), and hyphen (-).

 

17. Select ASSOCIATE.

 

 

Figure 19: Creating a Client Device

 

18. Select the Download icon to download the Client Device ZIP file.
19. Right-click on the ZIP file.
20. Select Extract Here to unzip the file.

 

Figure 20: Client Device Folder

DSS Client Device Folder.png

 

21. Open the MqttTest.py file.
22. Find the line that contains: ‘# Change This’.
23. Modify the data information to be sent; users may see an example below (user’s will be different).

 

Figure 21: Data To Be Modified

DSS Data To Be Modified.png

 

24. Open the Terminal.
25. Enter the next command: python MqttTest.py, and then press Enter. The result should be similar to the image below:

 

Figure 22: Result Of Executing The MqttTest.py File

 

26. Navigate to the local device’s path: /greengrass/v2/log to view the logs.

 

 

Figure 23: Successful MqttTest.py Running Logs

 

Note: If the message from the previous image is printed in your local log, the function has succeeded.

 

27. Navigate to: Shop Floor Control > Configuration > IIoT Configuration > Things.

 

Figure 24: Things Portlet

 

28. If the “Thing ID” is the same as the “id” configured in MqttTest.py file, it means that AWS Cloud has already stored the data uploaded.

 

 

Figure 25: Thing ID

 

29. Navigate to: Reporting > IIoT Dashboard.
30. Select the + icon to create a new widget.

 

 

Figure 26: Add (+) Icon

 

31. Enter the Widget Name.
32. Select the THINGS tab.
33. Select the "id" value previously configured in the MqttTest.py file.
34. Select the SAVE button located at the end of the Add Widget Form.

 

Figure 27: Creating a Widget

 

35. Select the show/hide icon to view the values of the widget created.

 

Figure 28: Show/Hide Icon

Note: Users can check the payload sent through either of the following:

• IIoT widget.

---