Günlük Kaydı - İleti Dizisi Yığını

Bu modülde OpenThread günlük kaydıyla ilgili tanımlar bulunur.

Özet

İşlevler
otDumpCritPlat(const char *aText, const void *aData, uint16_t aDataLength)	void void void void void void Kritik günlük düzeyinde bellek dökümü oluşturur.
otDumpDebgPlat(const char *aText, const void *aData, uint16_t aDataLength)	void Hata ayıklama günlük düzeyinde bellek dökümü oluşturur.
otDumpInfoPlat(const char *aText, const void *aData, uint16_t aDataLength)	void Bilgi günlüğü düzeyinde bellek dökümü oluşturur.
otDumpNotePlat(const char *aText, const void *aData, uint16_t aDataLength)	void Not günlük düzeyinde bellek dökümü oluşturur.
otDumpWarnPlat(const char *aText, const void *aData, uint16_t aDataLength)	void Uyarı günlüğü düzeyinde bellek dökümü oluşturur.
otLogCli(otLogLevel aLogLevel, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2	void Belirli bir günlük düzeyinde günlük mesajı oluşturur.
otLogCritPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void Kritik günlük düzeyinde günlük mesajı yayınlar.
otLogDebgPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void void void Hata ayıklama günlük düzeyinde bir günlük mesajı oluşturur.
otLogGenerateNextHexDumpLine(otLogHexDumpInfo *aInfo)	otError Sonraki onaltılık döküm satırını oluşturur.
otLogInfoPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void void Bilgi günlüğü düzeyinde günlük mesajı yayınlar.
otLogNotePlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void void Not günlük düzeyinde günlük mesajı yayınlar.
otLogPlat(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3	void Platform modülü adı kullanarak belirli bir günlük düzeyinde günlük mesajı yayınlar.
otLogPlatArgs(otLogLevel aLogLevel, const char *aPlatModuleName, const char *aFormat, va_list aArgs)	void void Platform modülü adı kullanarak belirli bir günlük düzeyinde günlük mesajı yayınlar.
otLogWarnPlat(const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1	void void Uyarı günlüğü düzeyinde günlük mesajı oluşturur.
otLoggingGetLevel(void)	otLogLevel Geçerli günlük düzeyini döndürür.
otLoggingSetLevel(otLogLevel aLogLevel)	otError Günlük düzeyini ayarlar.

Yapılar
otLogHexDumpInfo	Onaltılık döküm çıktısı oluşturmak için kullanılan bilgileri temsil eder.

İşlevler

otDumpCritPlat

void void void void void void otDumpCritPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Kritik günlük düzeyinde bellek dökümü oluşturur.

OPENTHREAD_CONFIG_LOG_PLATFORM veya OPENTHREAD_CONFIG_LOG_PKT_DUMP ayarlanmazsa ya da geçerli günlük düzeyi kritik değerinin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aText Baytlardan önce yazdırılan bir dize. [in] aData Veri arabelleğine işaret eden bir işaretçi. [in] aDataLength aData cinsinden bayt sayısı.

otDumpDebgPlat

void otDumpDebgPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Hata ayıklama günlük düzeyinde bellek dökümü oluşturur.

OPENTHREAD_CONFIG_LOG_PLATFORM veya OPENTHREAD_CONFIG_LOG_PKT_DUMP ayarlanmazsa ya da geçerli günlük düzeyi hata ayıklamanın altındaysa bu işlev herhangi bir günlük mesajı vermez.

Ayrıntılar
Parametreler	[in] aText Baytlardan önce yazdırılan bir dize. [in] aData Veri arabelleğine işaret eden bir işaretçi. [in] aDataLength aData cinsinden bayt sayısı.

otDumpInfoPlat

void otDumpInfoPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Bilgi günlüğü düzeyinde bellek dökümü oluşturur.

OPENTHREAD_CONFIG_LOG_PLATFORM veya OPENTHREAD_CONFIG_LOG_PKT_DUMP ayarlanmazsa ya da geçerli günlük düzeyi bilginin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aText Baytlardan önce yazdırılan bir dize. [in] aData Veri arabelleğine işaret eden bir işaretçi. [in] aDataLength aData cinsinden bayt sayısı.

otDumpNotePlat

void otDumpNotePlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Not günlük düzeyinde bellek dökümü oluşturur.

OPENTHREAD_CONFIG_LOG_PLATFORM veya OPENTHREAD_CONFIG_LOG_PKT_DUMP ayarlanmazsa ya da geçerli günlük düzeyi bunun altındaysa bu işlevin herhangi bir günlük mesajı yayınlamadığını unutmayın.

Ayrıntılar
Parametreler	[in] aText Baytlardan önce yazdırılan bir dize. [in] aData Veri arabelleğine işaret eden bir işaretçi. [in] aDataLength aData cinsinden bayt sayısı.

otDumpWarnPlat

void otDumpWarnPlat(
  const char *aText,
  const void *aData,
  uint16_t aDataLength
)

Uyarı günlüğü düzeyinde bellek dökümü oluşturur.

OPENTHREAD_CONFIG_LOG_PLATFORM veya OPENTHREAD_CONFIG_LOG_PKT_DUMP ayarlanmazsa ya da geçerli günlük düzeyi uyarının altındaysa bu işlev herhangi bir günlük mesajı vermez.

Ayrıntılar
Parametreler	[in] aText Baytlardan önce yazdırılan bir dize. [in] aData Veri arabelleğine işaret eden bir işaretçi. [in] aDataLength aData cinsinden bayt sayısı.

otLogCli

void otLogCli(
  otLogLevel aLogLevel,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2

Belirli bir günlük düzeyinde günlük mesajı oluşturur.

Yalnızca KSA tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_CLI ayarlanmazsa veya geçerli günlük düzeyi, belirtilen günlük düzeyinin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aLogLevel Günlük düzeyi. [in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogCritPlat

void otLogCritPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Kritik günlük düzeyinde günlük mesajı yayınlar.

Platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi kritik değerin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogDebgPlat

void void void void void otLogDebgPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Hata ayıklama günlük düzeyinde bir günlük mesajı oluşturur.

Platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi hata ayıklamanın altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogGenerateNextHexDumpLine

otError otLogGenerateNextHexDumpLine(
  otLogHexDumpInfo *aInfo
)

Sonraki onaltılık döküm satırını oluşturur.

Onaltılık döküm çıktısını satır satır oluşturmak için bu yöntemi arka arkaya çağırabilir. İlk çağrıda aInfo içindeki mIterator alanı sıfır olarak ayarlanmalıdır.

Oluşturulan onaltılık döküm çıktısının bir örneğini burada görebilirsiniz:

"==========================[{mTitle} len=070]============================" "| 41 D8 87 34 12 FF FF 25 | 4C 57 DA F2 FB 2F 62 7F | A..4...%LW.../b. |" "| 3B 01 F0 4D 4C 4D 4C 54 | 4F 00 15 15 00 00 00 00 | ;..MLMLTO....... |" "| 00 00 00 01 80 DB 60 82 | 7E 33 72 3B CC B3 A1 84 | ......`.~3r;.... |" "| 3B E6 AD B2 0B 45 E7 45 | C5 B9 00 1A CB 2D 6D 1C | ;....E......-m. |" "| 10 3E 3C F5 D3 70 | | .><..p |" "------------------------------------------------------------------------"

Ayrıntılar
Parametreler	[in,out] aInfo Onaltılık döküm oluşturmak için kullanılacak otLogHexDumpInfo işaretçisi.
Döndürülen Değerler	OT_ERROR_NONE Sonraki satır başarıyla oluşturuldu. aInfo tablosundaki mLine alanı güncellendi. OT_ERROR_NOT_FOUND Sona ulaşıldı ve oluşturulacak satır kalmadı.

otLogInfoPlat

void void void void otLogInfoPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Bilgi günlüğü düzeyinde günlük mesajı yayınlar.

Platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi bilginin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogNotePlat

void void void otLogNotePlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Not günlük düzeyinde günlük mesajı yayınlar.

Platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi notun altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogPlat

void otLogPlat(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(3

Platform modülü adı kullanarak belirli bir günlük düzeyinde günlük mesajı yayınlar.

Bu, platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi aLogLevel değerinin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

aPlatModuleName adı, P-{PlatModuleName}--- biçimine uygun olarak yayınlanan günlük mesajında günlük modülü adını belirlemek için kullanılır. Yani "P-" ön ek dizesi bunun bir platform alt modülü olduğunu belirtmek için eklenir. Ardından, PlatModuleName dizesinin sonraki 12 karakteri gelir. Bölge adının 14 karakter uzunluğunda olmasını sağlamak için sonuna dolgulu tireler - eklenir.

Ayrıntılar
Parametreler	[in] aLogLevel Günlük düzeyi. [in] aPlatModuleName Platform alt modül adı. [in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogPlatArgs

void void otLogPlatArgs(
  otLogLevel aLogLevel,
  const char *aPlatModuleName,
  const char *aFormat,
  va_list aArgs
)

Platform modülü adı kullanarak belirli bir günlük düzeyinde günlük mesajı yayınlar.

Bu, platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi aLogLevel değerinin altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

aPlatModuleName adı, P-{PlatModuleName}--- biçimine uygun olarak yayınlanan günlük mesajında günlük modülü adını belirlemek için kullanılır. Yani "P-" ön ek dizesi bunun bir platform alt modülü olduğunu belirtmek için eklenir. Ardından, PlatModuleName dizesinin sonraki 12 karakteri gelir. Bölge adının 14 karakter uzunluğunda olmasını sağlamak için sonuna dolgulu tireler - eklenir.

Ayrıntılar
Parametreler	[in] aLogLevel Günlük düzeyi. [in] aPlatModuleName Platform alt modül adı. [in] aFormat Biçim dizesi. [in] aArgs Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLogWarnPlat

void void otLogWarnPlat(
  const char *aFormat,
  ...
) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(1

Uyarı günlüğü düzeyinde günlük mesajı oluşturur.

Platform tarafından kullanılmak üzere tasarlanmıştır. OPENTHREAD_CONFIG_LOG_PLATFORM ayarlanmazsa veya geçerli günlük düzeyi uyarının altındaysa bu işlev herhangi bir günlük mesajı yayınlamaz.

Ayrıntılar
Parametreler	[in] aFormat Biçim dizesi. [in] ... Biçim spesifikasyonuna ilişkin bağımsız değişkenler.

otLoggingGetLevel

otLogLevel otLoggingGetLevel(
  void
)

Geçerli günlük düzeyini döndürür.

Dinamik günlük düzeyinde özellik OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE etkinse bu işlev, ayarlanmış olan dinamik günlük düzeyini döndürür. Aksi takdirde bu işlev, derleme zamanı tarafından yapılandırılmış günlük düzeyini döndürür.

Ayrıntılar
İadeler	Günlük düzeyi.

otLoggingSetLevel

otError otLoggingSetLevel(
  otLogLevel aLogLevel
)

Günlük düzeyini ayarlar.

Not: Bu işlev için OPENTHREAD_CONFIG_LOG_LEVEL_DYNAMIC_ENABLE=1 gerekir.

Ayrıntılar
Parametreler	[in] aLogLevel Günlük düzeyi.
Döndürülen Değerler	OT_ERROR_NONE Günlük düzeyi başarıyla güncellendi. OT_ERROR_INVALID_ARGS Günlük düzeyi değeri geçersiz.

Makrolar

OT_LOG_HEX_DUMP_LINE_SIZE

 OT_LOG_HEX_DUMP_LINE_SIZE 73

Onaltılık döküm satırı dizesinin boyutu.

Kaynaklar

OpenThread API Referans konuları, GitHub'da bulunan kaynak koddan gelir. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar bölümüne bakın.