background image

3. Configuration

3.1 Interface overview

AQT530 has a command line interface (CLI) and a Modbus interface.

• Modbus interface configuration is done over the CLI interface.
• All measurement values are available from both CLI and Modbus.
• Linear correction can be done over both CLI and Modbus interface.
• Some read-only parameters are available only in CLI interface.

In addition, AQT530 outputs data over the Modbus interface or in ASCII CSV format over the
RS-485 interface.
The CLI interface is for a local connection over RS-232.
The Modbus interface is an application programming interface (API) for remote connection
to AQT530 using the Modbus protocol.

More information

Overview of CLI commands and parameters (page 28)

Modbus register addresses for AQT530 (page 45)

ASCII CSV data message (page 22)

3.2 Configuration overview

You can do the operations listed in the following table using a local connection with CLI
commands and/or remotely over the Modbus interface.

Table 4 Overview of configuration operations

Action

CLI command and
parameter

CLI reference

Modbus register
addresses

View measurement data

meas

Printing measurements
and changing

measurement output unit
( meas command)
(page 32)

• 0x0000 ... 0x000C

(gas values in ppb with

linear correction)

• 0x0066 ... 0x006B

(gas values in ug/m

3

)

• 0x006C ... 0x0075

(gas values in ppb
without linear
correction)

Configure Modbus
interface

set

rs485_mode

rs485_addr

rs485_baud

rs485_databits

rs485_parity

rs485_stopbits

Configuring Modbus
interface (page 20)

AQT530 Configuration Guide

M212572EN-C

12

Summary of Contents for AQT530

Page 1: ...M212572EN C Configuration Guide Vaisala Air Quality Transmitter AQT530...

Page 2: ...y given time and hereby disclaims any and all responsibilities related thereto This document does not create any legally binding obligations for Vaisala towards customers or end users All legally bind...

Page 3: ...nds and parameters 28 5 2 CLI command reference 28 5 3 Setting date date command 30 5 4 Restoring default configuration initconf command 30 5 5 Printing LPC information lpc command 31 5 6 Printing mea...

Page 4: ...Appendix A M12 pinout and wiring 55 Appendix B OSS licenses 56 Warranty 59 Technical support 59 Recycling 59 AQT530 Configuration Guide M212572EN C 2...

Page 5: ...t labels on AQT530 10 Figure 2 Location of Class 3B laser radiation label on AQT530 inside laser particle counter LPC 11 Figure 3 Byte order for 32 bit values 44 Figure 4 Byte order for string fields...

Page 6: ...Table 20 Parameters for lpc command 31 Table 21 Parameters for meas command 32 Table 22 Parameters for reboot command 35 Table 23 Parameters for set command 36 Table 24 Modbus interface configuration...

Page 7: ...lue Modbus Added device status monitoring CLI and Modbus Updated default Modbus serial port settings Updated and added some examples Changes to CLI Added commands status and meas nolc Added PM1 to lpc...

Page 8: ...y or even death WARNING Caution warns you of a potential hazard If you do not read and follow instructions carefully at this point the product could be damaged or important data could be lost CAUTION...

Page 9: ...Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and other countries Chapter 1 About this document 7...

Page 10: ...lly designed for air quality monitoring networks in areas with traffic road networks or around transportation hubs Thanks to its small weight compact size and good precision it is ideally suited for d...

Page 11: ...c warnings elsewhere in these instructions violates safety standards of design manufacture and intended use of the product Vaisala assumes no liability for the customer s failure to comply with these...

Page 12: ...ect physical access to laser radiation Table 3 Incorporated laser module Property Description Value Laser module Class 3B Laser wavelength 658 nm Maximum power 22 mW The device is equipped with the fo...

Page 13: ...owever it is possible to damage the product by delivering electrostatic discharges when touching removing or inserting any objects in the equipment housing To avoid delivering high static voltages to...

Page 14: ...on Overview of CLI commands and parameters page 28 Modbus register addresses for AQT530 page 45 ASCII CSV data message page 22 3 2 Configuration overview You can do the operations listed in the follow...

Page 15: ...57 0x005C See Setting up system time over Modbus interface page 52 AQT530 base module LPC and HMP identification read only show serial sw_ver hw_ver model unit cal_date base_serial lpc_serial hmp_seri...

Page 16: ...ister addresses for AQT530 page 45 3 3 Measurement output The AQT530 measurement data is available over RS 485 by means of Modbus ASCII and RTU modes or alternatively in ASCII CSV format The measureme...

Page 17: ...ppm H2S 0x0004 ppb 0x0069 0 1 g m3 meas ppm meas metric g m3 meas ppb ppb ppm O3 0x0005 ppb 0x006A 0 1 g m3 meas ppm meas metric g m3 meas ppb ppb ppm NO 0x0006 ppb 0x006B 0 1 g m3 meas ppm meas metr...

