Arduino用のsyslogプロトコルライブラリhttps://github.com/arcao/Syslogを拡張し，シリアル出力やファイルへの保存に対応したライブラリです． また，オリジナルのライブラリは時刻情報に対応していないため，RTCやNTPと連携する機能も追加しています．
syslogプロトコルに関する詳細はオリジナルのライブラリを参照してください．
動作を確認した環境は以下の表の通り．
| CPUアーキ | 本体 | ネットワークI/F | SD I/F | RTC | ソフトシリアル |
|---|---|---|---|---|---|
| AVR | Arduino Mega 2560 R3 | Ethernet Shield 2 | Ethernet Shield 2 | RTC-8564NB | FT234XD |
| AVR | 同上 | 同上 | 同上 | DS1307 | － |
| SAMD | Arduino MKR WiFi 1010 | NINA-W102(内蔵) | Adafruit MicroSD card breakout board+ | RTC-8564NB | － |
| ESP32 | ESPr Developer 32 | ESP32内蔵WiFi | Adafruit MicroSD card breakout board+ | RTC-8564NB | － |
以下のライブラリをインストールしてください．
アプリをコンパイルする際に，このライブラリの「syslog_config.h」を編集して，必要な機能だけを生かしてください．
#define _SYSLOG_USE_NETWORK // syslogプロトコルでサーバに送る機能
#define _SYSLOG_USE_FILE // ファイルにログを保存する機能
#define _SYSLOG_USE_HARDWARE_SERIAL // ログをハードウェアシリアルに出力する機能
#define _SYSLOG_USE_SOFTWARE_SERIAL // ログをソフトシリアルに出力する機能
#define _SYSLOG_OUTPUT_TIME // 時刻情報を出力する機能(以下の両方をコメントアウトした場合はmillis()の出力を利用)
#define _SYSLOG_USE_RTC // 時刻情報をRTCから取得
#define _SYSLOG_USE_NTP // 時刻情報をNTPで取得
使わない機能の定義をコメントアウトすることで，本ライブラリの不要な機能を削るだけでなく，上記のRTCやNTPなどのライブラリもリンクされないので，メモリやバイナリサイズの圧縮に役立ちます．
syslogオブジェクトの生成は，引数としてデバイス名，アプリ名，syslogのプライオリティ(種別情報とfacilityの論理OR))を用いて行います．
Syslog(const char* deviceHostname = SYSLOG_NILVALUE, const char* appName = SYSLOG_NILVALUE, uint16_t priDefault = LOG_KERN)
ログの種別情報は以下の8個．
#define LOG_EMERG 0 /* system is unusable */
#define LOG_ALERT 1 /* action must be taken immediately */
#define LOG_CRIT 2 /* critical conditions */
#define LOG_ERR 3 /* error conditions */
#define LOG_WARNING 4 /* warning conditions */
#define LOG_NOTICE 5 /* normal but significant condition */
#define LOG_INFO 6 /* informational */
#define LOG_DEBUG 7 /* debug-level messages */
ファシリティは以下の通り．
#define LOG_KERN (0<<3) /* kernel messages */
#define LOG_USER (1<<3) /* random user-level messages */
#define LOG_MAIL (2<<3) /* mail system */
#define LOG_DAEMON (3<<3) /* system daemons */
#define LOG_AUTH (4<<3) /* security/authorization messages */
#define LOG_SYSLOG (5<<3) /* messages generated internally by syslogd */
#define LOG_LPR (6<<3) /* line printer subsystem */
#define LOG_NEWS (7<<3) /* network news subsystem */
#define LOG_UUCP (8<<3) /* UUCP subsystem */
#define LOG_CRON (9<<3) /* clock daemon */
#define LOG_AUTHPRIV (10<<3) /* security/authorization messages (private) */
#define LOG_FTP (11<<3) /* ftp daemon */
#define LOG_LOCAL0 (16<<3) /* reserved for local use */
#define LOG_LOCAL1 (17<<3) /* reserved for local use */
#define LOG_LOCAL2 (18<<3) /* reserved for local use */
#define LOG_LOCAL3 (19<<3) /* reserved for local use */
#define LOG_LOCAL4 (20<<3) /* reserved for local use */
#define LOG_LOCAL5 (21<<3) /* reserved for local use */
#define LOG_LOCAL6 (22<<3) /* reserved for local use */
#define LOG_LOCAL7 (23<<3) /* reserved for local use */
デバイス名，アプリ名，デフォルトのプライオリティを再設定するためのAPI．
void SetLogInfo(const char* deviceHostname = SYSLOG_NILVALUE, const char* appName = SYSLOG_NILVALUE, uint16_t priDefault = LOG_KERN)
個別の設定のみを書き換えるAPIは以下の3種類．
Syslog &deviceHostname(const char* deviceHostname)
Syslog &appName(const char* appName)
Syslog &defaultPriority(uint16_t pri = LOG_KERN)
プライオリティが低いログを無視する(サーバへ送信したりファイルに保存しない)ためのマスク値を設定するためのAPI．
Syslog &logMask(uint8_t priMask)
syslogプロトコルでの送信を行うための設定を行うAPI．第3引数はプロトコルの種別を「SYSLOG_PROTO_IETF(RFC 5424)」と「SYSLOG_PROTO_BSD(RFC 3164)」から選択可能ですが，この引数を省略した場合は「SYSLOG_PROTO_IETF(RFC 5424)」になります．またサーバは文字列もしくはIPアドレスで指定できます．
void SetProtocol(UDP &client, uint8_t protocol = SYSLOG_PROTO_IETF);
void SetProtocol(UDP &client, const char* server_name, uint16_t port, uint8_t protocol = SYSLOG_PROTO_IETF);
void SetProtocol(UDP &client, IPAddress ip, uint16_t port, uint8_t protocol = SYSLOG_PROTO_IETF);
サーバの情報だけを設定するAPI．
Syslog &server(const char* server, uint16_t port);
Syslog &server(IPAddress ip, uint16_t port);
syslogプロトコルでの送信を止めるAPI．
void UnsetProtocol(void);
ログをファイルに保存する機能を有効化するためのAPIで，アプリケーションでログファイルをオープンし，引数として与えてください．なお，このAPIを呼び出すと，引数で指定したファイルの最後までファイルポインタを進めます．そのため，既存のファイルを引数として与えると追記する動作となります．
bool SetFile(File *file);
下のAPI関数はログをファイルに書き込む機能を停止するAPIです．
void UnsetFile(void);
ハードウェアシリアルにログを出力するための機能を有効にするAPIです．第1引数にログを出力するハードウェアシリアルへのポインタを用いてください．
void SetSerial(HardwareSerial *serial);
LeonardoやMKR系ボードでは，SerialやSerial1がHardwareSerialではなく，Serial_やUart型の場合があるため，LeonardoなどでSerialにログを出力場合に利用してください．なお，どの機種が対応するかは，この資料を参照してください．
void SetSerial(Serial_ *serial);
void SetSerial(Uart *serial);
ソフトシリアルにログを出力するための設定を行うAPIは以下の関数となります．
void SetSerial(SoftwareSerial *serial);
シリアルにログを出力する機能を無効化するためのAPIになります．
void UnsetSerial(void);
シリアルにログを出力する場合，利用できるシリアルはハードウェアシリアル，ソフトシリアルのうち1つに限られますので，ご注意ください．
ログに埋める時刻情報をRTCから取得するための設定用API．
第2引数は以下の値のどちらかを与えます．
#define EPOCH_TIME 0 /* unix time */
#define DATE_TIME 1 /* date format */
bool SetRtc(RTC_Unified *rtc, uint8_t format)
時刻情報をNTPで取得する場合の設定API．NTPクライアントの設定はアプリケーション側で行い，クライアントオブジェクトへのポインタを第1引数として与えます．
bool SetNTP(NTPClient *client, uint8_t format)
本ライブラリでは，以下のAPIを用いてログメッセージを出力する場合，上記の設定APIで選択したすべての出力先にログメッセージが出力されます． なお，各APIについての引数の意味などの詳細は，オリジナルのライブラリを参照してください．
bool log(const __FlashStringHelper *message)
bool log(const String &message)
bool log(const char *message)
bool log(uint16_t pri, const __FlashStringHelper *message)
bool log(uint16_t pri, const String &message)
bool log(uint16_t pri, const char *message)
bool vlogf(uint16_t pri, const char *fmt, va_list args)
bool vlogf_P(uint16_t pri, PGM_P fmt_P, va_list args)
bool logf(uint16_t pri, const char *fmt, ...)
bool logf(const char *fmt, ...)
bool logf_P(uint16_t pri, PGM_P fmt_P, ...)
bool logf_P(PGM_P fmt_P, ...)