arrow_back_ios

Main Menu

See All ソフトウェア See All 計測器 See All トランスデューサ See All 振動試験装置 See All 電気音響 See All 音響エンドオブライン試験システム See All アプリケーション See All 各産業 See All インサイト See All 校正(キャリブレーション) See All エンジニアリングサービス See All サービス See All サポート See All 当社の事業 See All 私たちの歴史 See All サステナビリティ(持続可能性)への取り組み See All グローバルな事業展開
arrow_back_ios

Main Menu

See All 解析シミュレーション See All DAQ See All APIドライバ See All ユーティリティ See All 振動コントロール See All 校正 See All DAQ See All ハンドヘルド See All 産業用電子機器 See All パワーアナライザ See All シグナルコンディショナー See All 音響トランスデューサ See All 電流電圧 See All 変位 See All 力センサ See All ロードセル See All マルチコンポーネント See All 圧力 See All ひずみ See All ひずみゲージ See All 温度 See All 傾斜センサー See All トルク See All 振動トランスデューサ See All アクセサリ See All コントローラ See All 測定加振器 See All モーダル加振器 See All パワーアンプ See All 加振器システム See All テストソリューション See All アクチュエータ See All 内燃機関 See All 耐久性 See All eDrive See All 生産テストセンサ See All トランスミッションギアボックス See All ターボチャージャ See All 音響 See All 設備とプロセスの監視 See All カスタムセンサ See All データの取得と分析 See All 耐久性および疲労 See All Electric Power Testing(電力テスト) See All NVH See All 信頼性 See All スマートセンサ See All 振動 See All 計量 See All 自動車および地上輸送 See All 圧力校正|センサー|振動子 See All 校正・修理のご依頼 See All キャリブレーションとベリフィケーション See All キャリブレーション・プラス契約 See All 校正 See All インストール、メンテナンス、修理 See All サポート :ブリュエル・ケアー製品 See All Release Notes See All コンプライアンス (Compliance) See All Our People
arrow_back_ios

Main Menu

See All nCode - 耐久性および疲労解析 See All ReliaSoft - 信頼性解析と管理 See All API See All 電気音響 See All 音源探査(Noise source identification, NSI) See All 環境騒音 See All 音響パワーと音圧 See All 騒音認証 See All 産業用プロセスコントロール See All 構造ヘルスモニタリング See All 電気デバイス試験 See All 電気システム試験 See All グリッド試験 See All 高電圧試験 See All 導電加振機による振動試験 See All 構造力学 See All 機械分析と診断 See All プロセス計量 See All 車両の電動化 See All pages-not-migrated See All トランスデューサの校正サービス See All ハンドヘルド測定器の校正サービス See All 機器およびDAQの校正サービス See All 現地での校正 See All リソース See All ソフトウェアライセンス管理

Downloads for catman Data Acquisition Software

Title  Description Date  Version Related Documents
catman Easy / AP / PostProcess Software for data acquisition, visualization, analysis and reporting of measurement data for your PC or QuantumX/SomatXR Data Recorder. 03/2025 5.6.4 Release Notes
Plugin for DIAdem / catman This plugin allows you to open .bin files from HBM catman directly in DIAdem. 07/2013 1.9.0  

Some of the New Features in catman Version 

chevron_left
chevron_right

New Features in catman 5.6.4

  • Kistler KiRoad interface improved
  • Improved handling of Liebherr IP cameras
  • CAN raw in FastStream files
  • Numerous bug fixes

New Features in catman 5.6.3

  • Loading projects with multiple cameras
  • Improvements to MQTT topics
  • Improved data displays in certain scenarios

MQTT data streaming in catman

 

MQTT is an open publish-subscribe network protocol for machine-to-machine communication. The MQTT protocol defines two types of network entities: a broker and a number of clients.

An MQTT broker is a server that receives all messages from clients and then forwards the messages to the appropriate destination clients. An MQTT client is any device (controller, PC, server) running an MQTT library that connects to an MQTT broker over a network. catmanAP works as MQTT client and can provide data for other clients.

Enable the MQTT functionality in catmanAP via Options -> Program functions. In catmanEasy the functionality is not available. catman sends MQTT data to the MQTT broker after each catman read block. This means that the data is sent with about 10 Hz when - and only when - a data acquisition (DAQ job) is running.

