Ten-Tec OMNI-VII 588 Manual de usuario

Rev 1.009 OMNI-VII Programmer’s Reference Guide 1 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

OMNI-VII

Model 588

Programmers

Reference

Guide

Revision 1.009

Rev 1.009 OMNI-VII Programmer’s Reference Guide 2 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Introduction..................................................................................................................4

Conventions Used in This Manual ...........................................................................6

Interface Settings ......................................................................................................7

Serial Connection ..................................................................................................7

Ethernet Connection..............................................................................................8

The OMNI-VII Command Set ..................................................................................... 9

OMNI-VII Command Set Quick List.....................................................................10

RADIO MODE Command Set ............................................................................... 15

Frequency Tuning................................................................................................15

AGC Mode Control.............................................................................................16

Squelch (all mode)...............................................................................................16

RF Gain ...............................................................................................................17

RF Attenuation Control.......................................................................................17

Noise Blanker, Noise Reduction, and Automatic Notch..................................... 18

Receive and Transmit Modes..............................................................................18

Passband Tuning (PBT).......................................................................................19

AF (Audio Volume) ............................................................................................19

Version – Query Only .........................................................................................20

Receive Filter ......................................................................................................20

Where – AT.........................................................................................................21

Execution Control ...............................................................................................21

SUNIT – Query Only .......................................................................................... 22

Transmit...............................................................................................................23

Split State – Radio Mode.....................................................................................24

Main Mode Query – Orion Format .....................................................................24

REMOTE MODE Command Set ...........................................................................25

Ethernet Settings – Query Only...........................................................................26

Frequency Tuning................................................................................................27

Receive / Transmit Offset....................................................................................28

Audio Source.......................................................................................................29

Keying Loop On/Off ...........................................................................................30

CW RISE/FALL TIME.......................................................................................30

Mic Gain..............................................................................................................31

Line Gain.............................................................................................................31

Speech Processor.................................................................................................32

FM CTCSS Tones ...............................................................................................32

RX Equalizer.......................................................................................................33

TX Equalizer .......................................................................................................33

Transmit Roll Off................................................................................................34

External T/R Delay..............................................................................................34

Sidetone Frequency.............................................................................................35

CW QSK Delay...................................................................................................35

Transmit Enable ..................................................................................................36

Sideband Transmit Bandwidth ............................................................................37

Auto Tuner ..........................................................................................................38

Rev 1.009 OMNI-VII Programmer’s Reference Guide 3 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Sidetone Volume.................................................................................................38

SPOT Volume .....................................................................................................39

FSK Mark High/Low...........................................................................................39

I-F Filter Selection...............................................................................................40

I-F Filter Enable ..................................................................................................40

Antenna ...............................................................................................................41

Monitor................................................................................................................41

Transmit Power ...................................................................................................42

SPOT Tone On/Off .............................................................................................42

PREAmp On/Off.................................................................................................43

Remote Tune .......................................................................................................43

Split State – Extended Format.............................................................................44

VOX TRIP Level.................................................................................................44

ANTI VOX Level................................................................................................45

VOX Hang Time .................................................................................................45

CW Keyer Mode .................................................................................................46

CW Keyer Weighting..........................................................................................46

Manual NOTCH On/Off .....................................................................................47

Manual NOTCH Center Frequency ....................................................................47

Manual NOTCH Width.......................................................................................48

Internal Keyer Speed...........................................................................................48

VOX On/Off........................................................................................................49

RADIO DISPLAY ON/OFF ...............................................................................49

RADIO SPEAKER ON/OFF ..............................................................................50

TRIP Gain............................................................................................................50

Operation with Optional 302 Remote Encoder..........................................................51

POD PASSTHRU Command .................................................................................51

POD PASSTHRU Notification...............................................................................52

POD ENCODER Notification ................................................................................ 53

Serial Device Control via Ethernet ............................................................................54

Serial Pass Thru ......................................................................................................54

Serial Echo Mode ...................................................................................................55

CWType.....................................................................................................................57

Ethernet Audio ........................................................................................................... 59

RIP (Radio over IP) Introduction ...........................................................................59

TRIP (Transmit over IP) Introduction ....................................................................59

RIP Audio Packet Format.......................................................................................60

TRIP Audio Packet Format ....................................................................................61

Ethernet Command/Query Format.............................................................................61

Document Revision History.......................................................................................62

Rev 1.009 OMNI-VII Programmer’s Reference Guide 4 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Ten-Tec has produced this document as a starting point for software developers

undertaking the development of a PC based OMNI-VII (Model 588) Interface program.

The Ten-Tec OMNI-VII DSP HF transceiver is a product that is defined more by

firmware than hardware. As such, it is subject to change based on customer needs. It is

