From 0f48a027dafe058542f8a83fde6149e87ef29630 Mon Sep 17 00:00:00 2001 From: bigbass1997 Date: Wed, 16 Apr 2025 16:32:18 -0500 Subject: Reordered Port field in TRANSITION. --- CHANGELOG.md | 1 + docs/latest/draft-tasd-spec.html | 18 +++++++++--------- docs/latest/draft-tasd-spec.txt | 16 ++++++++-------- docs/tasd-spec-0001/draft-tasd-spec-0001.html | 18 +++++++++--------- docs/tasd-spec-0001/draft-tasd-spec-0001.txt | 16 ++++++++-------- src/docs/draft-tasd-spec-0001.xml | 16 ++++++++-------- 6 files changed, 43 insertions(+), 42 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 25b5a99..db6e901 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), - Improved wording in the Abstract, Introduction, Overview and several other sections - Clarified what must happen when INPUT_MOMENTs conflict with INPUT_CHUNKs, and removed wording that suggested they shouldn't both be used in the same TASD file - Changed the Index Type "Microseconds * 10" to "Microseconds" for INPUT_MOMENT and TRANSITION packets +- Reordered the Port field in the TRANSITION packet for better consistency with other packets that use the same field ### Added - A new Index Type of "Nanoseconds" for INPUT_MOMENT and TRANSITION packets (since the index number is 64-bits wide, even when using nanoseconds the largest number is equivalent to ~584.6 years) diff --git a/docs/latest/draft-tasd-spec.html b/docs/latest/draft-tasd-spec.html index e3a41cc..63d3203 100644 --- a/docs/latest/draft-tasd-spec.html +++ b/docs/latest/draft-tasd-spec.html @@ -3441,15 +3441,16 @@ li > p:last-of-type:only-child {

TRANSITION packets MUST be in the following format:

-               0            1      2  3  4  5  6  7  8  9
-      +----------------+----------+--+--+--+--+--+--+--+--+
-      | Index Type (A) | Port (N) |       Index (N)       | ...
-      +----------------+----------+--+--+--+--+--+--+--+--+
+            0            1         2  3  4  5  6  7  8  9
+      +----------+----------------+--+--+--+--+--+--+--+--+
+      | Port (N) | Index Type (A) |       Index (N)       | ...
+      +----------+----------------+--+--+--+--+--+--+--+--+
            10         11...
       +----------+============+
       | Type (A) | Packet (A) |
       +----------+============+
 
+      Port (Unsigned Integer)                 [1 octet]
       Index Type (Binary Data):               [1 octet]
          [01] - Frame
          [02] - Cycle Count
