Vaisala AQT530 User manual

M212572EN-C
Configuration Guide
Vaisala Air Quality Transmitter
AQT530

PUBLISHED BY
Vaisala Oyj
Vanha Nurmijärventie 21, FI-01670 Vantaa, Finland
P.O. Box 26, FI-00421 Helsinki, Finland
[phone]
Visit our Internet pages at www.vaisala.com.
© Vaisala 2021
No part of this document may be reproduced,
published or publicly displayed in any form or by
any means, electronic or mechanical (including
photocopying), nor may its contents be modified,
translated, adapted, sold or disclosed to a third
party without prior written permission of the
copyright holder. Translated documents and
translated portions of multilingual documents are
based on the original English versions. In
ambiguous cases, the English versions are
applicable, not the translations.
The contents of this document are subject to
change without prior notice.
Local rules and regulations may vary and they
shall take precedence over the information
contained in this document. Vaisala makes no
representations on this document’s compliance
with the local rules and regulations applicable at
any 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 binding obligations and
agreements are included exclusively in the
applicable supply contract or the General
Conditions of Sale and General Conditions of
Service of Vaisala.
This product contains software developed by
Vaisala or third parties. Use of the software is
governed by license terms and conditions
included in the applicable supply contract or, in
the absence of separate license terms and
conditions, by the General License Conditions of
Vaisala Group.
This product may contain open source software
(OSS) components. In the event this product
contains OSS components, then such OSS is
governed by the terms and conditions of the
applicable OSS licenses, and you are bound by the
terms and conditions of such licenses in
connection with your use and distribution of the
OSS in this product. Applicable OSS licenses are
included in the product itself or provided to you
on any other applicable media, depending on
each individual product and the product items
delivered to you.

Table of contents
1. About this document.......................................................................................5
1.1 Version information.............................................................................................5
1.2 Related manuals.................................................................................................. 5
1.3 Documentation conventions..............................................................................6
1.4 Trademarks...........................................................................................................6
2. Product overview.............................................................................................. 8
2.1 Vaisala Air Quality Transmitter AQT530........................................................... 8
2.2 Safety.................................................................................................................... 9
2.2.1 Eye safety..................................................................................................... 10
2.2.2 ESD protection.............................................................................................. 11
3. Configuration.....................................................................................................12
3.1 Interface overview..............................................................................................12
3.2 Configuration overview..................................................................................... 12
3.3 Measurement output......................................................................................... 14
3.3.1 Conversion factors for gases......................................................................16
4. CLI operation..................................................................................................... 17
4.1 Connecting to AQT530 over RS-232................................................................17
4.2 Configuring Modbus interface.........................................................................20
4.3 Configuring ASCII CSV data sending...............................................................21
4.3.1 ASCII CSV data message........................................................................... 22
4.4 Changing temperature unit............................................................................. 24
4.5 Setting system time..........................................................................................24
4.6 Adjusting linear correction...............................................................................25
5. CLI commands and parameters................................................................28
5.1 Overview of CLI commands 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 measurements and changing measurement output
unit (meas command) ..................................................................................... 32
5.7 Clearing screen (motd command)..................................................................34
5.8 Restarting device (reboot command)............................................................35
5.9 Changing configuration parameter (set command).....................................35
5.9.1 CLI parameters............................................................................................36
5.10 Printing value of configuration parameter (show command).................... 40
5.11 Printing device status (status command)..................................................... 40
5.12 Printing Unix name (uname command)..........................................................41
5.13 Saving to non-volatile memory (write command)....................................... 42
6. Modbus interface description....................................................................43
6.1 Supported Modbus protocols..........................................................................43
6.2 Function codes..................................................................................................43
6.3 Device identification.........................................................................................43
6.4 Byte order..........................................................................................................44
6.5 Modbus register addresses for AQT530........................................................ 45
6.6 Setting up system time over Modbus interface.............................................52
7. Troubleshooting.............................................................................................. 53
7.1 Writing a problem report................................................................................. 53
Table of contents
1

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

List of figures
Figure 1 Location of Class 1 laser product 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................................................................................45
Figure 5 Pinout of M12 connector ...................................................................................55
List of figures
3

