cs-acn
Version:
Control Solutions Adaptive Control Network
48 lines (32 loc) • 2.3 kB
Markdown
# cs-acn
Client module for Control Solutions Adaptive Control Network Module
Installation:
Install nodejs for your platform (http://nodejs.org).
Install this package globally:
`npm install cs-acn -g`
The scripts you will likely want to use are:
_acn_ (general purpose utility for interacting with the device from the command line)
_acn-ws_ (a basic graphical interface using an HTML page)
The scripts have help output:
`acn -h`
`acn-ws -h`
Examples:
Find out what serial ports are available on your machine
`node acn -l`
Configuring the port to use for communication:
There are three choices:
* Edit the `config.json` file and enter the port name. This will be used as a default for all communication to the device.
* Set an environment variable called MODBUS_PORT (depending on platform, the syntax could be `set MODBUS_PORT=COM1` or `export MODBUS_PORT=/dev/tty1`). This will override the setting in config.json for a particular terminal window (this is useful if you have more than one wireless device connected; you can use separate terminal windows to manage them).
* Specify the port on the command line (eg `node acn slaveId --port=COM1`). This overrides the config.json setting and the environment variable.
Verifying connection:
The `node acn slaveId` command queries the device for basic information, such as serial number. This can be useful to confirm communication with the device.
Troubleshooting:
Verbose mode (eg `node acn slaveId -v`) can be useful - it displays the actual bytes sent and received from the device.
Tweaking:
`config.json` contains other settings used for communication; some of these are explained in the github cs-modbus package (https://github.com/csllc/cs-modbus). These should not normally need to be changed.
Configuring the device:
Refer to Control Solutions document DOC0003826A for the device register map. The _acn_ utility gives friendly access to read and write these registers. For example, to read the non-volatile configuration of the device:
`node acn read config`
Change the number of milliseconds between the transmission of button status:
`node acn write msBetweenStatusTx 100`
The register names available for reading and writing are available on the `node acn -h` help screen.