PawnLibs/log

Description

Interfaces for printing log messages. They accept format string similar to the C language with format specifiers - subsequences beginning with %. A format specifier follows this prototype:

1    %[flags][width][.precision]specifier
2 

Specifiers:

• c - single character
• d - integer number
• f,r - floating point number
• q,r - fixed point number
• s - string
• x - hex value
• % - % character

Flags:

• - - Left-justify within the given field width; Right justification is the default
• + - Forces to preceed the result with a plus or minus sign (+ or -) even for positive numbers. By default, only negative numbers are preceded with a - sign.
• 0 - Left-pads the number with zeroes (0) instead of spaces when padding is specified

Width - minimum number of characters to be printed. If the value to be printed is shorter than this number, the result is padded with blank spaces. The value is not truncated even if the result is larger. Precision - this is the number of digits to be printed after the decimal point. The additional arguments following format are formatted and inserted in the resulting string replacing their respective specifiers TBD: check specification

Log output contains module number, severity level, application name and timestamp. They saved on flash in a ring buffer - older messages will be overridden.

Log filters - currently hardcoded, platform does not provide to configure filters, TBD: describe default filters and how to configure them

View logs - only python scripts are available, SDK support TBD: describe log dump, BT in real time, buffering nature, synchronization between modules

PawnLibs/log/LOG_a

Summary

Print an assert log message and stop application execution.

Synopsis

1native LOG_a(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string

PawnLibs/log/LOG_d

Summary

Print a debug log message.

Synopsis

1native LOG_d(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string

PawnLibs/log/LOG_e

Summary

Print an error log message.

Synopsis

1native LOG_e(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string

PawnLibs/log/LOG_i

Summary

Print an information log message.

Synopsis

1native LOG_i(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string

PawnLibs/log/LOG_v

Summary

Print a verbose log message.

Synopsis

1native LOG_v(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string

PawnLibs/log/LOG_w

Summary

Print a warning log message.

Synopsis

1native LOG_w(const format[], {Float,Fixed,_}:...);
2 

Inputs

• format - format string
• ... - variable values to insert in the resulting string