List of tables
Table 1 Document versions (English)............................................................................ 5
Table 2 AQT530 manuals...................................................................................................5
Table 3 Incorporated laser module............................................................................... 10
Table 4 Overview of configuration operations...........................................................12
Table 5 Temperature..........................................................................................................14
Table 6 Humidity.................................................................................................................14
Table 7 Pressure..................................................................................................................15
Table 8 Gas concentration................................................................................................15
Table 9 Mass concentration without linear correction............................................. 15
Table 10 Mass concentration with linear correction....................................................15
Table 11 Conversion factors for conversion from ppb to µg/m3.............................16
Table 12 Modbus interface configuration parameters.............................................. 20
Table 13 ASCII CSV message data fields.......................................................................22
Table 14 Modbus registers for measurement data.....................................................25
Table 15 Linear correction parameters - gases........................................................... 25
Table 16 Linear correction parameters - particles......................................................26
Table 17 List of commands............................................................................................... 28
Table 18 Parameters for date command.......................................................................30
Table 19 Parameters for initconf command.................................................................30
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 parameters.............................................. 36
Table 25 Temperature unit parameter............................................................................37
Table 26 Linear correction parameters - gases........................................................... 37
Table 27 Linear correction parameters - particles......................................................38
Table 28 Device identification parameters (read-only)............................................ 38
Table 29 Base module identification parameters (read-only)................................ 38
Table 30 Base module monitoring parameters (read-only).................................... 39
Table 31 Gas measurement configuration and diagnostics
parameters (read-only).................................................................................... 39
Table 32 LPC parameters (read-only)............................................................................39
Table 33 TH probe parameters (read-only)..................................................................39
Table 34 Parameters for show command.....................................................................40
Table 35 Parameters for uname command................................................................... 41
Table 36 Parameters for write command......................................................................42
Table 37 Modbus register addresses..............................................................................45
Table 38 Troubleshooting AQT530................................................................................. 53
Table 39 Pinout of M12 connector................................................................................... 55
Table 40 AQT530 OSS license.......................................................................................... 56
AQT530 Configuration Guide M212572EN-C
4

