Setup is the most important part for defining each system and must be filled completely to get the fully functionable system.

The Setup menus are structured in 5 consequential steps : General, Equipment, Target, Channels and Permissions. System manager must followed all menues step-by-step from left to the right.

CALMS is using dots (blue and red) to indicate that some data are not confirmed or missing. Blue dot means system data are not confirmed, red dot means that essential data is missing.


General page is where you start with each system setup and where you have to set all basic system information.

You can add or change the system name, utility type, default currency, time zone, geo location, electricity cost, CO2, operation hours, device attached to the system and subscription type…

To start with Setup you can IMPORT data from previous system or you can Pull data from pre-audit in case you start with pre-audit first. You can also Export system setup data in case you want to use it in different system or as local backup.

NOTE: Is it important to fill in all data, because some auto calculations are based on these inputs.

To change units you have to go to personal settings.

NOTE: If you want to change the company, you must go to the Partner Panel and find a system whose name you want to change in the System section.

NOTE: Geo location will entered automatically if you will add system to the company with correct address. Otherwise use Google Maps for geo location. Type address and in your URL you will find your longitude and latitude values.

When you finish you have to press SAVE button in right corner.

CO2 emission

Decarbonizing electricity generation will be critical if we are to achieve cuts in global greenhouse gas emissions.

The CO2 from electricity generation emissions is a country based value that is changing over time. Please check which value is relevant for your country.

Some useful links:

Devices in the system

To use monitoring, one or more devices must be added to system. “Add device” button will open pop-up where you can select a device that you have access to. If your device is not on the list please contact

If the device is already used in a system, there are two options:

  • the device can be transferred from original system to new system with Transfer button (recommended),
  • the device can be used in multiple systems at the same time with button Use in multiple systems.

NOTE: When you transfer device to new system, old system will not measure data anymore. But data and channels will still be stored in original system.

The config of the device (what and how to measure) is automatically generated from the equipment setup. This is why it is important to add your device into correct system.

Start / pause device

Under Setup/general there is play/pause button to enable and disable device remotely.

  1. Pause device remote monitoring - disable device
  2. Start remote monitoring - enable device
  3. Device Setup and device dashboard, also delete device from the system
  4. No permission for device management

Even if device is disabled it will still log data in internal memory unless it is disconnected from power supply.

Subscription plan

If you are using CALMS for assessments only, monitoring will be disabled and you will not be able to access Inspect page.


If your system contains a CALMS device, setup and system home page will display monitoring is disabled warning. To disable the warning, user must enable monitoring using Temporary or Permanent type.

Temporary monitoring is used for audits with max duration of one month. After that time, system manager will have to re-activate it to prolong for another month.

Permanent monitoring is used for permanent measurements and continuous improvements until system manager will not disable device or the system.

System manager or administrator can at any time switch between different selections. Keep in mind that switching between permanent / temporary / disabled can have some billing consequences and use credits for assessment-audits.

System size

Size of the system is calculated based on number of channels, compressors and total power of equipment installed. Just for orientation, size S is normally small system with up to 2 compressors, M is medium system with up to 4 compressors, L is large system with up to 8 compressors and XL is system with more than 8 compressors.

Enabled features is used as indication which CALMS pages are available for selected type of the system.


Equipment page is the most important page where Piping and Instrumentation diagram (PID) of compressed air system with equipment elements and instrumentation can be created. This will build model of the system, equipment list and channel list automatically.

Standard CALMS edge device can connect via many different communication protocols such as analog or digital inputs, Modbus and ADS. To configure these connections at your device, you can use the CALMS configuration database that contains most common instruments available on the market.

If you are using generic standard analog 4-20mA instrument you can add this from standard analog list.

In case you have an instrument that is not in the database and is using Modbus or any other protocol please contact to add new instruments. Please attach data sheet and Modbus settings.


Adding elements

To add an element to your diagram:

  • in the palette on the right side of the canvas, select an element with single mouse click,
  • place it by second click on the canvas position where you want this element to be.

Elements in palette are symbols for equipment that you can use for schematic diagram. Elements include symbol for compressor, valve, end user point-junction, receiver, instrument, filter, dryer, pressure-flow controller, monitoring device, control device, custom, drain and text box.

Deleting and connecting elements

When you click on an element, it highlights and opens a context menu, where you can:

  • connect this element some other element by click on the tool icon in context menu and then clicking element you want to connect to (will change to green).
  • delete the selected element with X.

Saving, loading and exporting

This diagram editor supports exporting in .pid file format. You can save the file to your computer and load it as some later time to make new edits.
It also supports export in SVG image format that can be previewed in any image viewing software or edited in any vector editing software.
These actions can be performed with buttons on the top right of the editor.

NOTE: It is very important that correct PI&D schematic is correct and completely filled in with all equipment data from data sheets and name plates. All essential data must be also confirmed, blue dot is showing not confirmed data and red dot is showing missing essential data.


When you select an element from the canvas its properties panel opens on right of the canvas. Different elements have different properties you can edit. You can also upload images of the equipment.

Sensors - data collection