Page 18: ...s and changing measurement output unit meas command page 32 ASCII CSV data message page 22 3 3 1 Conversion factors for gases Conversion from ppb to g m3 is calculated with the following formula g m3...

Page 19: ...efer to PuTTY Another program with a command line interface can also be used but the user interface looks different Once you have installed and set up AQT530 as instructed in Vaisala Air Quality Trans...

Page 20: ...atively connect your own power source directly to the DC power connector Wire color Power Red Black 2 On your computer select Start PuTTY 3 On your computer select Start Control Panel Device Manager P...

Page 21: ...ridge Use the following COM port settings Parameter Value Speed baud 115200 Data bits 8 Stop bits 1 Parity None Flow control None These settings are applied on your computer so that it can connect to...

Page 22: ...rs485_mode uint8 0 ASCII CSV 1 Modbus ASCII 4 Modbus RTU 4 RS 485 mode rs485_addr uint8 1 253 1 Modbus address not used in ASCII CSV mode rs485_baud uint32 4800 115200 19200 bps RS 485 baud rate rs48...

Page 23: ...stop bit 3 The device is ready More information Changing configuration parameter set command page 35 Saving to non volatile memory write command page 42 Modbus register addresses for AQT530 page 45 4...

Page 24: ...35 Saving to non volatile memory write command page 42 4 3 1 ASCII CSV data message The ASCII CSV data message is used for outputting AQT530 measurement data Timestamp Conditions Gases Particles Confi...

Page 25: ...data message with 4 gas sensors and LPC 2022 01 22T07 37 38 22 3 24 1 999 3 0 182 2 920 0 575 0 140 0 1 1 1 1 9 T H P N O2 CO O3 NO PM1 PM2 5 PM10 3185 2022 01 22T07 38 38 22 3 24 1 999 3 0 170 2 921...

Page 26: ...pe set tempunit 1 write really 3 To check that the settings are correct type show tempunit More information Changing configuration parameter set command page 35 Saving to non volatile memory write com...

Page 27: ...ription 0x0000 0x0006 Gas concentrations in parts per billion ppb with linear correction 0x0066 0x006B Gas concentrations in g m3 with linear correction 0x0008 0x0009 0x0037 Particle matter PM1 PM2 5...

Page 28: ...correction 1 255 0 01 2 55 Table 16 Linear correction parameters particles Parameter Type Range Default Unit Description pm1_zero int16 10000 10000 0 0 1 g m3 PM1 offset zero correction 10000 10000 1...

Page 29: ...pe set o3_zero 100 set o3_span 120 3 To save the changes write really The new values overwrite the previous zero and span values Values without linear correction are available with Modbus registers 0x...

Page 30: ...Linear correction parameters for particles Table 27 page 38 Read only parameters Device identification parameters Table 28 page 38 Base module identification parameters Table 29 page 38 Base module m...

Page 31: ...motd command page 34 reboot really Restarts the device If gas cells are in use rebooting the device restarts the 24 hour stabilization time Restarting device reboot command page 35 set parameter valu...

Page 32: ...hanging the date date 2020 12 02T13 50 36 Example response Date updated to 2020 12 02T13 50 36 More information Setting system time page 24 5 4 Restoring default configuration initconf command To rest...

Page 33: ...ult configuration to non volatile memory by using write command Use the write command to save the configuration write really 5 5 Printing LPC information lpc command To display information about the l...

Page 34: ...Parameter Value Mandatory Description none No Prints out all measurements with gases in parts per million ppm units and with linear correction metric Fixed No Prints out all measurements with gases i...

Page 35: ...g measurement output to use metric g m3 units meas metric Example response NO2 ug m3 5 9 SO2 ug m3 912 5 CO ug m3 63 6 O3 ug m3 1 8 PM1 ug m3 0 1 PM2 5 ug m3 0 4 PM10 ug m3 2 2 TEMP C 22 1 HUM RH 31 5...

Page 36: ...using parts per million ppm units meas nolc Example response NO2 ppm 0 004 SO2 ppm 0 562 CO ppm 0 077 O3 ppm 0 002 PM1 ug m3 0 2 PM2 5 ug m3 0 4 PM10 ug m3 2 2 TEMP C 22 2 HUM RH 31 2 PRES mbar 1012 4...

Page 37: ...restarts the 24 hour stabilization time Table 22 Parameters for reboot command Parameter Value Mandatory Description really Fixed Yes Confirms the restart Example response Resetting device in 5 second...

Page 38: ...Configuring ASCII CSV data sending page 21 Changing temperature unit page 24 Adjusting linear correction page 25 5 9 1 CLI parameters The following configuration and status parameters are available wi...

