3.- remoterotator: Installation and configuration

Finally in this third phase we will explain how to upload the remoteRotator program, its configuration and how to do a simple start or stop script. Of course, perhaps the most important point, autostart automatically the application when the RsPi initializes

remoteRotator program

We can download the program from the Tobi DH1TW repository:

https://github.com/dh1tw/remoteRotator/releases

Of the different binaries available, the one that interests us for the Raspberry Pi is the version for linux-arm.

For example for version 0.4.1 the binary would be: remoteRotator-v0.4.1-linux-arm.tar.gz

We have many ways to put the remoteRotator binary in the RsPi, some will surely choose to download it to the PC and from there, upload it via FTP to the RsPi. Through these two steps, you would have the file already uploaded. But if you want to do it directly from the RsPi there is a command that allows it and is using the wget command plus the link to the repository file, for example for that version 0.4.1 the complete command would be:

wget https://github.com/dh1tw/remoteRotator/releases/download/0.4.1/remoteRotator-v0.4.1-linux-arm.tar.gz

As it’s a compressed file we will decompress it using the command:

sudo tar -xvzf remoteRotator-v0.4.1-linux-arm.tar.gz

With this we already have the binary in the RsPi but surely in the root folder or /home/pi. The uncompressed file will have the name remoteRotator. Now we are going to copy the program to the /usr/local/sbin folder, which is where it should be, for this we can use the mc program (midnight commander that we had already installed in step 2) or with the command:

sudo cp remoteRotator /usr/local/sbin/

With this we have the program ready to be executed.

Configuration file

The remoteRotator program can be executed by command line with all the options but it is probably more practical to have a configuration file and execute the program indicating the location of the configuration file. You can know all available options using the help command -h for example:

/usr/local/sbin/remoteRotator -h

or to obtain the help of the options for server lan (2 of the options that we are going to use) would be:

/usr/local/sbin/remoteRotator server lan -h

As I said before it seems more practical to have a configuration file with all its options than to run the program with all the options on the command line, then I left in this link (https://ea4tx.com/wp-content/uploads/ files / ars1.toml) an example that I use. It can be downloaded using the command

wget https://ea4tx.com/wp-content/uploads/files/ars1.toml

And since the usual thing is that the configuration files are usually in the /etc folder, we copy it  there.

sudo cp ars1.toml /etc/

If we edit the file (we can use the nano editor or using the Midnight Commander) we will customize some of the parameters of the configuration.

In our case we use the serial port that is the ttyACM0 (by default it will be the one used for the first ARS-USB). As all the devices are available at the folder /dev and the ARS are seen as ports of the type ttyACMx (where x can be 0 for the first, 1 for the second ARS, etc) using the command:

ls /dev/ttyACM*

We take out the relationship of those who are present. Remember that in this case you have to have turned on the ARS-USB and connected to any of the USB ports of the RsPi. Before continuing to make the program start automatically as a service, it is best to manually check the start and see what works. To do this, if you have already edited the configuration file with your customizations, run the program by hand using the command:

/usr/local/sbin/remoteRotator server lan --config /etc/ars1.toml

f the program starts well, you can open a browser and indicate the address and web port of the program, for example: 192.168.1.11:7071 Note: Remember that if you get a permission error when you run it, it may be because the user do not have permission to access the serial port. In step 2, it was explained how you can add a user to the dialout group. Or run the program as root by adding sudo to the command. Example:

sudo /usr/local/sbin/remoteRotator server lan --config /etc/ars1.toml

If the program works now, check the permissions for the user pi.

Start System

We are going to use SystemD so that when the Raspberry Pi is started, the program is automatically executed. For this we will leave in the /etc/systemd/system folder a file such as ars1.system This file indicates the path where the program is located, its boot options, user account with which it runs, etc. You can download a sample model from my site using the command:

sudo wget https://ea4tx.com/wp-content/uploads/files/ars1.service

We will copy this file in the folder /etc/systemd/system, then the command will be:

sudo cp ars1.service /etc/systemd/system/

Basically this file that you have downloaded and copied to the folder /etc/systemd/system you can leave it as it is without having to change anything. Now we just have to add this service ars1 in the systemd manager, then execute the command:

sudo systemctl enable ars1.service

Then in the next boot, this service will be executed automatically. You can also start or stop manually:

sudo service ars1 start

or:

sudo service ars1 stop

With all this, we should already have the remoteRotator program running, then we could start a browser on our PC and connect to the URL of the Raspberry Pi with port 7071 (it is the default port defined in the file ars1.toml for the Web)

Or open the ARSVCOM, configure that you use a “Remote TCP/IP” and in its configuration indicate the IP and TCP port used by the Raspberry Pi (ie 192.168.1.11 and port 6001)