Skip to content

Commit 133df5f

Browse files
committed
N-Trace 1.0.0_rc27 - Second set of ARC notes DONE.
1 parent 8e9d090 commit 133df5f

File tree

1 file changed

+13
-14
lines changed

1 file changed

+13
-14
lines changed

docs/RISC-V-N-Trace.adoc

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
[[header]]
22
:description: RISC-V N-Trace (Nexus-based Trace)
33
:company: RISC-V.org
4-
:revdate: Apr 01, 2024
5-
:revnumber: 1.0.0_rc26
6-
:revremark: Stable state (before SYNC clarifications)
4+
:revdate: May 02, 2024
5+
:revnumber: 1.0.0_rc27
6+
:revremark: Stable state (Second set of ARC notes DONE)
77
:url-riscv: http://riscv.org
88
:doctype: book
99
:preface-title: Preamble
@@ -50,10 +50,9 @@ Change is extremely unlikely.
5050

5151
PDF generated on: {localdatetime}
5252

53-
=== Version 1.0.0_rc26
54-
* 2024-04-01
55-
** 'itype' clarifications done.
56-
** TODO: SYNC clarification (email exchange with Ved).
53+
=== Version 1.0.0_rc27
54+
* 2024-05-02
55+
** Second set of ARC notes DONE
5756

5857
[Preface]
5958
== Copyright and license information
@@ -1469,16 +1468,16 @@ Trace requires different types of synchronization on different abstraction level
14691468
|14..15| Reserved |-| For vendor defined codes.
14701469
|====
14711470

1472-
Decoders should report synchronization SYNC field values from messages (including reserved codes) as it provides a reason of the program flow change. Periodic Synchronization are generated to allow easier decoding (not necessarilly from the start of collected trace) and may only be reported when desired by the user (for debugging).
1471+
Decoders should report synchronization SYNC field values from messages (including reserved codes) as it provides a reason of the program flow change.
14731472

1474-
NOTE: Periodic Synchronization (SYNC=2) messages may be delayed if anyother SYNC message (for example Sequential Instruction Counter, SYNC=4) needs to be sent in the same moment. In such a case, Periodic Synchronization may be even skipped as decoding may start from any Synchronizing Message.
1473+
* All synchronizing messages fully reset the encoder state, so decoding can be started from this message.
1474+
** Before resetting the encoder state, the trace up to the current location must be emitted (it includes HIST, ICNT, HREPEAT and BCOUNT counters).
1475+
* All synchronizing messages emit an absolute <<field_TSTAMP,TSTAMP>> field (if enabled), so decoder may calculate full/absolute timestamps from this message forward.
1476+
* An <<msg_Ownership,Ownership>> messages (if enabled) must be emitted immediatelly after all synchronizing messages.
14751477

1478+
Periodic Synchronization are generated to allow easier decoding (not necessarilly from the start of collected trace) and may only be reported when desired by the user (for debugging).
14761479

1477-
[IMPORTANT]
1478-
====
1479-
* All synchronizing messages fully reset the encoder state, so decoding can be started from this message.
1480-
* All synchronizing messages emit an absolute <<field_TSTAMP,TSTAMP>> field (if enabled), so decoder may report full/absolute timestamp.
1481-
====
1480+
NOTE: Periodic Synchronization (SYNC=2) messages may not be precise and may be delayed if anyother SYNC message (for example Sequential Instruction Counter, SYNC=4) is sent. In such a case, Periodic Synchronization may be even skipped as decoding may start from any Synchronizing Message.
14821481

14831482
==== Examples of Synchronizing Messages
14841483

0 commit comments

Comments
 (0)