background image

CHAPTER 4

Using terminal commands

47

APPLIES

 

TO

A720B and A723, but see also the comments in “Remote” on 
page 49.

D

ESCRIPTION

A complex command acting upon the I/O ports of a device. 

P

ARAMETERS

A control byte specifying the command, the bit of the port the 
command is acting on, and two 16-bit parameters, depending on 
the control byte; for some commands, one or both of them may be 
missing. However, if they are needed for a certain command but 
not given, null values are implied.

The control byte’s significance is shown in Figure 14.

Figure 14.  Control Byte Layout

The 

Port Number

 selects a the port that will be affected by 

the command. For the A720/A723, only 0000 and 0001 are 
accepted.

The 

Command Code

 specifies the operation that will be 

applied to the selected port.

Table 5 shows the command codes definitions.

Command Code

Port Number

Table 5.  Command Code Definitions 

Code

Description

Parameters

Returns

0000

RDP – Read Data Port. This command reads the 
whole 16-bit port and returns its value; the Port 
Number has no significance for this command.

None

A 16-bit integer and the 
result (OK or ERROR).

0001

RDDR – Read Data Direction Register. This com-
mand reads the whole 16-bit Data Direction 
Register and returns its value; the Port Number 
has no significance for this command.

None

A 16-bit integer and the 
result (OK or ERROR).

0010

CAI – Configure the port specified by Port Num-
ber as input (acts upon the Data Direction Regis-
ter).

The port number.

Result (OK or ERROR).

0011

CAO – Configure the port specified by Port 
Number as output (acts upon the Data Direction 
Register).

The port number.

Result (OK or ERROR).

Содержание addIT A720 Series

Страница 1: ...ADCON T E L E M E T R Y addIT A720 A723 Series User Guide SMART WIRELESS SOLUTIONS...

Страница 2: ...publication are trademarks of their respective owners Neither the whole nor any part of the information contained in this publication may be repro duced in any material form except with the prior writ...

Страница 3: ...2 Using the Base Station _______________________9 Opening the packages___________________________________ 9 Installing the base station _______________________________10 Installing the receiver ______...

Страница 4: ...l format of a command _______________________ 25 General format of an answer _________________________ 25 Using terminal commands ______________________________ 26 Series 1 devices ___________________...

Страница 5: ...details the installation and use of the remote telemetry unit Performing Advanced Functions which discusses technical information for the advanced user What are addIT devices Adcon s addIT devices A7...

Страница 6: ...he RTU is mounted on a 30 cm mast 1 ft the results may vary under different conditions As with all wireless communication devices the higher the transmitter is the better the communication will be Mou...

Страница 7: ...ated in the explanation Italics can also be used to emphasize words as words or letters as letters Bold Indicates special emphasis of the text Also indicates menu names and items in a window fixed fon...

Страница 8: ...CHAPTER 1 Introduction 8...

Страница 9: ...g the RTU on page 13 For infor mation about installing an A730 base station refer to the addVANTAGE A730 User Guide or the addVANTAGE A730 Releases Notes for Version 3 35 Opening the packages You get...

Страница 10: ...gh as possible A roof is an ideal location Put the base station in the location most convenient to where you work but keep in mind that geographically it is better to have it in the center of the area...

Страница 11: ...to extend the length up to 500 m 1640 ft 4 Secure the cable to the rod with ties 5 Bring the unattached end of the cable into the area where your computer is Installing the power supply The A720PS pow...

Страница 12: ...lacing the fuse Should you need to replace the fuse simply remove the old fuse from the power supply and insert a new 250 mA 250 V fuse Configuring the software This manual details hardware installati...

Страница 13: ...ges You get several boxes when you purchase an addIT RTU When you open them you ll see they contain The A720 A723 RTU and ring clamp The solar panel ring clamp and connecting cable The aluminum rod an...

Страница 14: ...installation area and choose the best site 2 Perform a connectivity check using the LED tool a Insert the LED tool in the POWER connector and wait up to 10 seconds If the unit connects to at least on...

Страница 15: ...s not shadow the panel 5 Fasten the addIT RTU to the top of the rod using another ring clamp Adcon recommends that you perform another connectivity test if you can to check the positioning of the devi...

Страница 16: ...rame only remote stations A730MD and base stations A730SD or A720B In addition the LED always blinks briefly at 0 5 second intervals to indicate that the unit is alive and the internal battery has eno...

Страница 17: ...iquids They conform to the European protec tion class IP65 This applies also to the connectors as long as they are mated Don t let unmated connectors on either the addIT RTU or the sensors be exposed...

Страница 18: ...to a defective or dirty solar panel Note The solar panel works only with the A720 A723 devices The A720B receiver s internal battery is charged by the power supply Adcon highly recommends that you che...