Page 39: ...ero correction co_span uint8 1 255 100 0 01 CO sensor span correction 1 255 0 01 2 55 no_zero int16 10000 10000 0 ppb NO sensor zero correction no_span uint8 1 255 100 0 01 NO sensor span correction 1...

Page 40: ...1000 0 001 PM2 5 span gain correction 1 10000 0 001 10 000 pm10_zero int16 10000 10000 0 0 1 g m3 PM10 offset zero correction 10000 10000 1000 0 1000 0 pm10_span int16 1 10000 1000 0 001 PM10 span gai...

Page 41: ...Device model unit Text Combination of Model Serial number Configuration Table 31 Gas measurement configuration and diagnostics parameters read only Parameter Type Range Unit Description health uint8 0...

Page 42: ...er Mandatory Description For the list of parameters see CLI parameters page 36 Yes Shows the value of selected parameter Example of checking the software version show rs485_baud Example response show...

Page 43: ...ame of the system use the uname command uname a Table 35 Parameters for uname command Parameter Value Mandatory Description none Prints the Unix name of the system in short format a Fixed No Prints th...

Page 44: ...ite command together with the other commands for example set Table 36 Parameters for write command Parameter Value Mandatory Description really Fixed Yes Confirms the action Example response Writing c...

Page 45: ...ntification 6 3 Device identification AQT530 supports the following device identification objects AQT530 supports only individual access of device identification objects Read Device ID code 0x04 Objec...

Page 46: ...e means of 2 consecutive 16 bit registers The byte order for the 32 bit values is middle endian bytes within words are in big endian order while words in multi word values are in little endian order 0...

Page 47: ...QT530 The register addresses are R Read only RW Read write W Write only Table 37 Modbus register addresses Address RW Type Unit Register count Description 0x0000 R int16 ppb 1 Nitrogen dioxide NO2 con...

Page 48: ...t16 ppb 1 Nitric oxide NO concentration in parts per billion ppb with linear correction For a value without linear correction use register 0x0072 For g m3 value use register 0x006B 0x0008 R int16 0 1...

Page 49: ...1 Fahrenheit 0x001F R int16 1 Device health index combined percentage of usage of sensor cells decreases from 100 100 Full health 0 All sensors over aged 0x0033 R int16 1 Gas cell stabilization inval...

Page 50: ...major number 0x0055 R uint16 1 HMP device firmware version minor number 0x0056 R uint16 1 HMP device firmware version revision number 0x0057 RW uint16 1 System time year Read System time is read into...

Page 51: ...by means of selected conversion type Calculation method is selected with register 0x0065 0x006A R int16 0 1 g m3 1 Trioxygen ozone O3 concentration calculated from ppb value with linear correction reg...

Page 52: ...tion use register 0x0009 0x0075 R int16 0 1 g m3 1 Particulate matter PM1 without linear correction For a value without linear correction use register 0x0037 0x0076 R int16 1 LPC data state 0 LPC data...

Page 53: ...W int16 ppb 1 NO2 linear correction offset 10000 10000 0x008F RW int16 ppb 1 SO2 linear correction offset 10000 10000 0x0090 RW int16 ppb 1 NO linear correction offset 10000 10000 0x0091 RW int16 ppb...

Page 54: ...ration to the onboard EEPROM memory 1 Write configuration Other values no effect 6 6 Setting up system time over Modbus interface You can read and write the system time over the Modbus interface 1 To...

Page 55: ...dbus query RS 485 wiring is wrong Do the following 1 Configure human readable ASCII CSV report see Configuring ASCII CSV data sending page 21 2 Verify that ASCII CSV report is sent every 60 s to RS 48...

Page 56: ...and list of other items such as lighting heaters and motors that were connected to the same power output Are all parts connected and grounded properly Take a photo to help the troubleshooting AQT530 C...

Page 57: ...nnector M12 pin Wire color RS 232 RS 485 1 White Data GND Data GND 2 Brown RX input 3 Green TX output 4 Yellow No connection floating 5 Gray B 6 Pink A 7 Blue Power GND Power GND 8 Red Power 10 25 V D...

Page 58: ...e any questions about the open source software contact us at opensourcesw vaisala com To request a copy of certain open source code as required by certain applicable OSS licenses send an email to open...

Page 59: ...lip Soeberg Anatoly Sokolov Nils Kristian Strom Michael Stumpf Stefan Swanepoel Eric B Weddington Joerg Wunsch Dmitry Xmelkov The Regents of the University of California All rights reserved Redistribu...

Page 60: ...E COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS...

Page 61: ...of the warranty for each product Technical support Contact Vaisala technical support at helpdesk vaisala com Provide at least the following supporting information as applicable Product name model and...

Page 62: ......

Page 63: ......

Page 64: ...www vaisala com...

Reviews: