Amateur Radio Rotator Control - WebInterface & Win-Test Gateway
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin source code upload Aug 17, 2015
examples added udev rules example Aug 17, 2015
misc
mocks
public source code upload Aug 17, 2015
routes source code upload Aug 17, 2015
views source code upload Aug 17, 2015
README.md deprecation message Dec 8, 2017
app.js
config.js source code upload Aug 17, 2015
gpl.md added readme and gpl license Aug 17, 2015
log.js
package.json source code upload Aug 17, 2015
wt.js source code upload Aug 17, 2015

README.md

ARSCTL - a flexible web interface for your antenna rotators

** PROJECT DEPRECATED ** This project is deprecated and has been replaced by remoteRotator.

Arsctl is a server side application which makes all your antenna rotators available on a network. Arsctl allows you to conveniently control your rotators from any computer / tablet or smartphone through a slick web interface. Arsctl can also hook transparently into a Win-Test network and provide the rotators directly to the Win-Test application. Arsctl is based on NodeJs and written entirely in Javascript.

Screenshot of arsctl in action

The library has been used in several major contests at ED1R and has proven to be stable.

Documentation

You can find a detailed description of arsctl on DH1TW's blog. The source code is also well documented.

Supported Rotators

Arsctl supports EA4TX' fabulous Antenna Rotator System (ARS) and Yaesu rotators with a USB / serial interface.

License

Arsctl is published under the GPL open source license. Feel free to fork and collaborate!

Supported OS

Arsctl has been developed and tested under OSX and Linux (Ubuntu). However it should also work with some minor tweaks on other Linux distributions and Windows. It works very well on small ARM devices, like the Raspberry Pi & Banana Pi.

Installation (quick)

  1. Install a copy of the latest NodeJs version on your system. Note that the version in the Ubuntu repository is quite old. Better install it from the the Nodejs PPA.

  2. Clone the arsctl repository with git on your local machine git clone https://github.com/dh1tw/arsctl.git

  3. Browse into arsctl's directory and install all the needed dependencies with Node's package manager (NPM). All dependencies are registered in package.json npm install

  4. Configure your rotator and webserver setup (config.js).

  5. Run arsctl of the source code directory with node ./bin/www

  6. Open your browser and navigate to url put in the config file. For example http://localhost:4000

Installation (optional steps)

  1. It is recommended to separate the config file from the source code (e.g. /etc/arsctl/myConfig.js) so that the config file doesn't get overwritten on the next software update. Some configuration file examples are included in the /examples/arsctl_config_files folder.

  2. Point to the location where your config file is located (in app.js).

  3. It is recommended to daemonize arsctl and run arsctl as a service. For Ubuntu's Upstart a example file has been included in the /examples/upstart_service directory. This file should be copied to /etc/init/arsctl.conf.

  4. If you want to use the standard HTTP port (or any other port below 1024) make sure that you execute arsctl under root priviliges.

  5. For logging you might create and direct the application output to you a file, e.g. (/var/log/arsctl.log)

  6. If you have more than one rotator connected through USB, Linux might assign them to different port names everytime you plug them in. In order to map a USB device to a specific port (e.g. /dev/Rotator1) you have to create a custom udev rule with the Rotator's DeviceId, ProductId and SerialNr. The file with the custom rule has to be placed under Ubuntu in /etc/udev/rules.d/. An example for a custom udev rules file is located in /examples/udev_rules.

Known bugs

Due to some bugs in the SerialPort Library, serial devices can't be properly removed. Therefor the application terminates when a Rotator gets disconnected. If you daemonize arsctl, it will automatically restart.