Skip to content

Commit d47a100

Browse files
mipsrobertmipsrobert
committed
All: 1.0.0_rc31. Using updated PDF template.
1 parent d1a2c74 commit d47a100

File tree

4 files changed

+87
-87
lines changed

4 files changed

+87
-87
lines changed

‎README.md‎

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,16 @@
22

33
## Status of each PDF
44

5-
**2024/05/02 status:**
5+
**2024/05/07 status:**
66

7-
* **N-Trace PDF**: Version 1.0.0_rc27. All known ARC notes DONE. Inside of [./pdfs](./pdfs) directory.
8-
* All known ARC notes DONE (ready for Frozen state).
9-
* **Controls PDF**: Version 1.0.0_rc22. All known ARC notes DONE. Inside of [./pdfs](./pdfs) directory.
10-
* All known ARC notes DONE (ready for Frozen state).
11-
* **Connectors PDF**: Version 1.0.0_rc30. Frozen. Inside of [./pdfs](./pdfs) directory.
12-
* It was accepted by ARC (via email).
7+
All 3 PDFs are using updated PDF template with nice header and footer and are located inside of [./pdfs](./pdfs) directory.
8+
9+
* **N-Trace PDF**: Version 1.0.0_rc31. Ready for Freeze.
10+
* **Controls PDF**: Version 1.0.0_rc31. Ready for Freeze.
11+
* **Connectors PDF**: Version 1.0.0_rc31. Ready for Freeze.
1312

1413
## TODO (before official freeze)
1514

16-
* TODO: Find a way to add nice header/footer at each page (Debug PDF has these).
1715
* TODO: Fix annoying page breaks (manual insert of 'page-break').
1816
* TODO: Make release with all PDFs 'Frozen', same date/version and pass back to ARC for official OK-stamp.
1917
* TODO: Make Public Review announcement (all PDFs Frozen).

‎docs/RISC-V-N-Trace.adoc‎

Lines changed: 24 additions & 23 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: May 02, 2024
5-
:revnumber: 1.0.0_rc27
6-
:revremark: Stable state (Second set of ARC notes DONE)
4+
:revdate: May 07, 2024
5+
:revnumber: 1.0.0_rc31
6+
:revremark: Stable state (ready for Freeze)
77
:url-riscv: http://riscv.org
88
:doctype: book
99
:preface-title: Preamble
@@ -52,9 +52,9 @@ Change is extremely unlikely.
5252

5353
PDF generated on: {localdatetime}
5454

55-
=== Version 1.0.0_rc27
56-
* 2024-05-02
57-
** Second set of ARC notes DONE
55+
=== Version 1.0.0_rc31
56+
* 2024-05-07
57+
** Ready for Freeze.
5858

5959
[Preface]
6060
== Copyright and license information
@@ -599,7 +599,7 @@ Message field attributes are described using the following terminology:
599599
* *[Cfg]*: A configurable field, where the existence and size depend on the encoder configuration options.
600600

601601
.Fields in Messages
602-
[cols="26%,9%,7%,7%,9%,17%,8%,10%,7%",options="header",]
602+
[cols="27%,9%,6%,7%,9%,17%,8%,10%,7%",options="header",]
603603
|===========================================================================================
604604
| Message ID/Field [size]|<<field_TCODE,TCODE>> [6]|<<field_SRC,SRC>> [Cfg]|<<field_SYNC,SYNC>> [4]|<<field_B-TYPE,B-TYPE>> [2]|Other fields|<<field_I-CNT,I-CNT>> [Var]|<<Address Compression,x-ADDR>> [Var]|<<field_HIST,HIST>> [Var]
605605
|[[msg_Ownership]]<<msg2_Ownership,Ownership>> |2 |Cfg| | |<<field_PROCESS,PROCESS>> *[Var]* | | |
@@ -614,7 +614,7 @@ Message field attributes are described using the following terminology:
614614
|[[msg_IndirectBranchHistSync]]<<msg2_IndirectBranchHistSync,IndirectBranchHistSync>>|29 |Cfg|Yes |Yes | |Yes |<<field_F-ADDR,F-ADDR>>|Yes
615615
|[[msg_RepeatBranch]]<<msg2_RepeatBranch,RepeatBranch>> |30 |Cfg| | |<<field_B-CNT,B-CNT>> *[Var]* | | |
616616
|[[msg_ProgTraceCorrelation]]<<msg2_ProgTraceCorrelation,ProgTraceCorrelation>> |33 |Cfg| | |<<field_EVCODE,EVCODE>> *[4]* + <<field_CDF,CDF>> *[2]* |Yes | |*Cfg*
617-
|<<msg_other,Vendor Defined>>|56..62|Cfg 6+| *TCODE* range designated for use by Vendor Defined messages
617+
|<<msg_other,Vendor Defined>>|56..62|Cfg 6+| Designated for use by Vendor Defined messages
618618
|<<msg_other,Reserved>>|other|Cfg 6+| Reserved for future extensions of N-Trace specification
619619
|===========================================================================================
620620