Страница 19: ...d by means of a connector 3 Remove the battery s plug from the PCB connector 4 Remove the battery pack from the lid it is taped to the lid and replace it with a new one obtainable from Adcon 5 Insert...

Страница 20: ...CHAPTER 3 Using the RTU 20...

Страница 21: ...not communicate with the remote measuring station or function with the addVANTAGE software WARNING Tampering with parameters for the addIT devices may void your warranty or damage the device In gener...

Страница 22: ...een A720 and A723 devices type the command TYPE and an A723 will return the string TYPE A723 The logo on the front of the device Series 2 devices include such wording on the logo However if you return...

Страница 23: ...ing conflicts first verify in the addVANTAGE software that the sensor combination in the configuration you want is allowed If there are no conflicts you can physically attach the sensors to the addIT...

Страница 24: ...to either addIT device After you have installed the system follow these steps to configure the device Note To configure the A720B receiver use the serial cable that comes with the system To configure...

Страница 25: ...command is addressed locally Note Not all the commands can be relayed remotely Command is the command proper which can be composed of a variable string of characters for example SLOT Each node can imp...

Страница 26: ...alue is other than 0 the command failed The number may further indicate the error type See also Returned errors list on page 54 The answer string may contain any number of spaces or CR LF characters b...

Страница 27: ...MPLE To change the switch on threshold to 6 3 and the switch off thresh old to 7 0 volts SET PMP 63 70 COMMAND SET SLOT storage samples DESCRIPTION Configures the input sampling and storing intervals...

Страница 28: ...MARKS Convert values to Herz before issuing the command EXAMPLE To change the frequency to 467 1125 MHz with a channel spacing of 12 5 kHz SET FREQ 467112500 12500 CAUTION Do not change the frequency...

Страница 29: ...d value something must be wrong or the channel is very noisy however before readjusting the RSSI threshold check this with a handheld radio receiver or a scanner Other commands available in terminal m...

Страница 30: ...ESCRIPTION Returns a list of supported commands PARAMETERS None REMARKS GET only RETURNS A list of strings separated by spaces REMOTE No EXAMPLE CMDS 193 CMDS CMDS ID PMP RSSI TIME FREQ DEV DEL REPL S...

Страница 31: ...REMOTE Yes SET only EXAMPLE FREQ 433925000 25000 193 FREQ 0 FREQ 193 FREQ 433925000 25000 0 COMMAND RSSI APPLIES TO A720 A720B A723 DESCRIPTION Sets returns the Relative Signal Strength Indicator thr...

Страница 32: ...s SET only EXAMPLE ID 4557 193 ID 0 ID 4557 ID 4557 0 6556 ID 7557 6556 ID 0 Note The last example shows a case where a remote node was instructed to change its own ID from 6556 to 7557 Even if it cha...

Страница 33: ...EMOTE Yes SET only EXAMPLE SLOT 900 3 193 SLOT 0 SLOT 193 SLOT 900 3 0 Note The A720B base station needs only the rate For consis tency however it accepts both parameters and discards the one it doesn...

Страница 34: ...base station or with an addVANTAGE 3 35 software addVANTAGE 3 4 and later recognizes an A723 in its native mode There is also an additional compatibility mode CM 2 that forces the A723 to respond with...

Страница 35: ...rsion RETURNS The devices list in the GET version The GET version displays additional information about the devices such as the last slot in the local memory and a flag showing whether a notification...

Страница 36: ...t parameter error 5 is returned missing or false parameter COMMAND DEL APPLIES TO A720B DESCRIPTION Deletes a device from the local devices list PARAMETERS The ID of the device to be deleted RETURNS N...

Страница 37: ...t you cannot issue the command for the A720B receiver In other words the base station can issue a remote com mand for an RTU but it cannot issue such a command for itself The A720 RTU can issue the co...

Страница 38: ...ir position in the frame differs The composition of the data block of a frame type 38 the bytes marked as d1 d2 dn is depicted in Figure 9 a type 39 frame in Figure 10 while the digibyte is depicted i...

Страница 39: ...2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 RF incoming RF outgoing Digibyte Pulse Counter I O A Pulse Counter I O B Battery Cabling 1 I O A Cabling 2 I O A Cabling 3 I O A Cabling 1 I O B Cabling 2 I O B Cabl...

Страница 40: ...148 149 15 0 0 0 0 3138 0 COMMAND IMME APPLIES TO A723 DESCRIPTION Returns immediate data PARAMETERS None RETURNS A formatted string representing the data sampled on the input ports REMARKS GET only T...

Страница 41: ...0 ROUTE 16816 ROUTE 2419 10836 0 COMMAND FDEV APPLIES TO A720 A720B A723 DESCRIPTION Formats the internal memory destroys all the data PARAMETERS None RETURNS Nothing REMARKS SET only REMOTE Yes SET...

