CL61 configuration parameters - CL61

CL61 User Guide

Document code
M212475EN
Revision
E
Language
English
Product
CL61
Document type
User guide

The following tables show the parameters that 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 values (−) for values below sea level.

−999 ... 9999 0 1
cl.unit.azimuthangle

Measurement azimuth angle

Reference direction: north

Unit: degrees

0 ... 360 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 (NTP) server address 1
  • Address of NTP server
  • OFF
2.openembedded.pool.ntp.org 0 1
time.sync.ntp2 Network time protocol (NTP) 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

Number of 5‑second 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‑second 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 seconds, where n = 1 … 24.

1 … 24

12

0 1

algo.l1averaging.

depolinterval

Number of 5‑second 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.

2 … 24

12

0 1

algo.fivelayerskycondition.enabled

Default is OFF with 3 cloud layers reported.

When ON, up to 5 cloud layers are reported.

  • ON
  • OFF
OFF 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.

For use when the device is installed above or below reference height.

−999 ... 9999 0.0 0 1

algo.airplanefilter.

maxrangeinmeters

Filtering outliers caused by low-altitude airplanes from cloud data.

For use when the device is installed at an airport. A typical maximum range for the filter is 400 m when the device is close to the runway.

Unit: meters

0 ... 1000 0 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 file https://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‑second time span, this parameter can be set to 6 as well to get the profiles every 30 seconds.

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.

See also cl.sender.fileprefix.

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

Freeform text 0 1
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. Calibration parameters
Parameter Description Value / Range Default get set

clt.factory.

laserpower

Transmitter laser power measured at the factory Device specific 2

clo.factory.

cloudfactor

Cloud calibration factor set at the factory Device specific 2

clo.field.

cloudfactor

Cloud calibration factor set by the user.

The default is the same as

clo.factory.

cloudfactor

Device specific 2 2
Table 10. 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 from vertical that triggers tilt angle warning

Unit: degrees

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