Monitoring data collection is configured using instruments or sensors. When an instrument is added to the diagram, you can select appropriate configuration from the CALMS database. This database is filtered by capabilities of your device and selected measurement quantities (i.e. power, flow, pressure…other).

Next step is to select device where you will connect sensor (only if you have multiple devices)

And finally you have to select sensor by name, quantity or manufacturer from sensor database. List of sensors depends from the device you have, communication links device can handle and selected equipment. There are also generic standard analog sensors that you can select and setup. If you select on PI&D compressors only compressor controllers or master controllers will be available to select.

If sensor is not listed and it is not generic type, please send inquiry for adding new sensor to []( “Support email”) . Please add sensor exact model and manufacturer, connection protocol, manual with addresses and special instructions if needed (like which parameters can be changed during setup)

Most configurations have at least some required fields that have to be filled for the successful connection, such as label of analog port or Modbus unit id. These fields can be found on the right of the canvas.

You can also attach instruments to any other equipment in the system using “Connect sensor” button.

When configuring your instruments, CALMS will create channels where collected data will be written to. When applicable, CALMS will ask you if you want to write data into existing channels.

Each channel has additional configuration settings, most of which are described below.

Sensor have element properties that must be filled on the right side. Standard sensor properties are divided in two sections:

  1. Instrument details with tag, image, model
  2. communication configuration if needed for modbus and other protocols
  3. measurement channel configuration

Under measurement channel configuration user must define channel label (default name is TAG + quantity), select input on device (analog or address or IP), signal range (min-max) and standard setting:

Sampling interval

Time rate at which device will collect measurements from instrument or controller. Default value is 5 sec, minimal value is 1 sec.

Upload interval

Time rate at which device will send collected data to the server. Default (and recommended) value is 5 min. Higher rates may incur additional data transfer fees.


The smallest change in signal measurements that will be measured and collected.

For example, if precision is set to 0.02 kW, and the values changes from 2.74 kW to 2.75 kW, the change will not be collected, and the value on the plot will show 2.74 kW. This greatly reduces amount of data transferred, allowing higher sampling intervals with same transfer rate.

If precision is set to -1 all values will be measured.

Zero filter

Any value with absolute value less than zero filter will be mapped into 0. This is useful when, for example, flow instrument equipment has measurement error and values fluctuate around 0, even producing negative values.

Analog 4-20mA settings

Output range min and max value. Select device input (usually A1..A8)

Modbus TCP IP Ethernet settings

Instruments with Modbus RTU communication have all default sensor parameters (registers, addresses, ..) already programmed in CALMS database, so you only select instrument by model and set necessary parameter: IP instrument address.

Modbus RTU 485 settings

Instruments with Modbus communication have all default sensor parameters (registers, addresses, communication baud, parity..) already programmed in CALMS database, so you only select instrument by model and set necessary parameters which can be actually changed on instrument like :Modbus Unit ID, Baud rate, data bits, stop bits and parity (but they are already set as instrument default values).

Compressors - data collection

Compressor is an active element that must be fully set with all necessary data in element properties part. Compressor uses some special channels with annotation :

  • Loaded
  • Running
  • Power
  • Flow

After you add new compressor please take a picture, prepare technical data-sheet or take a photo of compressor name-plate. You can use also Fill data and pick compressor from different databases (CAGI, OEMs..) or customer own data base.

Under compressor properties you must fill:

  1. Compressor details (you can use Fill database)

  2. Compressor data-sheets and measurements (power-flow-pressure, voltage, PF…) Those data are very important for calculations and initial benchmarking

  3. select and configure sensor that is used on compressor like CT -amps meter, power meter, compressor controller connection..

    Those signal are very important to measure and / or calculate compressor power, flow, loaded and running and alarm signal

  4. Configure channel will guide you through special channels annotations as described above. In some cases CALMS can do this automatically .

  5. User must add also communication configuration in case compressor controller or sensor is using some comm protocols like modbus..

    And finally user must do measurement channel configuration


Target page is the third part where you have to set all target Key Performance Indicators (KPI) that end user can monitor in Result page with target reference based on baseline or target.

User can add new indicator based on any channel or new calculation with Add indicator button.

The most important KPIs for CALMS are System channels which are channels for complete system. Those channels must be set for each system.

  • System pressure
  • System flow
  • System power
  • system specific power SSP

System will suggest also many more predefined indicators

  • custom indicator
  • total energy consumption TEC
  • system energy consumption SEC per unit production
  • part of non productive usage-waste PNPU
  • reliability
  • efficiency
  • isentropic efficiency
  • compressed air cost
  • energy cost for compressed air
  • savings opportunity
  • CO2 emissions total
  • CO2 emissions potential savings
  • pressure drop
  • dew point
  • wet, dry pressure

NOTE: Target values can be set also after one month of active monitoring when baseline can be identified. Pressure Min, Max, setup and critical must be set at system creation because those values are used in many system calculations.


Under channel page system manager can edit advance channel settings, add new channels like calculations, set alerts, alarms and warnings and also set channel as indicator or hide channel on inspect page.

NOTE: When system is created in CALMS and all channels created, system manager can print out SIGNAL LIST and perform field monitoring system setup and Instrumentation Qualification & Operational Qualification (IQ-OQ).