advisable to check for a more recent update at the Ten-Tec firmware update site,

www.rfsquared.com. This specification is intended for OMNI-VII Version 1.005 or later.

There are two levels of command interface protocols provided. The two levels of

commands are designed for two different operating modes of the OMNI-VII.

The first Operating Mode is referred to as “RADIO MODE”. In “RADIO MODE”

only the base level of commands is available, and they are available only on the Serial

Interface. This is the command-set that is already utilized by the Jupiter in Jupiter mode.

A few of these commands have a parameter list that is extended to encompass added

items for that command. This makes the base level of the OMNI-VII in Radio Mode

compatible with control programs that already exist. The purpose of “RADIO MODE” is

for the radio user who wants to control the rig traditionally from the front panel.

Changing frequencies, watching the Power Meter, switching bands, and adjusting the

myriad of other controls, just like it is done with an Orion or Jupiter.

The second Operating Mode is referred to as “REMOTE MODE”. In order to get

fully functional control of all of the OMNI-VII’s operating parameters, then it is

necessary to operate the OMNI-VII in “REMOTE MODE”. In this mode, the full

command set is available on the Ethernet interface, and also the serial port. The purpose

for “REMOTE MODE” is to be able to control the radio 100% through the Serial and/or

Ethernet interfaces. “REMOTE MODE” also provides for the audio streaming features

of RIP and TRIP.

RIP is an acronym for Radio over IP. This is the receive audio that is heard via the

OMNI-VII’s speaker. In the case of the REMOTE Mode radio, this audio is then RIP’d

from the OMNI-VII via the Ethernet to a computer for playback on the computer’s

speaker.

TRIP is an acronym for TRansmit audio over IP. Normally, transmit audio comes

from a microphone on the radio and is transmitted over the air by the radio. In the

instance of the Ethernet, it is the audio recorded on a microphone on a computer, and then

transmitted on the Ethernet in a packet for the OMNI-VII to subsequently transmit over

the air.

Introduction

Rev 1.009 OMNI-VII Programmer’s Reference Guide 5 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Since the OMNI-VII provides future growth for up to a total of 6 completely

independent modes. It is possible that even further additions will be made to support the

added capabilities of the other modes.

Holdings down a digit on the band stack keyboard of the front panel accesses each

mode. For “RADIO MODE”, press and hold the “1” digit until you see the Version

string including the word RADIO. For “REMOTE MODE”, press and hold the “2” digit

until you see the Version string including the word REMOTE. If you accidentally press

the wrong number (e.g. 3 through 6), then the OMNI-VII will tell you that this specific

operating mode is not present. If this occurs, then you should turn off the OMNI-VII, and

try again. If you accidentally press any other key, then you won’t see the radio version

string displayed, instead you will have forced the radio to remain in “BOOT LOADER

MODE”. Again, turn off the radio, and try again making sure you hold down the proper

key to get to the proper mode.

To add more value to a remote based radio, the OMNI-VII has the capability of

accepting Ethernet commands that are intended to be delivered to a serial device, such as

a SteppIR Antenna Controller. This is referred to as “Serial Passthru”. The OMNI-VII

also has the capability of being put into a mode where any data it receives in on the serial

port, it can echo back to the Ethernet port. This is referred to as “Serial Echo”. This

makes it possible for a remotely placed OMNI-VII to be capable of being a portal to

controlling and getting status from other serial devices at the ham shack.

Another functionality that the OMNI-VII has is the ability to provide a way to send

to the Serial Interface pod key presses. This functionality is invoked when the OMNI-VII

receives a command to tell it to start “POD PASSTHRU”. From that moment on,

anytime a pod key is pressed, the OMNI-VII will not process the key, but will send a

notification out the serial port that a given POD key has been depressed. When released,

notification is sent again out the serial port that the given POD key has been released.

This allows control programs to extend the functionality of the radio with programs

written on the PC. This functionality already exists in other TenTec Transceivers, namely

the Orion, Orion2, and Jupiter and it is already in use by various control program codes

available on the market today.

The command set described in this manual does not include the command set utilized

by the OMNI-VII Boot/Loader program for programming the OMNI-VII. The command

set described in this manual only covers the command set that is utilized for radio

command and control functions.

Rev 1.009 OMNI-VII Programmer’s Reference Guide 6 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Information contained in this document applies to firmware version 0.114 and later.

Numeric Types:

0x0A Hexadecimal Numbers.

<dn> 8 bit numbers

10 Decimal Number.

‘A’ ASCII character code.

Example: ASCII ‘A’ is 0x41.

<CR> a byte containing the value of <0x0d> for a carriage return

Conventions Used in This Manual