Страница 42: ...y level using the standard voltage conversion equation 0 is 0 volts 255 is 20 volts temp as internal temperature in the A720 housing which is device dependent The precision of the sensing element is v...

Страница 43: ...40 1 46 58 65 72 3 900 0 0 COMMAND ANLG APPLIES TO A723 DESCRIPTION Sets returns various parameters of the analog subsystem e g the sampling averaging method used for individual data aquisition channe...

Страница 44: ...ampling Method to Circular Average The specified analog channel will be instructed to store the circular average of all sampled values The channel number Result OK or ERROR 0110 SSMF Set Sampling Meth...

Страница 45: ...mmand Code Description Parameters Returns Table 4 Sampling Method Definitions Sampling method Binary value Description Reserved 000 Not defined Minimum 001 If more than one sample per slot is performe...

Страница 46: ...ny previous ANLG commands affecting that channel REMOTE The A723 device cannot issue ANLG commands remotely but can execute them EXAMPLE For RSM ANLG 0 9999 ANLG 0 5 5 5 5 5 5 5 5 4 4 5 5 0 For SSMAA...

Страница 47: ...specifies the operation that will be applied to the selected port Table 5 shows the command codes definitions Command Code Port Number Table 5 Command Code Definitions Code Description Parameters Ret...

Страница 48: ...NE register and the result OK or ERROR 1001 CB Clear the specified bit The port number Result OK or ERROR 1010 SB Set the specified bit The port number Result OK or ERROR 1011 XB Exclusive Or the spec...

Страница 49: ...REMOTE Yes for the A720 and A723 If you are using a terminal window for the A720 you cannot issue the PORT command If you are using a terminal window for the A720B you can issue a PORT command remote...

Страница 50: ...en you press a key This command returns no message REMOTE No EXAMPLE RX 193 RX 0 COMMAND TX APPLIES TO A720 A720B A723 DESCRIPTION Switches the unit to transmit mode for tuning purposes PARAMETERS Non...

Страница 51: ...th their IDs REMOTE Yes but only for the A723 A remote broadcast command instructs the remote to issue a broadcast the remote must support this function A subsequent BLST command retrieves a list of s...

Страница 52: ...2001 16 03 41 6 15193 255 0 7852 255 0 14640 255 0 2419 255 0 9476 255 0 10836 255 0 0 COMMAND VER APPLIES TO A720 A720B A723 DESCRIPTION Requests the firmware version of the device PARAMETERS None R...

Страница 53: ...re the date time when the notification took place As soon as the communication is re established the device will try to send the notification again Note To avoid collisions the device will wait a rand...

Страница 54: ...n a nonexistent device 11 device already exists 12 reserved 13 no more space for descriptors too many devices 14 no more records for the specified device 15 temporary communication break no more data...

Страница 55: ...CHAPTER 4 Returned errors list 55 36 receiver busy for example just making the request round Notifications 40 request to read a notification when no notification is pending...

Страница 56: ...CHAPTER 4 Performing Advanced Functions 56...

Страница 57: ...rational parameters of the A720 series Table 6 Operational Parameters Parameter Min Typ Max Unit Common Supply 5 0 6 2 10 0 V Operating Temperature 30 70 C Relative Humidity 10 99 Class Protection IP6...

Страница 58: ...nW Adjacent Channel Power 12 5 kHz version 32 dBm Adjacent Channel Power 25 kHz version 44 dBm Occupied Bandwidth 12 5 kHz version 8 5 kHz Occupied Bandwidth 25 kHz version 15 kHz Operating Current i...

Страница 59: ...ndent b This parameter represents the tuning range the switching range may be limited in the software to a narrower space even to the extent of a single channel c Continuous duty d Electrical levels a...

Страница 60: ...CHAPTER 60...

Страница 61: ...51 base station composition 9 graphic 12 installation issues 10 packaging 9 battery changing 19 description 17 operation 18 BLST 51 C changing the battery 19 CMDS 30 command ANLG 43 B series 1 30 ser...

Страница 62: ...14 connector definition 22 receiver 22 RTU 23 conventions document 7 D DATA 36 DEL 36 DEV 35 device configuration 24 descriptors and storage handler errors 54 determining version 22 operation time 18...

Страница 63: ...io interface errors 54 real time clock errors 54 receiver connector 22 graphic 10 installing 11 remote transmission unit See RTU REPL 35 restrictions for installation 6 ROUTE 40 RSSI series 1 28 serie...

Страница 64: ...INDEX 64 W what a base station contains 9 X XMIT 29...

Страница 65: ...rove Martin Hackl Bernd Hartmann G nther Leber Lix N Paulian Matthias Wallner Colophon This manual was written and produced with Adobe FrameMaker on the MacOS platform The illustrations were done or p...

Страница 66: ...66...

Отзывы: