kopia lustrzana https://github.com/Hamlib/Hamlib
135 wiersze
3.9 KiB
Plaintext
135 wiersze
3.9 KiB
Plaintext
The following are the specifications for the EasyComm interfaces which
|
|
are available with the WiSP programs. The EasyComm
|
|
interfaces are for use by those who wish to design their own radio and rotor
|
|
controllers.
|
|
|
|
EASYCOMM I Standard
|
|
-------------------
|
|
|
|
The EasyComm 1 standard is a simple ASCII character based standard for
|
|
controlling antennas and rotators.
|
|
|
|
The host PC issues a single line command as follows -:
|
|
|
|
AZaaa.a ELeee.e UPuuuuuuuuu UUU DNddddddddd DDD
|
|
|
|
The Az and El values (aaa.a and eee.e) are not fixed width. They are in
|
|
degrees and include 1 decimal place.
|
|
|
|
The Up and Dn frequencies are in Hz.
|
|
|
|
UUU and DDD are the uplink and downlink mode.
|
|
|
|
EASYCOMM II Standard
|
|
--------------------
|
|
|
|
The EasyComm 2 standard is an enhanced protocol to allow full station
|
|
control and also feedback from external systems.
|
|
|
|
The host PC issues commands to the controller by sending a 2 character
|
|
command identifier followed by the command value. Commands are
|
|
separated by either a space or carriage return or linefeed.
|
|
Not all commands need to be implemented, and the most basic system
|
|
may only decode the rotator control commands.
|
|
|
|
The Host PC can issue the following commands -:
|
|
|
|
Command Meaning Perameters
|
|
------- ------- ----------
|
|
|
|
AZ Azimuth number - 1 decimal place [deg]
|
|
EL Elevation number - 1 decimal place [deg]
|
|
UP Uplink freq in Hertz
|
|
DN Downlink freq in Hertz
|
|
DM Downlink Mode ascii, eg SSB, FM
|
|
UM Uplink Mode ascii, eg SSB, FM
|
|
DR Downlink Radio number
|
|
UR Uplink Radio number
|
|
ML Move Left
|
|
MR Move Right
|
|
MU Move Up
|
|
MD Move Down
|
|
SA Stop azimuth moving
|
|
SE Stop elevation moving
|
|
AO AOS
|
|
LO LOS
|
|
OP Set output number
|
|
IP Read an input number
|
|
AN Read analogue input number
|
|
ST Set time YY:MM:DD:HH:MM:SS
|
|
VE Request Version
|
|
|
|
For those commands that require a response, the response is an echo of
|
|
the command followed by the response. If the command specifies a field
|
|
number (eq. AN or IP), then the two numbers are delimited with a comma.
|
|
eg. To read an analogue value, the host sends ANx where x is the
|
|
analogue channel number.
|
|
|
|
In response the controller will reply with ANx,yyy where yyy is the
|
|
value read on the analogue port.
|
|
eg. To find the controller version number, the host sends VE.
|
|
In response the controller sends VExxx where xxx is an ascii string
|
|
containing the version number.
|
|
|
|
All strings sent in either direction are not of fixed length.
|
|
The controller can also send unsolicited information back to the
|
|
host. This information may be used by the host for alarms or just
|
|
control feedback. All of the above commands may be sent by the
|
|
controller for information, and in addition the following may also
|
|
be sent
|
|
|
|
ALxxx Alarm, where xxxx is an ascii string with the alarm info.
|
|
|
|
Chris Jackson, G7UPN
|
|
|
|
EASYCOMM III Standard
|
|
--------------------
|
|
|
|
The EasyComm 3 standard is an extension of the version 2 with the additional features:
|
|
|
|
|
|
Command Meaning Perameters Hamlib Config Token
|
|
------- ------- ---------- -------------------
|
|
VL Velocity Left number [mdeg/s]
|
|
VR Velocity Right number [mdeg/s]
|
|
VU Velocity Up number [mdeg/s]
|
|
VD Velocity Down number [mdeg/s]
|
|
CR Read config register [0-x] 1
|
|
CW Write config register [0-x] 2
|
|
GS Get status register 3
|
|
GE Get error register 4
|
|
|
|
VE Request Version 5
|
|
IP Read an input number 6
|
|
OP Set output number 7
|
|
AN Read analogue input number 8
|
|
|
|
|
|
>Several status and error bits can combined. Proposed mapping:
|
|
|
|
Status Meaning
|
|
------- -------
|
|
1 Idle
|
|
2 Moving
|
|
4 Pointing
|
|
8 Error
|
|
|
|
Error Meaning
|
|
------- -------
|
|
1 Sensor Error
|
|
2 Jam
|
|
4 Homing Error
|
|
|
|
>Proposed mapping of configuration registers:
|
|
|
|
Register Meaning Value
|
|
------- ------- ----------
|
|
0 MaxSpeed number
|
|
a Overshoot 0/1/-
|
|
b Jamming 0/1/-
|
|
c Endpoints 0/1/-
|
|
d Unstick 0/1/-
|
|
|
|
|
|
73, Alexander Schultze
|