Rev 1.009 OMNI-VII Programmer’s Reference Guide 7 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Serial Connection

The RS-232 serial interface on the OMNI-VII is handled via a 16C550 UART

located on the DSP/Logic board. The interface parameters are fixed at 57,600 baud, No

Parity, 8 Data bits, 1 Stop bit. The UART uses hardware handshaking to control the data

flow between the PC and the radio. The host PC should be set to use RTS/CTS signaling.

This is the same regardless of whether the topic is command and control interface on

the serial port or using the serial port for serial pass thru or serial echo modes.

The diagram below shows the wiring and associated signals for a 9 pin to 9 pin serial

cable required to connect the OMNI-VII transceiver to a standard PC. If you purchase a

pre-made serial cable it should be a straight through cable.

Computer Pin OMNI-VII

CD. 1 N.C.

RXD 2 Serial Data Out

TXD 3 Serial Data In

DTR 4 N.C.

GND 5 GND

DSR 6 N.C.

RTS (out) 7 RTS (in)

CTS (in) 8 CTS (out)

RI 9 N.C.

COMPUTER OMNI-VII

The serial port of the OMNI-VII is defined as a DCE terminal. Which means that it

is meant to be connected to a Computers DTE terminal. Using a straight through RS-232

control line. If you wish to control another serial device, and if it is a DCE terminal type

of a device also, then the cable you need to use is a null-modem RS232 Interface cable. If

Interface Settings

Rev 1.009 OMNI-VII Programmer’s Reference Guide 8 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

the other device is a DTE, then you will need to use a standard straight RS232 interface

cable.

In order to use the OMNI-VII in remote mode, but you intend on controlling the rig

only by the serial port, then it is suggested that you disable the Ethernet activities of the

OMNI-VII. Setting the first octet of the G8WAY IPADDR to 0 disables Ethernet

activities.

Ethernet Connection

The Ethernet interface on the OMNI-VII is handled via a Realtek RTL8019AS Full

Duplex Ethernet Controller located on the DSP/Logic board. This Network Interface

Controller (NIC) is fully compliant with Ethernet II and IEEE802.3 10Base5, 10Base2,

and 10BaseT. The full-duplex function of the NIC enables simultaneously transmission

and reception on the twisted-pair link to a Full Duplex Ethernet switching hub. This

feature not only increases the channel bandwidth from 10 to 20 Mbps but also avoids the

performance degradation problem due to the channel contention characteristics of the

Ethernet CSMA/CD protocol. This connection is configured for 10Mbps, so it is

compatible with all 10/100 networks.

Depending upon how you want to connect your OMNI-VII to another computer via

the Ethernet Interface, there are two types of cables that you can choose. If you

remember, for serial communications, you either pick a standard serial cable or a null-

modem serial cable. The same is true in principle for Ethernet connections. If you are

going to connect the OMNI-VII directly to a computer, then you will need to use a

“cross-over” Ethernet patch cable. If you are going to connect the OMNI-VII to a hub or

router or gateway, then you will need to use a “standard” Ethernet patch cable.

In either case, you can use either a CAT-5E (350Mhz) high-speed patch cord, or you

can use a CAT-6 Networking Cable. Either will satisfy the bandwidth requirements of the

OMNI-VII. They both follow EIA/TIA 568B Wiring, and are equipped with RJ-45

connectors.

Rev 1.009 OMNI-VII Programmer’s Reference Guide 9 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

The command set is extensive and every effort has been made to keep the individual

commands as simple as possible. Although the OMNI-VII Serial interface operates at

57,600 baud and the Ethernet interface operates at 10Mbps short commands are used to

keep the processing overhead to a minimum.

In general an OMNI-VII instruction is a series of ASCII characters which may be

followed by data and then terminated by a carriage return <CR>. Command characters

are case sensitive! In general, the query are identical to the set command except the

command is prefixed with a ‘?’ character.

The OMNI-VII interface requires that data be in a format compatible with each

command. Programmers should ensure that the supplied data is correct. For the Serial

interface, where a command is unrecognized or data is invalid the radio will send back a

response consisting of the letter ‘Z’ followed by the first character of the command string

that caused the error and finally, a carriage return <CR>. For the Ethernet Interface,

there is no invalid command reply. So it is a best practice if a command is sent, then the

associated query should also be used to verify the new setting.

Because the OMNI-VII is designed so that it could be reprogrammed in-system the

command set presented here is subject to change or enhancement. We will make every

effort to make the system backward compatible with existing documented commands

whenever possible. However, the OMNI-VII is a HF TRASNCEIVER PLATFORM that

could host a variety of radio services. Persons or companies developing control software

for the OMNI-VII should not assume that the radio is operating original factory firmware

