ADCON T E L E M E T R Y addIT A720/A723 Series User Guide SMART WIRELESS SOLUTIONS
ADCON T E L E M E T R Y ADCON TELEMETRY GMBH INKUSTRASSE 24 A-3400 KLOSTERNEUBURG A U S T R I A TEL: +43 (2243) 38 280-0 FAX: +43 (2243) 38 280-6 http://www.adcon.at Proprietary Notice: The Adcon logo, the A720 and A730 series, addIT™, the A840 series, addVANTAGE®, addVANTAGE Lite and addVANTAGE Pro are trademarks or registered trademarks of Adcon Telemetry. All other registered names used throughout this publication are trademarks of their respective owners.
Contents Contents ______________________________________________ 3 Chapter 1. Introduction _________________________________ 5 What are addIT devices? _________________________________ 5 Installation issues _______________________________________ 6 Conventions____________________________________________ 7 Chapter 2.
Contents Installing the RTU _____________________________________ 14 More about the LED tool ____________________________ 16 Configuring an addIT RTU in the addVANTAGE software 17 Maintaining and servicing the RTU_______________________ 17 The RTU battery ____________________________________ 17 Changing the battery _______________________________ 18 Chapter 4.
Chapter 1. Introduction This manual explains the hardware aspects of Adcon’s addIT™ A72xx series, including installation issues and certain parameter configurations. The manual is divided into these chapters: • • • • "Introduction," which gives some general information and document conventions. "Using the Base Station," which details the installation and use of the receiving unit. "Using the RTU," which details the installation and use of the remote telemetry unit.
CHAPTER 1 Introduction The addIT A720/A723 RTU can be used in one of the following ways: • • Installed in the vicinity of an Adcon remote measuring station (A730MD), the addIT RTU can use the A730MD station to relay its data to a base station (A730SD or A840). If the base station is close enough to the addIT RTU, the RTU can communicate directly with the base station. As a standalone device, the addIT RTU communicates directly with the addIT base station (A720B).
CHAPTER 1 Conventions • A730MD remote station, but they cannot communicate with each other. All addIT devices accept the standard Adcon sensors; however, the connectors are different. Waterproof connectors are used to provide IP65 class protection. All new sensors will be delivered with this new connector. A special adapter will be supplied to connect new sensors to RJ-12 ports of the A730MD stations. Note: For technical reasons, Adcon cannot provide adapters for the RJ-12 connector to the addIT devices.
CHAPTER 1 Introduction
Chapter 2. Using the Base Station Your addIT base station consists of the receiver (A720B), the power supply (A720PS), and addVANTAGE Lite software. Note: If you are using the addIT RTU as part of an A730 system, this chapter does not apply to you. For information about the addIT RTU, see “Using the RTU” on page 13. For information about installing an A730 base station, refer to the addVANTAGE A730 User Guide or the addVANTAGE A730 Releases Notes for Version 3.35.
CHAPTER 2 Using the Base Station Make sure you’ve received all the equipment and read through the instructions that follow. When you’re sure you understand them, you’re ready to install your base station. Installing the base station The following considerations are important to installation: • • • • From a radio perspective, the height of the receiving antenna is essential—the higher the antenna, the greater the communication range.
CHAPTER 2 Installing the base station Follow these steps to install the receiver part of the base station. 1. 2. 3. Locate the best site for the receiver and mount a rod on the spot. The best site is usually on top of a roof or a mast. Using the provided ring clamps, attach the receiver to the rod. Attach the female connector on the cable to the male connector on the receiver by turning the plug’s fastening screw. Note: Standard cables are 30 m (approx. 99 ft) long.
CHAPTER 2 Using the Base Station Note: The serial cable ends are identical, so it doesn’t matter which you use in each location. 3. Plug the appropriate ends of the power cord into the power supply and the power source (outlet). Figure 3 shows the base station configuration. Figure 3. Base Station Configuration Replacing 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.
Chapter 3. Using the RTU Remember that the addIT A720/A723 remote telemetry units (RTUs) can be used either with the A730 system or as standalone systems with the A720B base station. The base station is discussed in “Using the Base Station” on page 9. Opening the packages You get several boxes when you purchase an addIT RTU.
CHAPTER 3 Using the RTU Figure 4 shows an addIT RTU. PROTECTIV E CAP TO SOLAR PANEL SERIAL NUMBER TO SENSORS Figure 4. addIT RTU Installing the RTU Installing addIT RTUs in the field is a fairly simple process. You’ll perform a connectivity check with an LED tool (addIT devices don’t have a built-in LED like the A730MD stations do). Note: The LED tool is a blind plug to be plugged in the POWER connector. Follow these steps to install an addIT RTU in the field: 1. 2. 3.
CHAPTER 3 Installing the RTU 4. on your application. Put a plastic cap on top of the rod to protect it. Using a ring clamp, fasten the solar panel onto the aluminum rod. Ensure that the panel is facing south (north if you are located in the southern hemisphere) and out of the way of the addIT RTU. Note: The solar panel can be mounted under or behind the addIT RTU, but be sure that the RTU does not shadow the panel. 5. 6. Fasten the addIT RTU to the top of the rod using another ring clamp.
CHAPTER 3 Using the RTU This completes the installation of your addIT RTU. If one of the I/O connectors is left unused, use the cap specially provided to protect it against moisture and dust. Be sure to make a note of the following information because you’ll need it when you configure the device in the software: • • Serial number for each RTU Type of sensors connected to each RTU More about the LED tool The LED tool allows you to rapidly check the status of an addIT RTU.
CHAPTER 3 Maintaining and servicing the RTU be fully charged after two consecutive sunny days, but you should get an LED light-up after several minutes of charging in the sunlight. Configuring an addIT RTU in the addVANTAGE software If you’re using an addIT RTU with an A730 system, you can configure the RTU by following the steps described in the addVANTAGE A730 Releases Notes for Version 3.35 or in the addVANTAGE 3.40 User Manual.
CHAPTER 3 Using the RTU Table 1 shows the addIT devices’ expected operation time on a fully charged battery with 50 mA total consumption for the sensors, as described above. Table 1.
CHAPTER 3 Maintaining and servicing the RTU If you have verified that the battery needs to be replaced, follow these steps to do so: 1. Open the lid by unscrewing the four screws in the corner of the addIT RTU. 2. Gently remove the lid (the battery is fixed on the lid and is connected to the electronics board 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).
CHAPTER 3 Using the RTU
Chapter 4. Performing Advanced Functions With the appropriate knowledge, you can configure the addIT devices in the field by using a hyperterminal window. To configure the RTU, you will need a special serial cable adapter (not supplied, available from Adcon). CAUTION Do not try to configure your addIT devices if you are not sure what to do—the unit may not communicate with the remote measuring station or function with the addVANTAGE software.
CHAPTER 4 Performing Advanced Functions Device series Currently, two A720 device versions are in use: Series 1 and Series 2. in addition, since begin of 2001, Adcon introduced also the Series 3 model (A723). You can determine which series a device is in any of these ways: • • The VER command (see pages 29 and 52). When the device is connected, you can type this command to the series. With a Series 1 device, the command returns VER 1.0 or higher, while with a Series 2 device, the return is VER 2.
CHAPTER 4 Understanding connectors Table 2. addIT Receiver Pin Functions 1 Bus Power (V+) 2 Bus Power (GND) 3 Bus Communications (B) 4 Bus Communications (A) The RTU connectors The addIT RTU uses standard 7-pin sensor I/O A and I/O B connectors (model Binder 702 and 712 series or equivalent) that are identical. Each connector contains three analog inputs (0 to 2.5 volt) and two digital input/outputs, one of which you can use as a pulse counter (for example, a rain gauge).
CHAPTER 4 Performing Advanced Functions The RTU also has a POWER connector. Figure 8 illustrates the connections available at the POWER connector. Ext Power 5 RxD 1 4 2 3 TxD Battery Ground Figure 8. addIT RTU POWER Connector (Top View) WARNING The RxD and TxD connections are not RS-232 compatible. This configuration allows the use of external power supplies or extra batteries (contact Adcon for further details).
CHAPTER 4 Serial communication protocol Serial communication protocol This protocol is based on a master sending commands and a node answering; the whole communication is conducted in plain ASCII, as strings. When exchanging numbers, they are represented in decimal format. All commands are terminated with a CR/LF combination. All responses (answers) are terminated with the # character. General format of a command The commands have the following format: ID Command Param1 Param2 ...
CHAPTER 4 Performing Advanced Functions • • • Command is the string representing the original command. It is supplied so that a master can distinguish between the answers it is waiting for, and out-of-band notifications (which may come, for example, over the radio port of a node). As with the ID, the command name must be always supplied. Result1 Result2 ... ResultN are the result values returned by the remote node.
CHAPTER 4 Using terminal commands EXAMPLE SET OWNID 2003 COMMAND SET PMP bl bh DESCRIPTION Sets the power management parameters. PARAMETERS bl is the lower battery level (the threshold where the charging of the battery is switched on) and bh is the higher battery level (the charging is switched off). RETURNS Nothing. REMARKS Both bl and bh are expressed in volts X 10 (for example, 72 actually means 7.2 V). Default values (factory programmed) are 65 and 72, meaning 6.5 and 7.2 volts respectively.
CHAPTER 4 Performing Advanced Functions WARNING Changing the above parameters may adversely affect the ability of the device to operate for extended periods under low solar radiation conditions when used with addVANTAGE 3.x. Even if you change them, addVANTAGE will not display the charts accordingly: the current addVANTAGE version supports only 15minute data slots. Changing the storage parameter to lower than 60 or higher than 1500 will lead to a total data loss in addVANTAGE 3.x.
CHAPTER 4 Using terminal commands EXAMPLE To set the RSSI threshold to 58: SET RSSI 58 Querying the actual configuration parameters You can query an addIT to find out its actual configuration parameters (GET the parameter). Typing OWNID, for instance returns the actual ID an addIT answers to (it should be the same as the one on its label). In addition to OWNID, PMP, SLOT, FREQ, and RSSI, the command VER returns the current software version of the device.
CHAPTER 4 Performing Advanced Functions • B – sends a broadcast frame and displays all the answers. Series 2 and 3 devices Note: With Series 2 and 3 devices, typing the command by itself is a GET command, while typing the command with parameters or variables is a SET command. COMMAND CMDS APPLIES TO A720, A720B, A723 DESCRIPTION Returns a list of supported commands. PARAMETERS None. REMARKS GET only. RETURNS A list of strings separated by spaces. REMOTE No.
CHAPTER 4 Using terminal commands COMMAND FREQ CAUTION Do not change the frequency of your device without reason. Apart from the fact that it may not communicate with the network anymore, you may also violate the applicable radiocommunications laws in your country. Depending on the destination country, some models may also return an error message when trying to use this command. APPLIES TO A720, A720B, A723 DESCRIPTION Sets/returns the operating frequency.
CHAPTER 4 Performing Advanced Functions REMOTE No. EXAMPLE RSSI 58 193 RSSI 0 # RSSI 193 RSSI 44 58 0 # COMMAND ID APPLIES TO A720, A720B, A723 DESCRIPTION Sets/returns the node’s ID. PARAMETERS The node ID. RETURNS The node ID. REMARKS GET/SET. REMOTE Yes, 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.
CHAPTER 4 Using terminal commands APPLIES TO A720, A720B, A723 DESCRIPTION Sets/returns the input storing and sampling intervals. PARAMETERS storage represents the time (in seconds) elapsed between two slots stored in the internal memory, while samples represents the numbers of samples used to build the average that will be stored. RETURNS The interval and rate. REMARKS The default storage is 900 (15 minutes) and samples is 3 (3 samples per quarter of an hour). REMOTE Yes, SET only.
CHAPTER 4 Performing Advanced Functions PMP 193 PMP 65 72 0 # COMMAND CM APPLIES TO A723 DESCRIPTION Sets/returns the A720 compatibility mode. PARAMETERS 0 means A723 native mode while 1 switches the unit in A720 compatible mode. In this mode, although the device presents itself as an A723 (when issuing the INFO command), it will return the frame type 38 when asked for DATA (see also “DATA” on page 36).
CHAPTER 4 Using terminal commands RETURNS The actual sensor settling time (default is 2 seconds). REMARKS GET/SET. REMOTE No. EXAMPLE SST 2 193 sst 0 # SST 193 sst 2 0 # COMMAND DEV APPLIES TO A720B DESCRIPTION Inserts/reads the devices in the local devices list. PARAMETER The device to be inserted (in the SET version). RETURNS The devices list (in the GET version).
CHAPTER 4 Performing Advanced Functions PARAMETERS The old ID and the new ID. RETURNS Nothing. REMARKS SET only. REMOTE No. EXAMPLE REPL 5667 5666 193 REPL 0 # REPL 193 REPL 5 # Note: The second example shows a REPL command without 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 Nothing. REMARKS SET only. REMOTE No.
CHAPTER 4 Using terminal commands DESCRIPTION Returns data stored for a certain device. PARAMETER The ID of the device for which the data is requested and the date/ time (in the standard format) the data was stored. If missing, then it refers to the data of the local device. RETURNS A data block. REMARKS GET only. If you don’t include the date/time parameter, the latest data is returned.
CHAPTER 4 Performing Advanced Functions between the frames 38 and 39 is that the later accomodates for 12 bit analog values for the sensor sampling inputs and 16 bit counters for the pulse counter inputs. In addition, the correspondence between input analog and digital ports and their position in the frame differs. The composition of the data block of a frame type 38 (the bytes marked as d1, d2...
CHAPTER 4 Using terminal commands RF incoming RF outgoing Digibyte Pulse Counter I/O A Pulse Counter I/O B Battery D1 D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 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 Cabling 3 I/O B Figure 10. Frame 39 description b7 SC b0 Res U U Res Res Dig A Dig B SC — Battery charge (0–off, 1–on) Dig A — Digital I/O A Res — Reserved Dig B — Digital I/O B U — Undefined Figure 11.
CHAPTER 4 Performing Advanced Functions 30 4 1999 14 54 55 14 38 255 255 77 0 0 89 156 126 20 0 0 0 0 3185 0 # Notice that if you need to get data that is not the last (newest) slot remotely from a device, the ID must be supplied twice. If you need to get the last slot stored, you can ignore the ID and the date/time parameters: 8300 8300 13 5 15 0 3138 DATA DATA 1999 19 26 36 14 38 255 255 79 0 0 87 148 149 0 0 0 0 COMMAND IMME APPLIES TO A723 DESCRIPTION Returns immediate data.
CHAPTER 4 Using terminal commands PARAMETERS The destination node and the intermediate nodes, on the order starting from the issuing node to the traget (remote) node. RETURNS The actual routing table (in GET mode). REMARKS GET/SET. REMOTE No. EXAMPLE ROUTE 2419 10836 16816 ROUTE 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.
CHAPTER 4 Performing Advanced Functions ID INFO rf_in rf_out date time ver clk stack cop batt temp days_uptime min:sec_uptime rssi pmp_low pmp_high type slot samples po err_level # The formats for the above parameters are as follows: • • • • • • • rf_in and rf_out as a decimal date as dd/mm/yyyy time as hh:mm:ss ver as x.
CHAPTER 4 Using terminal commands • • • — 4 for A733 — 5 for A723 — 6 for A440 slot and samples are the actual values programmed by means of the SLOT command po (A723 only) is the relative output power err_level is the error value; 0 means no error REMARKS GET only. REMOTE Yes, GET only. The A720B and A723 can issue the command both remotely and locally, while the A720 can issue the command only locally. EXAMPLE INFO 193 INFO 255 0 18/4/1999 21:5:11 1.
CHAPTER 4 Performing Advanced Functions • The Command Code specifies the operation that will be applied to the selected channel. They are described in the table below: Table 3. Command Code Definitions for the Analog Command Code Description Parameters Returns 0000 RSM – Read Sampling Method. This command reads the current programmed sampling method for all analog input channels. None. The current sampling methods and the result (OK or ERROR). See also the table that follows.
CHAPTER 4 Using terminal commands Table 3. Command Code Definitions for the Analog Command Code Description Parameters Returns 1100 ENOPTR – Enable Notify On Positive Threshold Reached. The channel number and the threshold (16 bit value). Result (OK or ERROR). 1101 ENONTR – Enable Notify On Negative Threshold Reached. The channel number and the threshold (16 bit value). Result (OK or ERROR). ENOL – Enable Notify if Out of Limits.
CHAPTER 4 Performing Advanced Functions Following notification types can be returned when issuing the RNTTL command: Value Notification Type 00 Notify On Positive Threshold. 01 Notify On Negative Threshold. 10 Notify if Out of Limits. 11 Notify if Inside the Limits. RETURNS The return result depends on the control byte (see table). However, whatever the return result is, it includes the control byte.
CHAPTER 4 Using terminal commands APPLIES TO A720B and A723, but see also the comments in “Remote” on page 49. DESCRIPTION A complex command acting upon the I/O ports of a device. PARAMETERS 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.
CHAPTER 4 Performing Advanced Functions Table 5. Command Code Definitions (Continued) Code Description Parameters The port number. Returns 0100 RBV – Read the specified bit. Bit value and the result (OK or ERROR). 0101 RNS – Read the notificationa status. If no notifi- The port number. cation was pending, this command should return an error. If one was pending, the notification is cleared. Returns the time of the last port change in standard time format and the result (OK or ERROR).
CHAPTER 4 Using terminal commands a. See also “Notifications” on page 53. RETURNS The return result depends on the control byte. However, whatever the return result is, it includes the control byte. REMARKS The general behavior is that a PORT command issued on a certain port bit will override any previous PORT commands. For example, if a port was configured as input and then an MFR (monostable function) was issued, the port automatically switches to output.
CHAPTER 4 Performing Advanced Functions For RNS: 6789 PORT 80 6789 PORT 7/5/1999 18:34:22 0 # COMMAND RX APPLIES TO A720, A720B, A723 DESCRIPTION Switches the unit to permanent receive mode (for tuning purposes). PARAMETERS None. RETURNS Nothing. REMARKS The system stops, and exits the command only when you press a key. This command returns no message. REMOTE No.
CHAPTER 4 Using terminal commands TX 1 193 TX 0 # TX 5 193 TX 0 # COMMAND B APPLIES TO A720, A723 DESCRIPTION Sends a broadcast frame. PARAMETERS None. RETURNS A data block. REMARKS After the device sends the broadcast frame, it will listen for answers. All valid answers will be listed with 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).
CHAPTER 4 Performing Advanced Functions REMOTE Yes (the remote must support this function). EXAMPLE BLST 6789 BLST 30/8/2001 16:03:41 4 15190 255 255 2419 255 201 10836 247 187 10805 255 187 0 # 15190 BLST 15190 BLST 30/8/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. RETURNS The current version. REMARKS GET only. REMOTE No.
CHAPTER 4 Notifications unit it is communicating with. After detecting that the device supports this protocol, the INFO command must be used for further details. Notifications Notifications are frames sent asynchronously by devices that are otherwise slaves. The notifications are received by a device closest to the host and then sent to the host. If the host is not available, the receiving device will store the notification and wait until it is questioned by the host.
CHAPTER 4 Performing Advanced Functions Returned errors list Following are error messages you might get.
CHAPTER 4 Returned errors list • 36 — receiver busy (for example, just making the request round) • 40 — request to read a notification when no notification is pending Notifications 55
CHAPTER 4 Performing Advanced Functions
Appendix. Specifications The A720 series was intended to fulfill the specification of the ETSI 300 220, Class I, Subclasses a and b, but other national norms are similar to this (for example, the CFR 47, Part 90, Subpart J). Table 6 shows the main operational parameters of the A720 series. Table 6. Operational Parameters Parameter Min Typ Max Unit Common Supply 5.0 Operating Temperature Relative Humidity 10.0 V -30 +70 °C 10 99 % 2000 bps Class Protection 6.
Table 6. Operational Parameters (Continued) Parameter Min Typ Max Unit Receiver Sensitivity (10 db S/N) Image Frequency Attenuation (1st IF = 45 MHz) -93 (A720) -105(A723) dBm 35 dB Local Oscillator Leakage 2 nW Adjacent Channel Attenuation (both versions) 55 dB RSSI Dynamic 90 dB 15 mA 10 dBm Spurious Radiation (0 to 862 MHz) 2 nW Spurious Radiation (862 MHz to 3.5 GHz) 200 nW Adjacent Channel Power (12.
CHAPTER a. Data rate is content dependent. 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 are the same as for the Digital Inputs.
CHAPTER
Index A BLST, 51 A720 description, 5 A720B description, 5 about the LED, 16 ANLG, 43 answer format, 25 C B B series 1, 30 series 2, 51 base station composition, 9 graphic, 12 installation issues, 10 packaging, 9 battery changing, 19 description, 17 operation, 18 changing the battery, 19 CMDS, 30 command ANLG, 43 B series 1, 30 series 2, 51 BLST, 51 CMDS, 30 DATA, 36 DEL, 36 DEV, 35 DUMP, 29 FDEV, 41 format, 25 FREQ series 1, 28 series 2, 31 ID, 32 IMME, 40
INDEX INFO, 41 OWNID, 26 PMP series 1, 27 series 2, 33 PORT, 46 query parameters, 29 REPL, 35 ROUTE, 40 RSSI series 1, 28 series 2, 31 RX series 1, 29 series 2, 50 SLOT series 1, 27 series 2, 32 SST, 34 TIME, 30 TX, 50 VER series 1, 29 series 2, 52 XMIT, 29 command line interpreter errors, 54 configuring addIT RTU in addVANTAGE software, 17 addVANTAGE Lite software, 12 devices, 24 connectivity check, 14 connector definition, 22 receiver, 22 RTU, 23 conventions, document, 7 descriptors and storage hand
INDEX M maintaining the RTU, 17 N NOPC, 53 notification definition, 53 NOPC, 53 O overview, 5 OWNID, 26 P packaging base station, 9 RTU, 13 performing a connectivity check, 14 placing a base station, 10 PMP series 1, 27 series 2, 33 PORT, 46 power supply graphic, 11 installing, 11–12 Q querying command parameters, 29 R radio interface errors, 54 real time clock errors, 54 receiver connector, 22 graphic, 10 installing, 11 remote transmission unit.
INDEX W what a base station contains, 9 X XMIT, 29
Credits and Colophon Credits Development Günther Leber, Lix N. Paulian, Florin Wacykiewcz, Matthias Wallner. Documentation and artwork Dimi Everette, Stefan Hasegan, Lix N. Paulian. Quality control and testing Steve Grove, 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 prepared in Adobe Illustrator and Adobe Photoshop on a Power Macintosh.
