CL61 configuration parameters - CL61

CL61 User Guide

Document code
M212475EN
Revision
D
Language
English (United States)
Product
CL61
Document type
User guide

The following parameters are used with the GET, GETSET, and SET commands.

The following levels are in use:

  • Level 0: read access
  • Level 1: write access to basic parameters
  • Level 2: write access to advanced parameters

To change the user level, use the level command.

Columns GET and SET indicate the required user level to view or change the setting.

Table 1. Product metadata
Parameter Description Value / range GET SET
cl.product.model Product model CL61D 0 -
cl.product.modelname Product model name CL61 with Depolarization 0 -
cl.product.revision Product revision A - Z 0 -
Table 2. Unit metadata
Parameter Description Value / range GET SET
cl.unit.alias1 Alias name 1 Freeform text 0 1
cl.unit.latitude

Latitude

Unit: degrees

−90.000000 … 90.000000 0 1
cl.unit.longitude

Longitude

Unit: degrees

−180.000000 ... 180.000000 0 1
cl.unit.altitude

Altitude

Unit: Meters

Resolution: full meters

Use negative value (-) for values below sea level

−999 ... 9999 0 1
Table 3. User parameters
Parameter Description Value / range GET SET
cl.password.admin Admin user password String - 1
Table 4. Ethernet parameters
Parameter Description Value / range Default GET SET
eth0.address.mac MAC address Set at factory, different for each device 0 -
eth0.address.dhcp DHCP
  • ON
  • OFF
0 -
eth0.address.ip1 IP address 172.17.0.2 0 -
eth0.address.nm1 Netmask 255.255.255.0 0 -
eth0.address.gw1 Gateway 172.17.0.1 0 -
eth0.address.dns1 DNS server1 172.17.0.1 0 -
eth0.address.dns2 DNS server 2 OFF 0 -
eth1.address.mac MAC address 0 -
eth1.address.dhcp DHCP
  • ON
  • OFF
OFF 0 1
eth1.address.ip1 IP address 192.168.2.102 0 1
eth1.address.nm1 Netmask 255.255.255.0 0 1
eth1.address.gw1 Gateway 192.168.2.1 0 1
eth1.address.dns1 DNS server1 192.168.2.1 0 1
eth1.address.dns2 DNS server2
  • ON
  • OFF
OFF 0 1
Restart the device after changing DNS settings.
Table 5. Time parameters
Parameter Description Value / range Default GET SET
time.sync.ntp1 Network time protocol server address 1
  • Address of NTP server
  • OFF
2.openembedded.pool.ntp.org (default) 0 1
time.sync.ntp2 Network time protocol server address 2
  • Address of NTP sever
  • OFF
OFF 0 1
time.unit.optime

Unit operation since factory reset

Unit: hours

0 … 1000000 0 -
time.unit.now Unit date and time, UTC

Format:

YYYY-MM-DD HH:MM:SS
0 1
Table 6. Measurement parameters
Parameter Description Value / range Default GET SET

algo.l1averaging.

interval

Averaging interval for ABS, XPOL, and PPOL in L1 / Number of 5 s profiles averaged in each x‑polarization (XPOL), p‑polarization (PPOL), and attenuated backscatter profile (ABS)

Averaging refers to the running average, so for every 5 s profile, this parameter averages the number of previous profiles. The algorithm produces profiles in 5 second intervals.

You can specify that profiles recorded in netCDF files are averaged by n × 5 s, where n = 1 … 24.

NOTE: Vaisala recommends setting n = 1 to enable the reprocessing of archived data sets with new algorithms in the future. While it may be useful to have n > 1 for compact file sizes, this limits reprocessing.

1 … 24

12

0 1

algo.l1averaging.

depolinterval

Averaging interval for depol in L1 / Number of 5 s profiles averaged in each depolarization profile

For every 5-second profile, this parameter averages the number of previous profiles. The algorithm produces profiles in 5-second intervals.

1 … 24

12

0 1

algo.tiltanglecorrection.

enabled

