Keller Nanolevel module

Sensor Datasheet

• Manual
• Datasheet

Sensor Constructor

Example Code

The Keller Nanolevel is used in the menu a la carte example.

#include <sensors/KellerNanolevel.h>

// NOTE: Extra hardware and software serial ports are created in the "Settings
// for Additional Serial Ports" section

// NOTE: Use -1 for any pins that don't apply or aren't being used.
byte nanolevelModbusAddress  = 0x01;  // The modbus address of KellerNanolevel
const int8_t  nlAdapterPower = sensorPowerPin;  // RS485 adapter power pin
const int8_t  nanolevelPower = A3;              // Sensor power pin
const int8_t  nl485EnablePin = -1;              // Adapter RE/DE pin
const uint8_t nanolevelNumberReadings = 5;
// The manufacturer recommends taking and averaging a few readings

// Create a Keller Nanolevel sensor object
KellerNanolevel nanolevel(nanolevelModbusAddress, modbusSerial, nlAdapterPower,
                          nanolevelPower, nl485EnablePin,
                          nanolevelNumberReadings);

// Create pressure, temperature, and height variable pointers for the Nanolevel
Variable* nanolevPress = new KellerNanolevel_Pressure(
    &nanolevel, "12345678-abcd-1234-ef00-1234567890ab");
Variable* nanolevTemp = new KellerNanolevel_Temp(
    &nanolevel, "12345678-abcd-1234-ef00-1234567890ab");
Variable* nanolevHeight = new KellerNanolevel_Height(
    &nanolevel, "12345678-abcd-1234-ef00-1234567890ab");

Classes

class KellerNanolevel

The Sensor sub-class for the Keller nanolevel sensor.

class KellerNanolevel_Pressure

The Variable sub-class used for the gauge pressure (vented and barometric pressure corrected) output from a Keller Nanolevel ceramic capacitive level transmitter.

class KellerNanolevel_Temp

The Variable sub-class used for the temperature output from a Keller Nanolevel ceramic capacitive level transmitter.

class KellerNanolevel_Height

The Variable sub-class used for the gauge height (water level with regard to an arbitrary gage datum) output from a Keller Nanolevel ceramic capacitive level transmitter.

Sensor Timing

The sensor timing for a Keller Nanolevel

#define NANOLEVEL_WARM_UP_TIME_MS = 500

Sensor::_warmUpTime_ms; the Nanolevel warms up in 500ms.

#define NANOLEVEL_STABILIZATION_TIME_MS = 5000

Sensor::_stabilizationTime_ms; the Nanolevel stabilization takes about 5s (5000ms).

#define NANOLEVEL_MEASUREMENT_TIME_MS = 1500

Sensor::_measurementTime_ms; the Nanolevel takes 1500ms to complete a measurement.

Pressure

The pressure variable from a Keller Nanolevel

• Range is 0 to 300mbar
• Accuracy is Standard ±0.1% FS, Optional ±0.05% FS

#define NANOLEVEL_PRESSURE_RESOLUTION = 5

Decimals places in string representation; pressure should have 5 - resolution is 0.002%.

#define NANOLEVEL_PRESSURE_DEFAULT_CODE = "kellerNanoPress"

Default variable short code; "kellerNanoPress".

Temperature

The temperature variable from a Keller Nanolevel

• Range is 10°C to 50°C
• Accuracy is not specified in the sensor datasheet

#define NANOLEVEL_TEMP_RESOLUTION = 2

Decimals places in string representation; temperature should have 2 - resolution is 0.01°C.

#define NANOLEVEL_TEMP_DEFAULT_CODE = "kellerNanoTemp"

Default variable short code; "kellerNanoTemp".

Height

The height variable from a Keller Nanolevel

• Range is 0 to 120 inches
• Accuracy is Standard ±0.1% FS, Optional ±0.05% FS

#define NANOLEVEL_HEIGHT_RESOLUTION = 4

Decimals places in string representation; height should have 4 - resolution is 0.002%.

#define NANOLEVEL_HEIGHT_DEFAULT_CODE = "kellerNanoHeight"

Default variable short code; "kellerNanoHeight".