@@ -1137,21 +1137,22 @@ Rules when generating addresses:
11371137
** To decode the full address from the relative address (U-ADDR) can be XORed with the previously decoded full address.
11381138
* Address fields are sent beginning with bit 1 since all execution addresses are on a 2-byte boundaries (the least significant bit is always 0 and never sent).
11391139

1140-
Example:
1141-
1142-
[#Address XOR Compression]
1143-
.Address XOR Compression Example
1144-
[cols="10%,35%,44%,11%",options="header",]
1145-
|====
1146-
|Address |U-ADDR XOR calculations |F-ADDR/U-ADDR field sent | New REF Address
1147-
|0x3FC04 | |F-ADDR=1_1111_1110_0000_0010=0x1FE02| 0x3FC04
1148-
|0x3F368 | REF =0011_1111_1100_0000_0100 +
1149-
addr=0011_1111_0011_0110_1000 +
1150-
XOR =0000_0000_1111_0110_1100 |U-ADDR=111_1011_0110=0x7B6 | 0x3F368
1151-
|0x3E100 | REF =0011_1111_0011_0110_1000 +
1152-
addr=0011_1110_0001_0000_0000 +
1153-
XOR =0000_0001_0010_0110_1000 |U-ADDR=1001_0011_0100=0x934 | 0x3E100
1154-
|====
1140+
*Address XOR Calculation Examples*
1141+
1142+
==============================================================================================
1143+
| Address | U-ADDR XOR calculations | F-ADDR/U-ADDR field sent | New REF |
1144+
| | | | Address |
1145+
==============================================================================================
1146+
|0x3FC04 | | F-ADDR=1_1111_1110_0000_0010=0x1FE02 | 0x3FC04 |
1147+
----------------------------------------------------------------------------------------------
1148+
|0x3F368 | REF =0011_1111_1100_0000_0100 | | |
1149+
| | addr=0011_1111_0011_0110_1000 | | |
1150+
| | XOR =0000_0000_1111_0110_1100 | U-ADDR=111_1011_0110=0x7B6 | 0x3F368 |
1151+
----------------------------------------------------------------------------------------------
1152+
|0x3E100 | REF =0011_1111_0011_0110_1000 | | |
1153+
| | addr=0011_1110_0001_0000_0000 | | |
1154+
| | XOR =0000_0001_0010_0110_1000 | U-ADDR=1001_0011_0100=0x934 | 0x3E100 |
1155+
==============================================================================================
11551156

11561157
=== Virtual Addresses Optimization
11571158

‎docs/RISC-V-Trace-Connectors.adoc‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
[[header]]
22
:description: RISC-V Trace Connectors
33
:company: RISC-V.org
4-
:revdate: Mar 30, 2024
5-
:revnumber: 1.0.0_rc30
6-
:revremark: Frozen state
4+
:revdate: May 07, 2024
5+
:revnumber: 1.0.0_rc31
6+
:revremark: Stable state (ready for Freeze)
77
:url-riscv: http://riscv.org
88
:doctype: book
99
:preface-title: Preamble
@@ -42,19 +42,19 @@ RISC-V N-Trace Task Group
4242

4343
// Preamble
4444
[WARNING]
45-
.This document is in the link:http://riscv.org/spec-state[Frozen state]
45+
.This document is in the link:http://riscv.org/spec-state[Stable state]
4646
====
47-
Change is extremely unlikely. A high threshold will be used, and a change will only occur because of some truly critical issue being identified during the public review cycle. Any other desired or needed changes can be the subject of a follow-on new extension
47+
Change is extremely unlikely.
4848
====
4949

5050
[preface]
5151
== Change Log
5252

5353
PDF generated on: {localdatetime}
5454

55-
=== Version 1.0.0_rc30
56-
* 2024-03-30 (Frozen)
57-
** ARC reviews taken into account (confirmed by email)
55+
=== Version 1.0.0_rc31
56+
* 2024-05-07
57+
** Ready for Freeze.
5858

5959
[Preface]
6060
== Copyright and license information

0 commit comments

Comments
 (0)