Note: If you activate MQTT in a running DAQ project, you have to restart catman.

How to proceed

 

Start a new or an existing project in catman and go to the DAQ channels tab. In the right area of the Ribbon you will find the group MQTT if the option MQTT data streaming is active.

 

Configuring the MQTT data stream

 

The information is organized in a hierarchy of topics. Topics are quasi containers that can contain multiple messages (multiple channels of catman). The broker then distributes the information to all clients that have registered for the respective topic.

The structure of the MQTT topics is freely editable. That is, you can freely define the number of topics, their names, and the nesting of topics. Use topics to differentiate channels by sensor type or by location, or both.

catman's MQTT function offers three settings for configuring the data stream:

 

  1. MQTT config topics to configure the topic structure in which the data is to be sent.
  2. MQTT config to configure the network properties of the MQTT broker.
  3. Additional settings specific to the channels transmitted via MQTT.

MQTT Topic Configuration


The type of information that catman can send over MQTT consists of channel data. You can send any channel in catman (hardware channel, time channel, calculation channel or auxiliary channel) via MQTT. The name of the parameter in MQTT is the channel name of catman.
 

In the topic settings you have the choice between the 3 standard MQTT service levels (Quality of Service, QoS):

0 - At most once: packets are sent without an acknowledgement of receipt.

1 - At least once: the sender receives an acknowledgement that the recipient has received the packet.

2 - Exactly once: the sender receives a double confirmation from the recipient.

Level 0 provides the least security, but is the fastest way to transmit data. In contrast, level 2 provides the best security, but is slower.

The Retained on option refers to MQTT Retained Messages. In this case, the broker caches and transmits the last value for the topic (rather than the entire history from the past). Retained messages are useful for a newly added client, as it immediately receives data from the MQTT broker, even if no (new) data was sent at the time of subscription.

To create a new topic, click on  below the topic window. It will then be inserted as a subtopic of the currently selected topic. To rename the topic, click on it.

To add signals to a topic, highlight the topic and select one or more channels from the channel list at the bottom of the window. Select multiple channels as usual with SHIFT or CTRL. Then click  (Add catman channel...) on the right side.

The channels assigned to each topic are displayed in the topic's channel list (Channels) on the right side of the window when you select the topic.

Click Apply topic settings before exiting the window.

Advanced channel functions


The window allows you to add a calculation that will be sent as an additional MQTT signal in the selected topic. In doing so, no calculation is created in catman, the calculation exists only in the MQTT data stream. In the current version, only one FFT calculation is available.
Select a topic and access the advanced channel functions by clicking on under the topic channel list (Channels).
If you activate Publish only calculations, not the original values but only the calculations will be transmitted.


MQTT Configuration


Use MQTT config to specify the MQTT broker and the options for the data transfers.
You can specify both an IP address, a computer or a server name in the IP address field. The Port is set automatically when you select the security mode, but you can change it.
The Client Identifier (Client Id) identifies each MQTT client that connects to an MQTT broker. The broker also uses the Client Id to determine the current status of the client. Therefore, this Id should be unique per client and broker.
Whether username and password are required depends on your MQTT broker.
The same applies to the Security mode. Different modes are supported in the current version. Each security mode uses a different port. Therefore, the port is automatically changed to the default port when you select a mode. However, brokers may use other ports, so check the broker you are using.
 

Extended MQTT settings


The Automatic reconnection on option allows you to reconnect if contact with the MQTT broker is lost. catman will then try to reconnect in the time specified in the Reconnecting time field. The default value is 5 seconds.
 

MQTT DAQ settings

If desired, you can (temporarily) deactivate the MQTT data transmission. In this case, all settings (topics and channels) remain unchanged. Otherwise, the data is sent by catman after the start of a DAQ job and as long as it is running. No data is sent during the setup phase of a DAQ project or after the DAQ job has been stopped.

Extended MQTT settings

The Automatic reconnection on option allows you to reconnect if contact with the MQTT broker is lost. catman will then try to reconnect in the time specified in the Reconnecting time field. The default value is 5 seconds.

MQTT DAQ settings

If desired, you can (temporarily) deactivate the MQTT data transmission. In this case, all settings (topics and channels) remain unchanged. Otherwise, the data is sent by catman after the start of a DAQ job and as long as it is running. No data is sent during the setup phase of a DAQ project or after the DAQ job has been stopped.