1. About this document
1.1 Version information
This document provides instructions for configuring Vaisala Air Quality Transmitter AQT530.
Table 1 Document versions (English)
Document code Date Description
M212572EN-C September 2021 • Modbus register address type updated for 0x0066 - 0x006B
• Default parity for rs485_parity updated
M212572EN-B April 2021 For device SW version 3.1:
• Modbus version 1.2
• CLI version 1.2
Main changes:
• Added support for PM1observations (CLI, Modbus, ASCII CSV)
• Added support for measurement values without linear correction
(CLI and Modbus)
• Added humidity invalidation flags for each PM value (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 PM1to lpc --meas output
• Added parameters pm1_zero and pm1_span
Changes to Modbus:
• Added device status registers 0x004B - 0x004C
• Added measurement data registers 0x006C - 0x0075
• Added humidity invalidation flag registers 0x007C - 0x007E for
PM1, PM2.5, and PM10
• Updated LPC humidity invalidation flag register 0x007B
• Added span and zero registers 0x0096 - 0x0097 for PM1
M212572EN-A February 2021 First version.
For device SW version 3.0:
• Modbus version 1.1
• CLI version 1.1
1.2 Related manuals
Table 2 AQT530 manuals
Document code Name
M212573EN Vaisala Air Quality Transmitter AQT530 Setup Guide
Chapter 1 – About this document
5

Document code Name
M212572EN Vaisala Air Quality Transmitter AQT530 Configuration Guide
M212580EN Vaisala Air Quality Transmitter AQT530 Maintenance Guide
The documentation is available online at http://www.vaisala.com/aqt530.
1.3 Documentation conventions
Warning alerts you to a serious hazard. If you do not read and follow
instructions carefully at this point, there is a risk of injury 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!
Note highlights important information on using the product.
Tip gives information for using the product more eciently.
Lists tools needed to perform the task.
Indicates that you need to take some notes during the task.
1.4 Trademarks
Vaisalaâis a registered trademark of Vaisala Oyj.
Modbusâis a registered trademark of Schneider Automation Inc.
AQT530 Configuration Guide M212572EN-C
6

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

2. Product overview
2.1 Vaisala Air Quality Transmitter
AQT530
Vaisala Air Quality Transmitter AQT530 measures the pollution content of ambient air.
AQT530 is available in dierent models for measuring gases, particles, or both.
AQT530 is specifically designed for air quality monitoring networks in areas with trac, road
networks, or around transportation hubs.
Thanks to its small weight, compact size, and good precision it is ideally suited for
deployment especially in large air quality networks. The measurement data can be sent
wirelessly to a web-based database with a gateway solution and it is also available locally
through a serial interface.
AQT530 Configuration Guide M212572EN-C
8

2.2 Safety
This product has been tested for safety. Note the following precautions:
Do not replace components when the system is powered up. Disconnect
all power sources before performing maintenance procedures.
WARNING!
Do not substitute parts or modify the system, or install unsuitable parts in
the system. Improper modification can damage the product or lead to malfunction.
WARNING!
Assess the risks from the installation work. Consider also the eects of
local weather conditions.
WARNING!
Failure to comply with these precautions or with specific 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 requirements.
WARNING!
If the equipment is used in a manner not specified by Vaisala, the
protection provided by the equipment may be impaired.
WARNING!
Follow local and state legislation and regulations on occupational safety.WARNING!
WARNING! Do not attempt to open the laser particle counter (LPC) for service. Removing
the cover may cause exposure to harmful class 3B laser radiation and electrical shock.
Improper modification can damage the product or lead to malfunction. Any
modification voids your warranty.
CAUTION!
Chapter 2 – Product overview
9

2.2.1 Eye safety
Vaisala Air Quality Transmitter AQT530 is classified as a Class 1 laser device in accordance
with International Standard IEC 60825-1. It complies with 21 CFR 1040.10 and 1040.11 except
for conformance with IEC 60825-1 ED. 3., as described in the Laser Notice No. 56, dated May
8,2019. A Class 1 laser device is safe under all conditions of normal use.
AQT530 incorporates a Class 3B laser. The laser is contained in an enclosure, preventing
direct 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 following laser product labels.
CLASS 1
LASER PRODUCT
CLASS 1
LASER PRODUCT
COMPLIES WITH 21 CFR 1040.10 AND 1040.11 EXCEPT
FOR CONFORMANCE WITH IEC 60825-1 ED. 3., AS
DESCRIBED IN LASER NOTICE NO. 56, DATED MAY 8,
2019.
COMPLIES WITH 21 CFR 1040.10 AND 1040.11EXCEPT FOR CONFORMANCE WITH IEC 60825-1 ED. 3., AS DESCRIBED IN LASER NOTICE NO. 56, DATEDMAY 8, 2019.
Figure 1 Location of Class 1 laser product labels on AQT530
AQT530 Configuration Guide M212572EN-C
10

WARNING - CLASS 3B
LASER RADIATION
WHEN OPEN. AVOID
EXPOSURE TO BEAM
WARNING - CLASS 3B
LASER RADIATION
WHEN OPEN. AVOID
EXPOSURE TO BEAM
Figure 2 Location of Class 3B laser radiation label on AQT530 inside laser particle counter
(LPC)
Follow the safety information to avoid exposure to laser radiation.
2.2.2 ESD protection
Electrostatic Discharge (ESD) can damage electronic circuits. Vaisala products are
adequately protected against ESD for their intended use. However, 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 the product:
• Handle ESD‑sensitive components on a properly grounded and protected ESD
workbench or by grounding yourself to the equipment chassis with a wrist strap and a
resistive connection cord.
• If you are unable to take either precaution, touch a conductive part of the equipment
chassis with your other hand before touching ESD‑sensitive components.
• Hold component boards by the edges and avoid touching component contacts.
Chapter 2 – Product overview
11

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/m3)
• 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

Action CLI command and
parameter
CLI reference Modbus register
addresses
Change temperature unit
(°C/°F)
set tempunit Changing temperature
unit (page 24)
0x001C
Adjust linear correction set
•co_zero
•co_span
•no_zero
•no_span
•no2_zero
•no2_span
•so2_zero
•so2_span
•h2s_zero
•h2s_span
•o3_zero
•o3_span
•pm1_zero
•pm1_span
•pm25_zero
•pm25_span
•pm10_zero
•pm10_span
Adjusting linear
correction (page 25)
0x0086 ... 0x0097
Set system time date Setting date ( date
command) (page 30)
0x0057 ... 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_serial
•hmp_version
lpc --info
Printing LPC information
( lpc command)
(page 31)
Modbus device
identification:
• Model
• SW version
• Sensor model
• Serial number
• Calibration date
• Hardware version
Modbus registers:
• Calibration date:
0x0013-0x0015
• Base firmware version:
0x004F-0x0053
• HMP firmware version:
0x0054-0x0056
• AQT serial number:
0x00B4-0x00B7
• HMP serial number:
0x00B8-0x00BB
• LPC serial number:
0x00BC-0x00BF
• LPC firmware version:
0x00F4-0x00F8
Chapter 3 – Configuration
13