Correction of cloud height by tilt angle

  • ON
  • OFF
OFF 0 1

algo.cloudlayers.

offsetinmeters

Corrected cloud height by offset value

Can be used when device is installed above or below reference height.

−999 ... 9999 0.0 0 1

algo.airplanefilter.

enabled

Filtering outliers caused by low-altitude airplanes from cloud data

Can be used when device is installed at an airport.

  • ON
  • OFF
OFF 0 1
Table 7. Reporting parameters
Parameter Description Value / range Default GET SET

reporting.destination.

address

Destination Valid URL 0 1

reporting.netcdf.

institution

Institution attribute in the .nc file Freeform text 0 1

reporting.netcdf.

conventions

NetCDF convention attribute in the .nc filehttps://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html

Acc. to CF-1.8 0 -

reporting.netcdf.

comment

Comment attribute in the .nc file Freeform text 0 1

reporting.netcdf.unit

Unit used for reporting vertical visibility, cloud base heights, and range
  • m
  • ft
m 0 1

reporting.profile.

interval

Interval for reporting to write out profiles

Only every nth profile is written to the netCDF file where the n is this parameter.

This parameter can be used to avoid overlapping averaging. For example, if algo.l1averaging.interval is set to 6 corresponding to a 30 s time span, this parameter can be set to 6 as well to get the profiles every 30 s.

1 ... no maximum

12

0 1

reporting.livefile.

profilesperfile

Number of profiles that are written in each .nc file

If reporting.profile.interval is set to 6 and this parameter is set to 4, one netCDF file will cover 2 min of data (6 × 4 × 5 s).

1 … 1440

5

0 1

reporting.livefile.

nameprefix

Prefix in netCDF file name

Used to distinguish between live and archive files

See also cl.sender.fileprefix

NetCDF filename format: <cl.sender.fileprefix><reporting.livefile.nameprefix>_YYYYMMDD_HHmmss.nc

Freeform text 0 1

reporting.archivefile.

profilesperfile 1

Number of profiles written in each .nc file

If the reporting.profile.interval is set to 6 and this parameter is set to 4, one netCDF file covers 2 min of data (6 × 4 × 5 s).

0 = Archive file not written

reporting.archivefile.

nameprefix 1

Prefix in netCDF file name

Used to distinguish between live and archive files

See also cl.sender.fileprefix

NetCDF filename format: <cl.sender.fileprefix><reporting.archivefile.nameprefix>_YYYYMMDD_HHmmss.nc

Freeform text
Table 8. Sender configuration parameters
Parameter Description Value / range GET SET

cl.sender.fileprefix

Prefix in netCDF file name

Used to distinguish files coming from different CL61 devices

See also reporting.livefile.nameprefix and reporting.arhivefile.nameprefix

NetCDF filename format: <cl.sender.fileprefix><reporting.livefile.nameprefix>_YYYYMMDD_HHmmss.nc

Freeform text 0 1
cl.sender.hostpubmd5 MD5 hash of the SSH server host key String 1 1
cl.sender.publickey Public key String 1 -
Table 9. Alert parameters
Parameter Description Value / range Default GET SET

alerts.cl.

recentlystarted

After reset, time period for keeping recently restarted indication alert on

Unit: seconds

0 … 3600 180 2 -
alerts.clo.tiltanglew Angle of ceilometer in degrees from vertical that triggers tilt angle warning 45 2 -

alerts.clr.

windowconditioni

Limit for triggering window condition indication 80 2 -

alerts.clr.

windowconditionw

Limit for triggering window condition warning 50 2 -

alerts.clr.

windowconditiona

Limit for triggering window condition alarm 20 2 -

alerts.clr.

windowblockingratio

Limit for triggering window blocking warning 0.2 2 -

alerts.clt.

lightsourcepowerw

Limit for triggering TX light source power warning 80 2 -

alerts.clt.

lightsourcepowera

Limit for triggering TX light source power alarm 60 2 -

alerts.clt.

lightsourcefailure

Limit for triggering transmitter laser power failure 10 2 -
1 Available later