@@ -3457,7 +3458,6 @@ li > p:last-of-type:only-child {
          [04] - Microseconds
          [05] - Nanoseconds
          [06] - INPUT_CHUNK Byte Index
-      Port (Unsigned Integer)                 [1 octet]
       Index (Unsigned Integer)                [8 octets]
       Type (Binary Data):                     [1 octet]
          [01] - Soft Reset
@@ -3468,12 +3468,12 @@ li > p:last-of-type:only-child {
-
Input Type
-
Determines specific timing type for start of transition. +
Port
+
Controller port number (Port number MUST be 1-indexed).
-
Port
-
Controller port number (Port number MUST be 1-indexed). +
Input Type
+
Determines specific timing type for start of transition.
Index
diff --git a/docs/latest/draft-tasd-spec.txt b/docs/latest/draft-tasd-spec.txt index 33b32ef..4f2feec 100644 --- a/docs/latest/draft-tasd-spec.txt +++ b/docs/latest/draft-tasd-spec.txt @@ -1527,15 +1527,16 @@ Table of Contents TRANSITION packets MUST be in the following format: - 0 1 2 3 4 5 6 7 8 9 - +----------------+----------+--+--+--+--+--+--+--+--+ - | Index Type (A) | Port (N) | Index (N) | ... - +----------------+----------+--+--+--+--+--+--+--+--+ + 0 1 2 3 4 5 6 7 8 9 + +----------+----------------+--+--+--+--+--+--+--+--+ + | Port (N) | Index Type (A) | Index (N) | ... + +----------+----------------+--+--+--+--+--+--+--+--+ 10 11... +----------+============+ | Type (A) | Packet (A) | +----------+============+ + Port (Unsigned Integer) [1 octet] Index Type (Binary Data): [1 octet] [01] - Frame [02] - Cycle Count @@ -1543,7 +1544,6 @@ Table of Contents [04] - Microseconds [05] - Nanoseconds [06] - INPUT_CHUNK Byte Index - Port (Unsigned Integer) [1 octet] Index (Unsigned Integer) [8 octets] Type (Binary Data): [1 octet] [01] - Soft Reset @@ -1552,12 +1552,12 @@ Table of Contents [FF] - Packet Derived Inner Packet (Binary Data) [PLEN - 11 octets] - *Input Type* - Determines specific timing type for start of transition. - *Port* Controller port number (*Port* number MUST be *1-indexed*). + *Input Type* + Determines specific timing type for start of transition. + *Index* Time or offset value to start transition. If *Index Type* is [06], *Index* MUST be interpreted as the *byte offset* diff --git a/docs/tasd-spec-0001/draft-tasd-spec-0001.html b/docs/tasd-spec-0001/draft-tasd-spec-0001.html index e3a41cc..63d3203 100644 --- a/docs/tasd-spec-0001/draft-tasd-spec-0001.html +++ b/docs/tasd-spec-0001/draft-tasd-spec-0001.html @@ -3441,15 +3441,16 @@ li > p:last-of-type:only-child {

TRANSITION packets MUST be in the following format:

-               0            1      2  3  4  5  6  7  8  9
-      +----------------+----------+--+--+--+--+--+--+--+--+
-      | Index Type (A) | Port (N) |       Index (N)       | ...
-      +----------------+----------+--+--+--+--+--+--+--+--+
+            0            1         2  3  4  5  6  7  8  9
+      +----------+----------------+--+--+--+--+--+--+--+--+
+      | Port (N) | Index Type (A) |       Index (N)       | ...
+      +----------+----------------+--+--+--+--+--+--+--+--+
            10         11...
       +----------+============+
       | Type (A) | Packet (A) |
       +----------+============+
 
+      Port (Unsigned Integer)                 [1 octet]
       Index Type (Binary Data):               [1 octet]
          [01] - Frame
          [02] - Cycle Count
@@ -3457,7 +3458,6 @@ li > p:last-of-type:only-child {
          [04] - Microseconds
          [05] - Nanoseconds
          [06] - INPUT_CHUNK Byte Index
-      Port (Unsigned Integer)                 [1 octet]
       Index (Unsigned Integer)                [8 octets]
       Type (Binary Data):                     [1 octet]
          [01] - Soft Reset
@@ -3468,12 +3468,12 @@ li > p:last-of-type:only-child {
-
Input Type
-
Determines specific timing type for start of transition. +
Port
+
Controller port number (Port number MUST be 1-indexed).
-
Port
-
Controller port number (Port number MUST be 1-indexed). +
Input Type
+
Determines specific timing type for start of transition.
Index
diff --git a/docs/tasd-spec-0001/draft-tasd-spec-0001.txt b/docs/tasd-spec-0001/draft-tasd-spec-0001.txt index 33b32ef..4f2feec 100644 --- a/docs/tasd-spec-0001/draft-tasd-spec-0001.txt +++ b/docs/tasd-spec-0001/draft-tasd-spec-0001.txt @@ -1527,15 +1527,16 @@ Table of Contents TRANSITION packets MUST be in the following format: - 0 1 2 3 4 5 6 7 8 9 - +----------------+----------+--+--+--+--+--+--+--+--+ - | Index Type (A) | Port (N) | Index (N) | ... - +----------------+----------+--+--+--+--+--+--+--+--+ + 0 1 2 3 4 5 6 7 8 9 + +----------+----------------+--+--+--+--+--+--+--+--+ + | Port (N) | Index Type (A) | Index (N) | ... + +----------+----------------+--+--+--+--+--+--+--+--+ 10 11... +----------+============+ | Type (A) | Packet (A) | +----------+============+ + Port (Unsigned Integer) [1 octet] Index Type (Binary Data): [1 octet] [01] - Frame [02] - Cycle Count @@ -1543,7 +1544,6 @@ Table of Contents [04] - Microseconds [05] - Nanoseconds [06] - INPUT_CHUNK Byte Index - Port (Unsigned Integer) [1 octet] Index (Unsigned Integer) [8 octets] Type (Binary Data): [1 octet] [01] - Soft Reset @@ -1552,12 +1552,12 @@ Table of Contents [FF] - Packet Derived Inner Packet (Binary Data) [PLEN - 11 octets] - *Input Type* - Determines specific timing type for start of transition. - *Port* Controller port number (*Port* number MUST be *1-indexed*). + *Input Type* + Determines specific timing type for start of transition. + *Index* Time or offset value to start transition. If *Index Type* is [06], *Index* MUST be interpreted as the *byte offset* diff --git a/src/docs/draft-tasd-spec-0001.xml b/src/docs/draft-tasd-spec-0001.xml index 5c184db..9ddc7ec 100644 --- a/src/docs/draft-tasd-spec-0001.xml +++ b/src/docs/draft-tasd-spec-0001.xml @@ -1165,15 +1165,16 @@ TRANSITION Packet TRANSITION packets MUST be in the following format:
-
Input Type
-
Determines specific timing type for start of transition.
Port
Controller port number (Port number MUST be 1-indexed).
+
Input Type
+
Determines specific timing type for start of transition.
Index
Time or offset value to start transition. If Index Type is [06], Index MUST be interpreted as the byte offset (0-indexed) into the concatenated input data from all INPUT_CHUNK packets for the controller port specified by Port. If Index Type is [06], the byte offset MUST also point to the first byte of an instance of controller input data (according to the PORT_CONTROLLER format at that moment in the TAS replay.)
Type
@@ -1937,7 +1937,7 @@ THIS DOCUMENTATION IS PROVIDED BY THE AUTHOR(S) "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.