{"id":11084,"date":"2022-04-06T07:03:36","date_gmt":"2022-04-06T07:03:36","guid":{"rendered":"https:\/\/imperix.com\/doc\/?p=11084"},"modified":"2026-02-26T10:55:03","modified_gmt":"2026-02-26T10:55:03","slug":"log-message","status":"publish","type":"post","link":"https:\/\/imperix.com\/doc\/software\/log-message","title":{"rendered":"LOG – Write a log message"},"content":{"rendered":"\n

This block writes a user-defined message in the log module of Cockpit<\/a>.<\/p>\n\n\n

\n
\"\"
Log module of Cockpit<\/figcaption><\/figure>\n<\/div>\n\n\n

Numerical values can be inserted into the message using the conversion specifier “%f<\/code>“, that will take to the value of the second input signal. This block only supports floating-point numbers. Optionally, the number of digits displayed after the decimal point can be specified using the precision modifier \".\"<\/code>. Here are some examples:<\/p>\n\n\n\n

Log message<\/code> field<\/th>Input value<\/th>Message displayed in the log module<\/th><\/tr><\/thead>
The value is: %f<\/td>3.141592653<\/td>The value is: 3.141593<\/td><\/tr>
The value is: %.3f<\/td>3.141592653<\/td>The value is: 3.142<\/td><\/tr>
The value is: %.0f<\/td>3.141592653<\/td>The value is: 3<\/td><\/tr>
The value is: %f<\/td>3<\/td>The value is: 3.000000<\/td><\/tr>
The value is: %.3f<\/td>3<\/td>The value is: 3.000<\/td><\/tr>
The value is: %.0f<\/td>3<\/td>The value is: 3<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Note that the maximum length of a log message is 256 characters and the maximum amount of different log messages is 128.<\/p>\n\n\n\n

Signal specification<\/h3>\n\n\n\n
\n
\n
    \n
  • The first input is a trigger port that generates a log message when its value rises from a negative or zero value to a positive value.<\/li>\n\n\n\n
  • The second input is only visible when Include variables in message<\/code> is checked. It is used to input numerical value(s) into the message. The value(s) are sampled when the log message is triggered.
    Its width is defined by the parameter Number of variables<\/code> and must also correspond to the number of conversion specifiers contained in the message.<\/li>\n<\/ul>\n<\/div>\n\n\n\n
    \n
    \"\"<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

    Parameters<\/h3>\n\n\n\n
      \n
    • Log message<\/code> is the message that will be displayed in the log module of Cockpit.<\/li>\n\n\n\n
    • String type<\/code> indicates whether the Log message<\/code> field contains a literal text string or an expression that should be evaluated.<\/li>\n\n\n\n
    • Severity<\/code> defines the type of message (Info, Warning, or Error). The log module of Cockpit lets you filter the displayed message by severity.<\/li>\n\n\n\n
    • Include variables in message<\/code> indicates if numerical values are inserted in the message using the %f<\/code> placeholder. If checked, a second port appears to input the numerical values.<\/li>\n\n\n\n
    • Number of variables<\/code> is the number of numerical values that are inserted into the message. This field is only visible if Include variables in message<\/code> is checked.<\/li>\n<\/ul>\n\n\n\n
      \n
      \n
      \"\"<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

      PLECS block<\/h2>\n\n\n\n

      Signal specification<\/h3>\n\n\n\n
      \n
      \n
        \n
      • The first input is a trigger port that generates a log message when its value rises from a negative or zero value to a positive value.<\/li>\n\n\n\n
      • The second input is only visible when Include variables in message<\/code> is checked. It is used to input numerical value(s) into the message. The value(s) are sampled when the log message is triggered.<\/li>\n\n\n\n
      • Its width is defined by the parameter Number of variables<\/code> and must also correspond to the number of conversion specifiers contained in the message.<\/li>\n<\/ul>\n<\/div>\n\n\n\n
        \n
        \"\"<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

        Parameters<\/h3>\n\n\n\n
          \n
        • Log message<\/code> is the message that will be displayed in the log module of Cockpit.<\/li>\n\n\n\n
        • String type<\/code> indicates whether the Log message<\/code> field contains a literal text string or an expression that should be evaluated.<\/li>\n\n\n\n
        • Severity<\/code> defines the type of message (Info, Warning, or Error). The log module of Cockpit lets you filter the displayed message by severity.<\/li>\n\n\n\n
        • Include variables in message<\/code> indicates if numerical values are inserted in the message using the %f<\/code> placeholder. If checked, a second port appears to input the numerical values.<\/li>\n\n\n\n
        • Number of variables<\/code> is the number of numerical values that are inserted into the message. This field is only visible if Include variables in message<\/code> is checked.<\/li>\n<\/ul>\n\n\n\n
          \n
          \n
          \"\"<\/figure>\n<\/div><\/div>\n<\/div>\n\n\n\n

          C++ functions<\/h2>\n\n\n