but rather should always query the radio firmware revision to ensure compatibility.

There is one specialized query “?*” which is used to query all of the settings,

returned in one response, relevant to the operating mode of the radio. In the Radio Mode,

it will return all of the possible Radio Mode responses, and in Remote Mote, it will return

all possible Remote Mode responses. If performed over the serial port, then this will be a

series of properly formatted packets pertinent to each response. If performed over the

Ethernet then this will be one single Ethernet Packet whose data contains all of the

possible formatted packets pertinent to each response.

The OMNI-VII Command Set

Rev 1.009 OMNI-VII Programmer’s Reference Guide 10 of 63

OMNI-VII Firmware Updates at www.rfsquared.com

Command Set Format

Query Format

Set Note

Query return val

Radio

Mode

Remote

Mode

Set/Get

Main Freq *A<d3 d2 d1 d0> <CR>

?A <CR> d3..d0 4-byte binary

A<d3 d2 d1 d0> <CR> or

@Afnnnnnnnn <CR>

X X

ASCII

Method *A12345678<CR>

?A <CR> up to 8 ASCII #s

Get is 4 byte binary X

n.m

ASCII *An.m<CR>

?A <CR> n.m ascii => n.mMHz

Get is 4-byte binary X

Set/Get Sub

Freq *B<d3 d2 d1 d0><CR>

?B <CR> d3..d0 binary

A<d3 d2 d1 d0> <CR> X X

ASCII

Method *B12345678<CR>

?B <CR> up to 8 ASCII #s

Get is 4-byte binary X

n.m

ASCII *Bn.m<CR>

?B <CR> n.m ascii => n.mMHz

Get is 4-byte binary X

Set/Get

AGC Mode *GX<CR>

?G <CR> X=ASCII ‘0’.. ‘3’

AX <CR> X X

Set/Get

Squelch *H<d0><CR>

?H <CR> range = 0..0x7f

H<d0><CR> X X

Set/Get

RFGain *I<d0><CR>

?I <CR> range = 0..0x7f

I<d0><CR> X X

Set/Get

Attenuator *JX<CR>

?J <CR> X=ASCII ‘0’ .. ‘3’

JX <CR> X X

Set/Get NB,

NR, AN *K nb nr an <CR>

?K <CR> nb=0..7, nr=0..9, an=0..9

K nb nr an <CR> X X

Set/Get

RIT/XIT *L<d2><d1><d0><CR>

?L <CR> <d2>=0..3,<d1d0>=+-8192

L<d2><d1><d0><CR> X

Set/Get

MODE *M VFOA VFOB<CR>

?M <CR> VFOA/B=ASCII ‘0’ .. ‘6’

M VFOA VFOB <CR> X X

Set/Get Split

State *N <d0> <CR>

?N Range = 0..1

N <d0> <CR> X X

Set/Get

Passband

Tuning

*P <d1 d0> <CR>

?P <CR> d1 d0 = 2 byte binary

P <d1 d0> <CR> X X

Get Mode

Orion Form ?RMM <CR> @RMM <d0> <CR> X X

Set Transmit

On/Off *T <d1> <d0> <CR> d1, d0 = binary X X

Set/Get AF *U <d0> <CR>

?U <CR> Range = 0..0x7f

U<d0><CR> X X

OMNI-VII Command Set Quick List

Tabla de contenidos

Otros manuales de Radio de Ten-Tec

Ten-Tec

Ten-Tec RX-10 Manual del propietario

Ten-Tec

Ten-Tec Argonaut 505 Manual de usuario

Manuales populares de Radio de otras marcas

EisSound

EisSound KBSound iSelect Manual de usuario

Midland

Midland 1001LWX Manual de usuario

Konig

Konig HAV-SR41 Manual de usuario

Roberts

Roberts exprssion Manual de usuario

VDigi

VDigi DD3.0 Manual de usuario

Radio Shack

Radio Shack 21-1863 Manual de usuario

Roberts

Roberts Stream 207 Manual de usuario

Sony

Sony Walkman SRF-M97 Manual de usuario

Stanley

Stanley FatMax FMC770 Manual de usuario

auna

auna DAB-Radio 10026947 Manual de usuario

SOUNDMASTER

SOUNDMASTER UR190 Manual de usuario

HYT

HYT TC-320 Manual de usuario

auna multimedia

auna multimedia Yellowstone 10026851 Manual de usuario

B-Tech

B-Tech GMRS-V2 Manual de usuario

Weierwei

Weierwei VEV-V8 Manual de usuario

SOUNDMASTER

SOUNDMASTER DAB750 Manual de usuario

Telefunken

Telefunken TF-1505 Manual de usuario

Makita

Makita LXRM03 Manual de usuario