Additional settings


The additional settings allow you to specify the buffer (expressed in the number of data points) used to determine the moving average of the signal into the MQTT JSON array (see Appendix for more information).


MQTT-Status

As soon as data acquisition is running in catman, the MQTT group in the Visualization tab shows you the status of broker and data stream.

Broker and Transmit green: the connection to the MQTT broker has been made and data is being transmitted.

Broker green, Transmit yellow: the connection to the MQTT broker has been made, but no data is being transmitted (MQTT data transmission OFF in the options).

Broker red, Transmit yellow: the connection to the MQTT broker has failed, the transmitted data cannot reach its destination. Check the settings of the MQTT broker.

Both LEDs are yellow: the MQTT broker is visible, but a connection is not possible Check user and password as well as the security mode.

Both LEDs are red: data collection is not running, no connection has been established and no data is being sent.


Creating Alarms


You have several options to create alarms in catman. However, for use in MQTT you have to convert each alarm into a channel, because only channels are sent via MQTT.


Method 1 - Computation channel

This is the simplest method. Create a computation channel that packages the alarm into a channel that switches from the default value of zero to an alarm value.
To do this, call up the Edit computation window via New (DAQ channels tab, Computation channels group). Open the list box under Additional functions, select if(Condition,True,False) and click . Then replace the texts Condition, True and False.
In the above illustration, the formula creates a computation channel that takes the value 1 when the StaticStrain1 channel exceeds the limit of 1500. As long as the StaticStrain1 channel does not exceed this value, the calculation always results in 0.
You can also create a symmetrical calculation if you want to monitor minimum and maximum at the same time. To check a minimum and a maximum value separately, you must create two calculations.


Method 2 - Auxiliary channel based on limit values or events

Limits and events are a standard catman function that you can use to organise alarm and warning conditions and that gives you more flexibility than creating computation channels. The disadvantage of this method is that transmitting the results to an MQTT broker requires an auxiliary channel and some EasyScript. However, part of the script is already preconfigured and you will find the commands still missing for this function in this section.
Each limit of the type High level crossing or Low level crossing can use two levels:
1. Warning level
2. Alarm level
The warning level must be smaller (in absolute values) than the alarm level. Selecting alarm and/or warning levels allows you to set a double alarm when monitoring channels, with the first level triggered by the warning value and the second level triggered by the alarm value.
Based on the triggered warning or alarm values, you can take various actions. The lower tabs of the window provide many options for selecting actions to be taken when the warning/alarm values are met. This alarm definition is assigned by selecting the channel on the DAQ channels tab and suing Assign (Limit values/events group).
However, these actions are limited to catman. To be able to send a notification via MQTT, you have to create an auxiliary channel and transfer the warning or alarm messages to it via EasyScript.
Click on Auxiliary channel (Computation channels group) and give the channel a name.
Click Edit script code in the dialogue to call up the catman EasyScript Code Editor. Part of the code for filling the auxiliary channel with values is already written, you just need to add a few lines.


Insert after the line Dim Count As Integer:

Dim Status As Integer

Insert before the line For Count = 0 To SampleCount - 1:

EA_DAQ.GetLIVState("Channel name", N, Status)

Here, Channel name is the exact name of the channel. Be sure to enclose it in quotes as it is a string (text). N is the number of the limit assigned to the channel. 1 is the first, 2 the second, etc. Status is the name of the variable you added to the declaration section.

Then replace the line 'MVBuf(1) = ... with

MVBuf(Count) = Status

and close the Code Editor.

Make sure you select a reference channel for the time interval before clicking OK and creating the auxiliary channel. This will place the auxiliary channel in the correct sample rate group. We recommend taking the channel that is being monitored.

null

catman Knowledge Base

Learn more about catman data acquisition software with our video tutorials, tech-notes, trainings and case studies.

null

Download Archive

Find all catman data acquisition software downloads from version 5.0.1 onwards in our download archive. 

null

Going the Extra Mile: Our Excellent Software Maintenance

  • Our professional technical support center will assist you by email, telephone and/or remote
  • Twelve-month software maintenance package included after purchase
  • Upgrades & Updates free of charge during the maintenance contract period
  • Get your catman knowledge up to date with our HBK Academy and benefit from a 15% discount after purchase

Related Product

No more result to load