Requirements on Log and Trace, AUTOSAR R22-11, FO, No.350

Requirements on Log and Trace, AUTOSAR R22-11, FO, No.350

AUTOSAR Countdown Calendar 2022

https://qiita.com/advent-calendar/2022/autosar

2022/12/09日の投稿です。

AUTOSARが、今年の版、R22-11公開しました。公開行事の模様は

AUTOSAR R22-11 Release Event 20221208

https://qiita.com/kaizen_nagoya/items/18471d0b340480fdcd42

下記URL順次確認中です。

https://www.autosar.org/fileadmin/standards/foundation/22-11/AUTOSAR_RS_LogAndTrace.pdf

間違っていたら、いいね　を押していただいて、コメント欄にご報告くださると幸いです。
編集リクエストが、構造的な変更をしている最中に、構造的な編集リクエストをしていただくと、
何をどう直したらいいかわからなくなってしまいます。自動修復ツールがつくれていません。ごめんなさい。

https://www.autosar.org/

文書は検索してダウンロードすることができます。
クラウドサービスにありがちな、あるのにないかのような検索結果が出ることがあります。

https://www.autosar.org/nc/document-search/

AUTOSAR R22-11 Qiita 記事一覧はこちらに編集中です。

https://qiita.com/kaizen_nagoya/items/11a1654e1e9ec0e4d001



## 英日単語帳
日本語は仮訳

