-
Notifications
You must be signed in to change notification settings - Fork 0
[Tutorials] Development Documentation
This section describes how to start the tutorial applications step by step. The following tutorials are made:
For ease of use of the following tutorial examples, .bat and .sh files have been created so that they automatically use predefined docker commands to build and save an image. Their usage is also described in detail in the end section.
In this section, application tutorials are discussed. Environment setup, application implementation and running of the application is described for a Python, C# and Go application. Links to application files are provided for each example given.
The LED DIO application is a simple application that can read and writes sensor status via TDC-E which runs on ARM 32 v7. To do so, it does not use web sockets nor https, but a direct interface. The program randomly chooses whether to set the specified LED output on or off in an infinite loop.
Since the application works with a LED and the DIO interface, a requirement for the application to work is to set up the DIO interface. For help with the setup, refer to TDC‐E Interface Configuration's Digital Input Output section.
This application is implemented relatively simply. It starts an infinite for loop which executes a function to change the LED value, then sleeps for 5 seconds before once again setting the LED to a different value.
The function is implemented so that it randomly chooses whether to start or stop the glow of the LED, then executes a shell command used to turn the LED on or off. If the value is 0, the LED is off. Otherwise, the LED is on.
It is also important to note the GPIO of the LED, since each digital input and digital output has a different values for their GPIO. The GPIO used for the program is 496, mapped to the A connector, and it is a digital output. If another configuration is needed, make sure to use the correct mapping.
The command is executed with the following Golang code:
out, err := exec.Command("sh", "-c", cmd).Output()
This code executes a shell command using the os/exec Go package. The cmd parameter is the parameter for changing the LED state. The LED is set to ON using the following command:
echo 1 > /sys/class/gpio/gpio496/valueThis sets the value in the path /sys/class/gpio/gpio496/value to 1, turning the LED on. To turn it off, the following command is used:
echo 0 > /sys/class/gpio/gpio496/valueStep 1. Building, Pushing, Saving
The files for this tutorial contain two ways to build, push or save the application developed for the TDC-E. These files have the extensions .bat and .sh respectively. Below is a list of the files available for building, pushing and saving the application:
-
build-registry.bat- builds the image and pushes it to a registry, for Windows OS -
build-registry.sh- builds the image and pushes it to a registry, for Linux OS -
build-tar.bat- builds the image and saves it as.tarfile, for Windows OS -
build-tar.sh- builds the image and saves it as.tarfile, for Linux OS
**NOTE: **The registry files need to be modified with text or code editing software, as the registry name should be modified to match the name of the available registry. See details below.
1.3.3.1. Creating Image with a Registry
If there is an available registry that will store the images, click on the build-registry.bat if you're running Windows OS, or build-registry.sh if you're running Linux OS. The image will be built automatically and sent to your registry with the annotated name. Now, the image is in your registry, and can be pulled from any other device with access to it. Now it needs to be downloaded to the device that is going to run it, namely your TDC-E device.
Then log onto your TDC-E device. See this short section for pulling the image to your device. Now proceed to Step 2.
1.3.3.2. Creating Image with a .tar File
To create an image without a registry, click on the build-tar.bat file if using the operating system Windows, or build-tar.sh if using the operating system Linux. This should automatically build the image and save it to an archive called directdioled.tar. This archive can then be uploaded to the TDC-E by using Portainer. For help with the uploading process, refer to this section. Now proceed to Step 2.
Step 2. Creating a Container
Containers are needed to provide a runtime environment for the images you've created. The images are now safely stored on your TDC-E device and will need to be bound to a container next. Find the docker-compose.yml file in the linked application files which is used to create a suitable environment for your application. Use this file and follow the steps described here. Choose one of the two described ways to create a container.
The container should now start running automatically if all is correct, and the application should be running on your device.