Action CLI command and
parameter
CLI reference Modbus register
addresses
Get ug/m3converted
values
meas --metric Printing measurements
and changing
measurement output unit
( meas command)
(page 32)
Modbus register
addresses are available
for both metric (ug/m3)
and parts per billion
(ppb) values
Reset device reboot --really Restarting device
( reboot command)
(page 35)
0x00FA
To use the CLI commands, establish a local maintenance connection to AQT530 over RS-232.
More information
‣Overview of CLI commands and parameters (page 28)
‣Modbus register 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 measurement data can be monitored also through CLI.
The following tables present the measurements, their units, and resolution.
Set of available gases depends on gas cell setup.
Particle measurement results are included when an LPC device is installed and enabled.
Table 5 Temperature
Value Modbus CLI ASCII CSV
Air temperature 0x000A: 0.1 °C / 0.1 °F • meas: °C / °F
•meas --metric: °C / °F
•meas --ppb: °C / °F
°C / °F
Table 6 Humidity
Value Modbus CLI ASCII CSV
Air humidity 0x000B: 0.1 %RH • meas: %RH
•meas --metric: %RH
•meas --ppb: %RH
%RH
AQT530 Configuration Guide M212572EN-C
14

Table 7 Pressure
Value Modbus CLI ASCII CSV
Air pressure 0x000C: 0.1 hPa • meas: hPa
•meas --metric: hPa
•meas --ppb: hPa
hPa
Table 8 Gas concentration
Value Modbus CLI ASCII CSV
NO2•0x0000: ppb
•0x0066: 0.1 µg / m³
•meas: ppm
•meas --metric: µg/m3
•meas --ppb: ppb
ppm
SO2•0x0001: ppb
•0x0067: 0.1 µg/m3
•meas: ppm
•meas --metric: µg/m3
•meas --ppb: ppb
ppm
CO • 0x0002: ppb
•0x0068: 1 µg/m3
•meas: ppm
•meas --metric: µg/m3
•meas --ppb: ppb
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 --metric: µg/m3
•meas --ppb: ppb
ppm
Table 9 Mass concentration without linear correction
Value Modbus CLI ASCII CSV
PM10075h: 0.1 μg/m3meas --nolc: μg/m3−
PM2.5 0073h: 0.1 μg/m3meas --nolc: μg/m3−
PM10 0074h: 0.1 μg/m3meas --nolc: μg/m3−
Table 10 Mass concentration with linear correction
Value Modbus CLI ASCII CSV
PM10037h: 0.1 μg/m3•meas: μg/m3
•meas --metric: μg/m3
•meas --ppb: μg/m3
μg/m3
Chapter 3 – Configuration
15

Value Modbus CLI ASCII CSV
PM2.5 0008h: 0.1 μg/m3•meas: μg/m3
•meas --metric: μg/m3
•meas --ppb: μg/m3
μg/m3
PM10 0009h: 0.1 μg/m3•meas: μg/m3
•meas --metric: μg/m3
•meas --ppb: μg/m3
μg/m3
More information
‣Modbus register addresses for AQT530 (page 45)
‣Printing measurements 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/m3is calculated with the following formula:
µg/m3= ppb * conversion_factor
Table 11 Conversion factors for conversion from ppb to µg/m3
Gas Conversion factor
NO21.912
SO22.66
CO 1.16
H2S 1.417
O32.00
NO 1.247
At +20 °C (+68 °F) temperature (European standard)
AQT530 Configuration Guide M212572EN-C
16

4. CLI operation
4.1 Connecting to AQT530 over RS-232
• Computer
• Service cable kit
• Slothead screwdriver
• Terminal block
• Terminal program with a command line interface (CLI), such as PuTTY or TeraTerm.
This instruction and examples use and refer to PuTTY. Another program with a command
line interface can also be used, but the user interface looks dierent.
Once you have installed and set up AQT530 as instructed in Vaisala Air Quality Transmitter
AQT530 Setup Guide, you may sometimes need to connect to AQT530 locally, for example,
to change the settings.
To connect to AQT530, create a local maintenance connection over the serial RS-232
interface.
Chapter 4 – CLI operation
17

1. Connect your computer to AQT530 with the service cable kit.
Connect the open-ended cables of the power source to the adapter and attach the
adapter to the DC power connector (10 ... 25 V DC).
Alternatively, 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 > Ports (COM &
LPT).
In Device Manager, check to which port AQT530 is connected with name ATEN USB to
Serial Bridge. For example: ATEN USB to Serial Bridge (COM1).
AQT530 Configuration Guide M212572EN-C
18