|no.|count|word|日本語|
|:----|:----|:----|:----|
|1|412|the|その|
|2|259|to|に|
|3|243|and|と|
|4|189|trace|跡|
|5|188|of|の|
|6|159|rs_lt_|rs_lt_|
|7|156|log|記録|
|8|156|shall|しなければならない|
|9|141|a|一つの|
|10|141|be|です|
|11|109|rs_main_|rs_main_|
|12|93|lt|Log and Trace(短縮名）|
|13|78|is|です|
|14|73|fo|foundation(短縮名）|
|15|72|for|にとって|
|16|71|logging|記録する|
|17|69|in|の中に|
|18|65|autosar|AUTomotive Open System Architecture(短縮名)|
|19|64|message|伝言|
|20|60|description|説明|
|21|60|messages|伝言|
|22|60|use|使う|
|23|58|id|identifier, 識別子(短縮名）|
|24|56|case|場合|
|25|56|material|材料|
|26|55|applies|適用する|
|27|55|type|型|
|28|55|valid|有効|
|29|53|dependencies|依存関係|
|30|53|rationale|根拠|
|31|53|supporting|対応|
|32|51|or|または|
|33|50|information|情報|
|34|49|an|一つの|
|35|48|requirements|要件|
|36|45|communication|通信|
|37|45|on|の上|
|38|44|module|部品|
|39|43|document|資料|
|40|43|ecu|Electronic Control Unit（短縮名）|
|41|43|it|それ|
|42|42|may|かもしれない|
|43|40|applications|応用|
|44|39|by|に|
|45|39|interface|界面|
|46|38|application|応用|
|47|34|provide|提供|
|48|34|this|これ|
|49|33|r|r|
|50|31|from|から|
|51|29|autosar_rs_log|autosar_rs_log|
|52|29|which|どの|
|53|27|each|各|
|54|26|tracing|跡|
|55|25|data|与件|
|56|24|external|外部の|
|57|23|over|以上|
|58|22|format|書式|
|59|22|time|時間|
|60|21|all|すべて|
|61|21|client|顧客|
|62|21|events|行事|
|63|21|not|いいえ|
|64|21|with|と|
|65|20|can|できる|
|66|19|as|なので|
|67|19|rte|Runtime Environment(短縮名）|
|68|18|are|それは|
|69|18|at|で|
|70|18|phase|段階|
|71|16|different|違う|
|72|16|have|持つ|
|73|16|release|開放|
|74|15|bsw|basic software(短縮名）|
|75|15|configuration|構成|
|76|15|that|それ|
|77|14|able|できる|
|78|14|important|重要|
|79|14|levels|水準|
|80|14|s|s|
|81|14|vfb|virtual function bus(短縮名）|
|82|14|work|仕事|
|83|13|component|成分|
|84|13|context|文脈|
|85|13|level|水準|
|86|13|o|o|
|87|13|software|ソフトウェア|
|88|13|some|いくつかの|
|89|13|status|状態|
|90|12|ap|adaptive platform(短縮名)|
|91|12|possible|可能|
|92|12|set|設定する|
|93|12|source|源|
|94|12|specification|仕様|
|95|11|buffer|緩衝記憶|
|96|11|management|管理|
|97|11|no|いいえ|
|98|11|production|製造|
|99|11|transport|輸送|
|100|11|used|使った|

## Terms and Definition

#### 検討事項1
Abbreviation でも Acronymでも、ShortNameでもないものがある。これは、Terms and Definitionとして記述するのがよい。
説明も同義反復的なものがあるような気がする。記述の無駄なものがあるかもしれない。
少なくとも、Aの定義にA is という記述は不要ではないだろうか。

|Abbreviation / Acronym:|Description:|
|:--|:--|
|Log and trace message|A log and trace message contains all data and options to specify a log and trace event in a software.|
|User|The user of LT is the programmer of the software, which uses the LT API to generate log and trace messages.|
|Log|The user generates log messages on demand. Each time the user wants to show some information about state changes or value changes, he adds an API call to LT.|
|Trace|Trace messages can be generated by instrumentation of the code (e.g. VFB traces). The instrumented code calls the API of LT.|
|ECU ID|ECU ID is the name of each ECU.|
|Session ID|Session ID is the identification number of a log or trace session. If an Application is instantiated several times the log sessions get a new Session ID. A Application can have several log or trace sessions. A BSW module uses the module-number as Session ID.|
|Application ID|Application ID is a short name of the Application/BSW module. It identifies the Application/BSW module in the log and trace message.|
|Context ID|Context ID is a user defined ID to group log and trace messages produced by an Application/BSW module to distinguish functionality. Each Application ID can own several Context IDs. Context ID’s are grouped by Application ID’s. Context IDs shall be unique within an Application ID.The identification of the source of a log and trace message is done with a pair of Application ID and Context ID.|
|Message ID|Messaged ID is the ID to characterize the information, which is transported by the message itself. A Message ID identifies a log or trace message uniquely. It can be used for identifying the source (in source code) of a message and it can be used for characterizing the payload of a message.|
|Log and trace level|A log level defines a classification for the severity grade of a log message.The trace status provides information if a trace message should be send.|
|Time|Each log and trace message may contain a time attribute. The time attribute is a free defined time-value. It is the time since the start of the ECU.|
|External client|An external client is a tool, which can be run on a PC or another ECU, which is connected to LT over DCM or over the LT communication module.|


# 6 References
[1] Requirements on AUTOSAR, Features,AUTOSAR_RS_Features.pdf


廃止文書を参照しつづける理由

https://qiita.com/kaizen_nagoya/items/3e0055afb324c942384a

[2] Specification of RTE, AUTOSAR_SWS_RTE.pdf
[3] Layered Software Architecture, AUTOSAR_EXP_LayeredSoftwareArchitecture.pdf.pdf
[4] Specification of Development Error Trace, AUTOSAR_SWS_DevelopmentErrorTracer.pdf
[5] Software Standardization Template, AUTOSAR_TPS_StandardizationTemplate.pdf
[6] Main Requirements, AUTOSAR_RS_Main.pdf,

 AUTOSAR R21-11(2) Main Requirements

https://qiita.com/kaizen_nagoya/items/54a9d90272d901ecc089

# 4 Functional Overview
>LT provides the following functionalities:
 Logging
o Logging of errors, warnings and info messages from AUTOSAR
Application’s, providing a standardized AUTOSAR interface
o Gather all log and trace messages from all AUTOSAR Application’s in a centralized AUTOSAR service component (LT). See [3] for an overview.
o Log messages from DET ([4]) (Classic Platform)
o Log messages from DEM (Classic Platform)  Tracing
o Trace RTE/VFB ([2]) (Classic Platform)

記述がCP(Classic Platform)に偏っている。
AP(Adaptive Platform）でも診断機能は必要である。

APでは、Ethernet, TCP/IPがRTE/VFB機能を持っているはずで、共通部分の記述としないのは違和感がある。

# 5.2 FunctionalRequirements
5.2.1 Log and trace interfaces
5.2.1.1 Generic

この項にあるRSは、FOかAPを対象にしている。
FOを対象にしているのは、APとCLに対応しているということで納得できる。
FOとAPに対応しているというのは、CLに対応していないという具合に読めて、とても違和感がある。


5.2.1.2 Interface for Applications
の後に、同じ並びで
5.2.1.3 DET trace interface
5.2.1.4 DEM trace interface
5.2.1.5 RTE/VFB trace interface
があるのは違和感がある。
抽象化、抽象化といいながら、抽象的なものと具体的なものを同列で書くのはいかがなものか。

# 5.2.2 Format of log and trace message
FO対応以外にAPと記述のあるのは違和感がある。FOだけでいいじゃん。

# 5.2.3 Transport interfaces
 5.2.3.2 Communication interfaceの次に
5.2.3.3 DCM transport interface
があるのは違和感がある。

# 5.2.4 Operational function


# 5.3 NonfunctionalRequirements

5.3.1 [RS_LT_00041] LT shall be a central software component for the log and trace functionality.

>Only one SW module per ECU shall gather the log and trace messages centrally.

とあるが、RationaleがNoneとはどういうこっちゃ。
理由のない仕様は決めないで欲しい。


#  Log and Trace Protocol Specification

https://www.autosar.org/fileadmin/standards/foundation/21-11/AUTOSAR_PRS_LogAndTraceProtocol.pdf

## 参考

Glossary も　参考に入れましょう。
https://www.autosar.org/fileadmin/standards/foundation/22-11/AUTOSAR_TR_Glossary.pdf


[1] ISO/IEC 7498-1:1994 Information technology - Open Systems Interconnection - Basic Reference Model: The Basic Model - Part 1
www.iso.org
[2] Log and Trace Protocol Specification v.1 AUTOSAR_PRS_LogAndTraceProtocol from release R20-11
[3] AUTOSAR Log And Trace Extract Template AUTOSAR_TPS_LogAndTraceExtract

DLT: Diagnostic Log and Trace

## 参考資料

tracelog(3) — Linux manual page

https://man7.org/linux/man-pages/man3/tracelog.3.html

Logging HOWTO

https://docs.python.org/ja/3/howto/logging.html

NET Core のログとトレース

https://docs.microsoft.com/ja-jp/dotnet/core/diagnostics/logging-tracing

ログとトレースの接続

https://docs.datadoghq.com/ja/tracing/connect_logs_and_traces/

<この項は書きかけです。順次追記します。>



# Countdown Calendar 2022

今年企画した6つのCountdown Calendarと、それぞれの記事一つをご紹介します。

AUTOSAR Countdown Calendar 2022

https://qiita.com/advent-calendar/2022/autosar

AUTOSAR References to ISO, IEC, ITU, IEEE, RFC and SEA etc.

https://qiita.com/kaizen_nagoya/items/d7d252211e10a79516df

Automotive Handbook Countdown Calendar 2022

https://qiita.com/advent-calendar/2022/automotivehandbook

Basic principles, ボッシュ自動車handbook(英語)11版まとめ<2>

https://qiita.com/kaizen_nagoya/items/24a1ba5da3d09b2a95d1


2022 いいねをいただいた記事ランキング(O.K.版) Countdown Calendar 2022

https://qiita.com/advent-calendar/2022/goods

2022年１月下旬　いいねをいただいた記事　16

https://qiita.com/kaizen_nagoya/items/0ee589a8edaeab24fd2a

CDCale(O.K.) Countdown Calendar 2022

https://qiita.com/advent-calendar/2022/adventcalendar2022

「会議は15分未満」に。小耳にはさんだ話。

https://qiita.com/kaizen_nagoya/items/510c47c5d1e8d03145db

ABC language (O.K.版） Advent Calendar 2022

https://qiita.com/advent-calendar/2022/abc_ok

LLVMソースコードのコンパイルをしようと思ってハマった罠とそこから脱出するための努力

https://qiita.com/kaizen_nagoya/items/16f270e42b947756ced3

ABC maker(O.K版） Advent Calendar 2022

https://qiita.com/advent-calendar/2022/abcmaker

JAXA/IPA クリティカルソフトウェアワークショップ WOCS言語関連発表(改定版)

https://qiita.com/kaizen_nagoya/items/4789832baf494cb74626


CountdownCalendar2022 報告

https://qiita.com/kaizen_nagoya/items/5b4b99cb9ad571f4094b


# 関連文書(Related document)

2023年1月　記事数一覧

https://qiita.com/kaizen_nagoya/items/78153968c5de76a7fd83

年末100記事を30点に仕上げる。

https://qiita.com/kaizen_nagoya/items/3ffdc82caee3a325d1d7

2023 書き初め

https://qiita.com/kaizen_nagoya/items/d494737e2627127b530d

「はじめてのCAN/CANFD 」 ベクタージャパン ＜エンジニア夏休み企画>【読書感想文】

https://qiita.com/kaizen_nagoya/items/1fee270be00ef90ca4ec


三方良し　Udemy 車載LAN入門講座 CAN通信編

https://qiita.com/kaizen_nagoya/items/bed038c52510fea72c0a


詳解 車載ネットワーク CAN, CAN FD, LIN, CXPI, Ethernetの仕組みと設計のために(1) 著者　 ＜エンジニア夏休み企画 読書感想文＞

https://qiita.com/kaizen_nagoya/items/e9971698a108c3dba794

詳解 車載ネットワーク CAN, CAN FD, LIN, CXPI, Ethernetの仕組みと設計のために(2)参考文献 ＜エンジニア夏休み企画>【読書感想文】

https://qiita.com/kaizen_nagoya/items/e156cbdd5fce9263776e

詳解 車載ネットワーク CAN、CAN FD、LIN、CXPI、Ethernetの仕組みと設計のために

https://qiita.com/kaizen_nagoya/items/44a9e6b0f5363b4a5b35

AUTOSAR Abstract Platform User Group Weekly Report(1) 2022.1.8

https://qiita.com/kaizen_nagoya/items/fece4f7719ef55d612bf

AUTOSAR Abstract Platform User Group Weekly Report(2) 2022.1.15

https://qiita.com/kaizen_nagoya/items/6f1168a36e795976a906

# 更新資料　Abstract Platform, Vehicle Modelへの対応版
Requirements on Log and Trace, No.350, FO, AUTOSAR R22-11(2)

https://qiita.com/kaizen_nagoya/items/54c415db32a82830672a
 ＜この記事は個人の過去の経験に基づく個人の感想です。現在所属する組織、業務とは関係がありません。＞

# 文書履歴(document history)
ver. 0.01 初稿 20221212
ver. 0.02 URL追記　20230120