Calculation formula editor

Under channels page or analysis page you can add new calculations with formula editor.

1. Adding calculations

Calculations are very useful tools to get some additional information based on measured data. For example if you are measuring »Pressure before drying equipment« and »Pressure after drying equipment« you can calculate what is the pressure drop and this value you can link to an alarm output so that system notifies you when pressure drop across drying equipment is too high.



• In calculation channels only AI, AIP and DI, constants and CI-calculation inputs

• To select existing variable, channel or system constant use underscore sign _

• Maximal length of calculation formula is 255 characters;

• Calculations become active when they are defined ( if we define calculation today,

system will not calculate values from past but will start calculate from the time calculation is defined);

• Also when we »Edit« calculation the correction will apply from time calculation is edited.

1. Operators

• + (addition)

• - (subtraction)

• * (Multiplication)

• / (Division)

• ^ (Exponentiation)

• % (Modulo)

2. Comparison operators

• > (greater then)

• < (less than)

• >=, <= (greater or equal to, less or equal to)

• & (AND operator)

• | (OR operator)

3. Functions

• Ifelse

• abs: absolute value

• acos: arc cosine

• asin: arc sine

• atan: arc tangent

• cbrt: cubic root

• ceil: nearest upper integer

• cos: cosine

• cosh: hyperbolic cosine

• exp: euler’s number raised to the power (e^x)

• floor: nearest lower integer

• log: logarithm (base e)

• log10: logarithm (base 10)

• log2: logarithm (base 2)

• sin: sine

• sinh: hyperbolic sine

• sqrt: square root

• tan: tangent

• tanh: hyperbolic tangent

• signum: signum function


• We can define new calculation channel with simple formula: »AI1 + AI2« .That means system will sum up values from AI1 and AI2.

• We can also use AIP’s channels to calculate total power of the system: »AIP1 + AIP2 + AIP3 + AIP4«. System will sum up powers from compressors 1 to 4.

• Lets calculate total specific power in kWh/m3: »(AIP1+AIP2+AIP3+AIP4)/(AI2*60)«, where AIP1+AIP2+AIP3+AIP4 is total power of the system and AI2 is measured flow in m3/min

• We can also use DI’s channels for some Boolean operations: »DI1 & DI2«. The result is 1 (True) if DI1 and DI2 are true. The result is 0(False) if one of them is false.

• Ifelse function. We can also calculate capacity of the ON/OFF compressor based on ifelse function. Example: We have 160kW ON/OFF compressor 2 with 32,3 m3/min output capacity. Formula is: »ifelse((AIP2>130),32.3,0)«. Result is 32 if compressor’s power is greater than 130kW, if power is less than 130 kW result is 0.

Most typical sample calculations

• Calculate »Flow« (from air speed measured by a flowmeter):

Formula: ((3.14*D^2)/4)_AI2_60 [m3/min],

  • D=inner pipe diameter [m],
  • AI2=measured speed [m/s].

• Calculate »Compressor power« from measured current:

Formula: *_(AI3Voltage_sqrt(3)PF) [kW],

          AI3=measured current \[A\],

          Voltage=Line voltage \[V\],

          PF=Power factor (cosfi).

• Calculate «Compressor power« from measured current with different cosfi for

loaded/unloaded compressor state:

Formula: **ifelse((DI1), (AI3*Voltage*sqrt(3)*PF1),(AI3*U*sqrt(3)*PF2))**,\[kW\]

          AI3=measured current \[A\],

          Voltage=Line voltage \[V\],

          PF1=Power factor (cosfi) at loaded state,

          PF2=Power factor (cosfi) at unloaded state,

          DI1=digital input that is TRUE when compressor is loaded.

Channels alerts

Under Setup/Channels page when you select channel you can add as many alerts as you want with button Add alert.

CALMS is using two types of alerts linked to channels:

  • Warning
  • Alarm

For each alert select trigger- When value (is lower, equal or higher) enter trigger value and select alert type (warning, alarm).

Under Advanced options set

Ignore alerts shorter then (time)

Merge alerts that are less then (time) apart

CALMS will send alert to selected participant (all system users) on Email, SMS-text or application notification bar. Each user can set alert under Users/notifications menu.

Alerts are handled and acknowledge in Alert logs page.

Channel target

Under Setup/Channels page when you select channel you can add or manage targets (KPI) with button Add target.


Targets are set on monthly baseline period. In case you have daily target (recalculate for monthly target value (30 days)

Targets and KPI (Key Performance Indicators) are managed on Target page.


System manager can add new users or invite new users to CALMS system and add them with selected roles and permissions. System owner can add also expert to the system for audit. In case system owner can add also CALMS support user to help with system issues.

User can have different roles that have predefined permissions.

  • owner
  • assessment
  • monitoring
  • expert
  • custom

Permissions can be set only by system owner and will grant access for CALMS functions:

  • edit setup
  • edit permissions
  • assessment: view, survey, repair, delete, create
  • monitoring: view, manual, analysis, simulation
  • asset : events, TCO, compressor database, equipment
Arrow up icon