From 80ee1005eb4476bcff121db5d4f5fffb251da2c8 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Tue, 18 Nov 2025 13:48:20 +0000
Subject: [PATCH 01/17] Ensure consistent terminology with binary protocol

---
 Device.md | 150 +++++++++++++++++++++++++++---------------------------
 1 file changed, 75 insertions(+), 75 deletions(-)

diff --git a/Device.md b/Device.md
index 0f81eef..c145ef1 100644
--- a/Device.md
+++ b/Device.md
@@ -10,40 +10,40 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
 
 ## Device Interface
 
-All device functionality provided to the host under the Harp protocol, including device configuration, is specified using a standardized device interface. The device interface is composed of a collection of hardware registers. Each register is defined by a unique memory location, which can be accessed for reading and writing. These memory locations can be tied to hardware-related functionality, such that changing the value of the register can directly change the operation of the device.
+All Device functionality, including device configuration, SHOULD be provided to the Controller using the [Harp Binary Protocol](BinaryProtocol-8bit.md), and documented using a standardized Device Interface. The Device Interface is described by a collection of hardware registers. Each register is defined by a unique memory location, which can be accessed for reading and writing. These memory locations can be tied to hardware-related functionality, such that changing the value of the register can directly change the operation of the Device.
 
 For example, a register can be used to configure device properties such as sampling frequency, operation mode, input / output routing, and other device-specific parameters. A register can also be used to control specific functionality, such as toggling digital output lines, starting and stopping pulse trains, or moving a motor.
 
-Each register in the device interface is assigned a unique zero-based address, and a payload type describing the format of the data stored in the register. Registers can be read-only or allow both reading and writing.
+Each register in the Device Interface is assigned a unique zero-based address, and a payload type describing the format of the data stored in the register. Registers can be read-only or allow both reading and writing.
 
-Except for [Optional or Deprecated registers](#optional-or-deprecated-registers), whose behavior is clarified below, all registers and functionality specified in this document MUST be implemented for a device to be declared compliant with this specification.
+Except for [Optional or Deprecated registers](#optional-or-deprecated-registers), whose behavior is clarified below, all registers and functionality specified in this document MUST be implemented by a Device complying with this specification.
 
 ## Application Registers
 
-All registers pertaining to the hardware-specific operation of a device are application registers. Every application register MUST have an address equal to, or greater than, 32. The address, payload type, and naming of application registers is left to the device developer, as it will always be specific to each device.
+All registers pertaining to the hardware-specific operation of the Device are application registers. Every application register MUST have an address equal to, or greater than, 32. The address, payload type, and naming of application registers is left to the device developer, as it will always be specific to each Device.
 
 ## Optional and Deprecated Registers
 
-Some registers are marked as **Optional** or **Deprecated** in the [Core Registers](#core-registers) table, and their functionality MAY not be fully implemented in all devices. However, all optional or deprecated registers MUST implement `Read` commands by sending a reply to the host with the specified default value. Moreover, they MUST be included as part of the [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) register dump.
+Some registers are marked as **Optional** or **Deprecated** in the [Core Registers](#core-registers) table, and their functionality MAY not be fully implemented by the Device. However, all optional or deprecated registers MUST reply to `Read` requests by sending a message to the Controller with the specified default value. Moreover, they MUST be included as part of the [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) register dump.
 
-For any writeable optional or deprecated registers whose function is not implemented, the device MUST always return a `Write` reply payload containing the register default value, to indicate the `Write` command had no effect. The device SHOULD NOT crash or enter an undefined state when a write command is sent to an optional or deprecated unimplemented register.
+For any writeable optional or deprecated registers whose function is not implemented, the Device MUST always return a `Write` reply payload containing the register default value, to indicate the `Write` request had no effect. The Device SHOULD NOT crash or enter an undefined state when a `Write` request is sent to an optional or deprecated unimplemented register.
 
 In most cases, the default value of an optional or deprecated register SHOULD be `0` (Zero). Other values MAY be allowed, in which case they MUST be explicitly documented and justified on a per-register basis.
 
 ## Operation Mode
 
-The following Harp device operation modes MUST be implemented:
+The following Device operation modes MUST be implemented:
 
-- `Standby:` The device MUST reply to host commands. All `Event` messages are disabled and MUST NOT be sent to the host.
-- `Active:` The device MUST reply to host commands. All `Event` messages are enabled and SHOULD be sent to the host following the device specification.
+- `Standby:` The Device MUST reply to Controller requests. All `Event` messages are disabled and MUST NOT be sent to the Controller.
+- `Active:` The Device MUST reply to Controller requests. All `Event` messages are enabled and SHOULD be sent to the Controller following the Device specification.
 
-Harp devices SHOULD continuously check if communication with the host is active and healthy. This status check will be largely dependent on the transport layer implementing the Harp protocol between host and device. Each implementation SHOULD clearly distinguish between `Connected` and `NotConnected` states, and it is up to the developer to decide how to implement this status check. When the device transitions to the `NotConnected` state, it MUST immediately enter `Standby` and stop transmission of further `Event` messages.
+The Device SHOULD continuously check if communication with the Controller is active and healthy. This status check will be largely dependent on the transport layer implementing the Harp communication protocol between Controller and Device. Each implementation SHOULD clearly distinguish between `Connected` and `NotConnected` states, and it is up to the developer to decide how to implement this status check. When the Device transitions to the `NotConnected` state, it MUST immediately enter `Standby` and stop transmission of further `Event` messages.
 
-As an application example, devices using USB as the transport layer MAY poll for an active USB connection by checking that the state of the DTR pin is `HIGH`. Once the DTR pin is brought `LOW` it SHOULD be assumed that the host closed the connection and the device MUST enter `Standby`. In this case, the host is responsible for setting the state of the DTR line when opening or closing a new connection.
+As an application example, a Device using USB as the transport layer MAY poll for an active USB connection by checking that the state of the DTR pin is `HIGH`. Once the DTR pin is brought `LOW` it SHOULD be assumed that the Controller closed the connection and the Device MUST enter `Standby`. In this case, the Controller is responsible for setting the state of the DTR line when opening or closing a new connection.
 
 ## Core Registers
 
-All Harp devices MUST implement the set of common core registers below. These reserved registers are used to identify the device, the version of various components, determine the current operation mode, and other common operations.
+The following set of Device core registers MUST be implemented. These reserved registers are used to identify the Device, the version of various components, determine the current Device operation mode, and other common operations.
 
 |**Name**|**Volatile**|**Read Only**|**Type**|**Add.**|**Default**|**Brief Description**|**Necessity**|
 | :- | :-: | :-: | :-: | :-: | :-: | :- | :-: |
@@ -59,16 +59,16 @@ All Harp devices MUST implement the set of common core registers below. These re
 |[`R_TIMESTAMP_MICRO`](#r_timestamp_micro-u16--system-timestamp-microseconds)|Yes|Yes|U16|009|0|System timestamp: microseconds|Required|
 |[`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration)|No|No|U8|010|b)|Configuration of the operation mode|Required|
 |[`R_RESET_DEV`](#r_reset_dev-u8--reset-device-and-save-non-volatile-registers)|No|No|U8|011|b)|Reset device and save non-volatile registers|Optional|
-|[`R_DEVICE_NAME`](#r_device_name-25-bytes--human-readable-device-name)|No|No|U8|012|b)|Human-readable name of the device|Optional|
-|[`R_SERIAL_NUMBER`](#r_serial_number-u16--device-serial-number)|No|No|U16|013|b)|Unique serial number of the device|Deprecated|
+|[`R_DEVICE_NAME`](#r_device_name-25-bytes--human-readable-device-name)|No|No|U8|012|b)|Human-readable device name|Optional|
+|[`R_SERIAL_NUMBER`](#r_serial_number-u16--device-serial-number)|No|No|U16|013|b)|Unique serial number of the Device|Deprecated|
 |[`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration)|No|No|U8|014|b)|Synchronization clock configuration|Optional|
 |[`R_TIMESTAMP_OFFSET`](#r_timestamp_offset-u8--clock-calibration-offset)|No|No|U8|015|b)|Configures an offset for Timestamp updates|Deprecated|
 |[`R_UID`](#r_uid-16-bytes--unique-identifier)|No|Yes|U8|016|b)|Stores a unique identifier (UID) |Optional|
 |[`R_TAG`](#r_tag-8-bytes--firmware-tag)|-|Yes|U8|017|b)|Firmware tag|Optional|
-|[`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device)|Yes|Yes|U16|018|b)|Monitors the state of the device|Required|
-|[`R_VERSION`](#r_version-u8--semantic-version-information)|-|Yes|U8|019|a)|Semantic version information for the device|Required|
+|[`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device)|Yes|Yes|U16|018|b)|Monitors the state of the Device|Required|
+|[`R_VERSION`](#r_version-u8--semantic-version-information)|-|Yes|U8|019|a)|Semantic version information for the Device|Required|
 
-||a) These values MUST be stored during the firmware build process and are persistent, i.e. they SHALL NOT be changeable by the host.<br>b) Check register notes on the specific register explanation |
+||a) These values MUST be stored during the firmware build process and are persistent, i.e. they SHALL NOT be changeable by the Controller.<br>b) Check register notes on the specific register explanation |
 | :- | :- |
 
 <!---
@@ -101,7 +101,7 @@ gantt
     0      :d1, 0, 2
 ```
 
-Specifies the product identifier of the device. The list of reserved device product identifiers can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific identifiers for your project or company, please follow the instructions in that repository. If the device does not have a pre-allocated identifier, this register MUST be set to its default value of `0` (Zero).
+Specifies the product identifier of the Device. The list of reserved device product identifiers can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific identifiers for your project or company, please follow the instructions in that repository. If the Device does not have a pre-allocated identifier, this register MUST be set to its default value of `0` (Zero).
 
 ### **`R_TIMESTAMP_SECOND` (U32) – System timestamp (seconds)**
 
@@ -185,8 +185,8 @@ gantt
     0      :bit0, after bit1  , 8
     section Id
     ALIVE_EN      :id7, 0, 1
-    OPLEDEN      :id6, after bit7  , 2
-    VISUALEN      :id5, after bit6  , 3
+    OPLED_EN      :id6, after bit7  , 2
+    VISUAL_EN      :id5, after bit6  , 3
     MUTE_RPL      :id4, after bit5  , 4
     DUMP      :id3, after bit4  , 5
     HEARTBEAT_EN  :id2, after bit3  , 6
@@ -216,7 +216,7 @@ a) The `ALIVE_EN` bit is deprecated and may be removed from future protocol vers
 b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 
 
-* **OP_MODE [Bits 1:0]:** These bits define the [Operation Mode](#operation-mode) of the device.
+* **OP_MODE [Bits 1:0]:** These bits define the [Operation Mode](#operation-mode) of the Device.
 
 **Table - Available Operation modes**
 
@@ -229,15 +229,15 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 
 > [!WARNING]
 >
-> `Speed` mode is now deprecated, and SHOULD NOT be implemented in any new devices. This mode was used to support the implementation of dedicated communication protocols. When entering `Speed` mode, the device SHOULD NOT reply to host commands, other than its specific `Speed` mode commands.
+> `Speed` mode is now deprecated, and SHOULD NOT be implemented in any new devices. This mode was used to support the implementation of dedicated communication protocols. When entering `Speed` mode, the Device SHOULD NOT reply to Controller requests, other than its specific `Speed` mode commands.
 >
-> The device MUST reply with `Error` in case this operation mode is not supported.
+> The Device MUST reply with `Error` in case this operation mode is not supported.
 
-* **HEARTBEAT_EN [Bit 2]:** If this bit is set, the device sends an `Event` message every second with the contents of [`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device). This allows the host to check the status of the device periodically. If the `ALIVE_EN` bit is also set, this bit has precedence and the device must send `R_HEARTBEAT` periodically instead of `R_TIMESTAMP_SECOND`.
-* **DUMP [Bit 3]:** If this bit is set, the device adds the content of all registers to the streaming buffer as `Read` messages. This bit is always read as 0.
-* **MUTE_RPL [Bit 4]:** If this bit is set, the `Replies` to all the `Commands` are muted, i.e., they will not be sent by the device.
-* **VISUALEN [Bit 5]:** If this bit is set, visual indications, typically LEDs, available on the device will be enabled. If equals to 0, all the visual indications must be turned off.
-* **OPLEDEN [Bit 6]:** If this bit is set, the LED present on the device will indicate the Operation Mode selected.
+* **HEARTBEAT_EN [Bit 2]:** If this bit is set, the Device MUST send an `Event` message every second with the contents of [`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device). This allows the Controller to check the status of the Device periodically. If the `ALIVE_EN` bit is also set, this bit has precedence and the Device must send `R_HEARTBEAT` periodically instead of `R_TIMESTAMP_SECOND`.
+* **DUMP [Bit 3]:** If this bit is set, the Device adds the content of all registers to the streaming buffer as `Read` messages. This bit is always read as 0.
+* **MUTE_RPL [Bit 4]:** If this bit is set, the Device SHALL NOT send any messages in reply to a request from the Controller.
+* **VISUAL_EN [Bit 5]:** If this bit is set, any visual indicators, typically LEDs, available on the Device SHOULD be enabled. Otherwise, if the bit is cleared, all visual indicators SHOULD be turned off.
+* **OPLED_EN [Bit 6]:** If this bit is set, the LED present on the Device SHOULD indicate the current Operation Mode.
 
 **Table - Visual LED toggle feedback**
 
@@ -246,9 +246,9 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 | 4          	| Standby Mode.                                                                                            	|
 | 2          	| Active Mode.                                                                                             	|
 | 1          	| Speed Mode.                                                                                              	|
-| 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the device from this Mode. 	|
+| 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the Device from this Mode. 	|
 
-* **ALIVE_EN [Bit 7]:** If this bit is set, the device sends an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This allows the host to check the status of the device periodically. This feature is deprecated and may be removed from future protocol versions.
+* **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This allows the Controller to check the status of the Device periodically. This feature is deprecated and may be removed from future protocol versions.
 
 ### **`R_RESET_DEV` (U8) – Reset device and save non-volatile registers**
 
@@ -293,31 +293,31 @@ gantt
     0      :d0, after bit1  , 8
 ```
 
-* **RST_DEF [Bit 0]:** If this bit is set, the device MUST reset and reboot with all core and application registers set to their default values. Any available non-volatile memory MUST be erased and all device default values MUST be restored as the permanent boot option. When sending a response to a `Read` command, the device MUST set this bit to 0 in the response payload.
+* **RST_DEF [Bit 0]:** If this bit is set, the Device MUST reset and reboot with all core and application registers set to their default values. Any available non-volatile memory MUST be erased and all Device default values MUST be restored as the permanent boot option. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **RST_EE [Bit 1]:** If this bit is set and non-volatile memory is available, the device MUST reset and reboot with all core and application registers set to the values saved in persistent storage, usually an EEPROM. Any currently stored values MUST remain the permanent boot option. If this bit is set and non-volatile memory is not available, the device MUST respond with an `Error` message. When sending a response to a `Read` command, the device MUST clear this bit in the response payload.
+* **RST_EE [Bit 1]:** If this bit is set and non-volatile memory is available, the Device MUST reset and reboot with all core and application registers set to the values saved in persistent storage, usually an EEPROM. Any currently stored values MUST remain the permanent boot option. If this bit is set and non-volatile memory is not available, the Device MUST reply with an `Error` message. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **SAVE [Bit 2]:** If this bit is set and non-volatile memory is available, the device MUST save any non-volatile core and application registers to persistent storage, and reboot. The non-volatile memory should be configured as the permanent boot option. If this bit is set and non-volatile memory is not available, the device MUST respond with an `Error` message. When sending a response to a `Read` command, the device MUST clear this bit in the response payload.
+* **SAVE [Bit 2]:** If this bit is set and non-volatile memory is available, the Device MUST save any non-volatile core and application registers to persistent storage, and reboot. The non-volatile memory should be configured as the permanent boot option. If this bit is set and non-volatile memory is not available, the Device MUST reply with an `Error` message. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **NAME_TO_DEFAULT [Bit 3]:** If this bit is set, the device MUST reboot and restore the value of [`R_DEVICE_NAME`](#r_device_name-25-bytes--devices-name) to its default value. When sending a response to a `Read` command, the device MUST clear this bit in the response payload.
+* **NAME_TO_DEFAULT [Bit 3]:** If this bit is set, the Device MUST reboot and restore the value of [`R_DEVICE_NAME`](#r_device_name-25-bytes--devices-name) to its default value. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **UPDATE_FIRMWARE [Bit 5]:** If this bit is set, the device MUST enter firmware update mode. In this mode the device MAY NOT respond to any commands until the update completes. Once completed, the device MUST reset. When sending a response to a `Read` command, the device MUST clear this bit in the response payload.
+* **UPDATE_FIRMWARE [Bit 5]:** If this bit is set, the Device MUST enter firmware update mode. In this mode the Device MAY NOT reply to any requests until the update completes. Once completed, the Device MUST reset. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **BOOT_DEF [Bit 6]:** When sending a response to a `Read` command, the device MUST set this bit if the device booted with its default register values. If non-volatile memory is not available, the device MUST always set this bit when sending a response to a `Read` command. This bit is read-only state, so if this bit is set on a command message, the device MUST respond with an `Error` message.
+* **BOOT_DEF [Bit 6]:** When sending a reply to a `Read` request, the Device MUST set this bit if it booted with the default register values. If non-volatile memory is not available, the Device MUST always set this bit when sending a reply to a `Read` request. This bit is read-only state, so if this bit is set on a request message, the Device MUST reply with an `Error` message.
 
-* **BOOT_EE [Bit 7]:** When sending a response to a `Read` command, the device MUST set this bit if the device booted with register values recovered from persistent storage. If non-volatile memory is not available, the device MUST always clear this bit when sending a response to a `Read` command. This bit is read-only state, so if this bit is set on a command message, the device MUST respond with an `Error` message.
+* **BOOT_EE [Bit 7]:** When sending a reply to a `Read` request, the Device MUST set this bit if it booted with register values recovered from persistent storage. If non-volatile memory is not available, the Device MUST always clear this bit when sending a reply to a `Read` request. This bit is read-only state, so if this bit is set on a request message, the Device MUST reply with an `Error` message.
 
 > [!IMPORTANT]
 >
-> To avoid unexpected behavior, the host SHOULD set only one bit at a time when sending commands to `R_RESET_DEV`.
+> To avoid unexpected behavior, the Controller SHOULD set only one bit at a time when sending a `Write` request to `R_RESET_DEV`.
 
 ### **`R_DEVICE_NAME` (25 Bytes) – Human-readable device name**
 
 Address: `012`
 
-An array of 25 bytes specifying a human-readable device name. Any unused bytes MUST be set to `0` (Zero). This register is non-volatile. If a `Write` command to this register is received and non-volatile memory is available, the device MUST reset and save the new register value to persistent storage. Otherwise, if non-volatile memory is not available, the device MUST respond to any `Write` commands with the default register value.
+An array of 25 bytes specifying a human-readable device name. Any unused bytes MUST be set to `0` (Zero). This register is non-volatile. If a `Write` request to this register is received and non-volatile memory is available, the Device MUST reset and save the new register value to persistent storage. Otherwise, if non-volatile memory is not available, the Device MUST reply to any `Write` requests with the default register value.
 
-This register is optional. If not implemented, the default value of this register MUST be `0` (Zero).
+Providing a non-empty device name is OPTIONAL. If no name is provided, the default value of this register MUST be `0` (Zero).
 
 ### **`R_CLOCK_CONFIG` (U8) – Synchronization clock configuration**
 
@@ -362,23 +362,23 @@ gantt
     -      :d0, after bit1  , 8
 ```
 
-* **CLK_REP [Bit 0]:** If this bit is set, and a Clock Output connector is available on the device, the device MUST repeat the Harp Synchronization Clock messages on the Clock Output. This allows daisy-chaining by repeating the Clock Input on the Clock Output. Setting this bit also enables writing on the timestamp register.
+* **CLK_REP [Bit 0]:** If this bit is set, and a Clock Output connector is available on the device hardware, the Device MUST repeat the Harp Synchronization Clock messages on the Clock Output. This allows daisy-chaining by repeating the Clock Input on the Clock Output. Setting this bit also enables writing on the timestamp register.
 
-* **CLK_GEN [Bit 1]:** If this bit is set, and a Clock Output connector is available on the device, the device MUST generate Harp Synchronization Clock messages on the Clock Output. Any messages arriving on the Clock Input MUST be ignored by the device.
+* **CLK_GEN [Bit 1]:** If this bit is set, and a Clock Output connector is available on the device hardware, the Device MUST generate Harp Synchronization Clock messages on the Clock Output. Any messages arriving on the Clock Input MUST be ignored by the Device.
 
-* **REP_ABLE [Bit 3]:** Read-only status bit. When sending a response to a `Read` command, the device MUST set this bit if it is able to repeat the Harp Synchronization Clock timestamp.
+* **REP_ABLE [Bit 3]:** Read-only status bit. When sending a reply to a `Read` request, the Device MUST set this bit if it is able to repeat the Harp Synchronization Clock timestamp.
 
-* **GEN_ABLE [Bit 4]:** Read-only status bit. When sending a response to a `Read` command, the device MUST set this bit if it is able to generate the Harp Synchronization Clock timestamp.
+* **GEN_ABLE [Bit 4]:** Read-only status bit. When sending a reply to a `Read` request, the Device MUST set this bit if it is able to generate the Harp Synchronization Clock timestamp.
 
-* **CLK_UNLOCK [Bit 6]:** If this bit is set, the device MUST enable writing on [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). When sending a response to a `Read` command, the device MUST set this bit if the timestamp register is unlocked.
+* **CLK_UNLOCK [Bit 6]:** If this bit is set, the Device MUST enable writing on [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). When sending a reply to a `Read` request, the Device MUST set this bit if the timestamp register is unlocked.
 
-* **CLK_LOCK [Bit 7]:** If this bit is set, the device MUST disable writing on [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). When sending a response to a `Read` command, the device MUST set this bit if the timestamp register is locked.
+* **CLK_LOCK [Bit 7]:** If this bit is set, the Device MUST disable writing on [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). When sending a reply to a `Read` request, the Device MUST set this bit if the timestamp register is locked.
 
-The implementation of this register is optional but highly recommend for devices that are expected to implement the Harp synchronization protocol.
+The implementation of this register is RECOMMENDED if the Device provides a [Synchronization Clock](SynchronizationClock.md).
 
 > [!NOTE]
 >
-> The device MUST always boot with the timestamp register in the unlocked state.
+> The Device MUST always boot with the timestamp register in the unlocked state.
 
 ### **`R_UID` (16 Bytes) – Unique Identifier**
 
@@ -404,7 +404,7 @@ gantt
     0      :d1, 0, 1
 ```
 
-An array of 16 bytes specifying the (128-bit) UID (Unique Identifier) of the current device. This register is non-volatile and read-only. The byte-order is little-endian. If not implemented, the device MUST return a default value of `0` (Zero) for all bytes.
+An array of 16 bytes specifying a (128-bit) UID (Unique Identifier) for the Device. This register is non-volatile and read-only. The byte-order is little-endian. If not implemented, the Device MUST return a default value of `0` (Zero) for all bytes.
 
 ### **`R_TAG` (8 Bytes) – Firmware tag**
 
@@ -432,7 +432,7 @@ gantt
 
 An array of 8 bytes that can be used to store a tag for a specific firmware build. For instance, it could be used to store the Git hash of a specific release/commit. The byte-order is little-endian. This register is read-only.
 
-If not implemented, the device MUST return a default value of `0` (Zero) for all bytes.
+If not implemented, the Device MUST return a default value of `0` (Zero) for all bytes.
 
 ### **`R_HEARTBEAT` (U16) – Heartbeat register reporting the current status of the device**
 
@@ -463,11 +463,11 @@ gantt
     -      :d6, after bit1, 3
 ```
 
-This register is read-only and used to provide status information about the device. Any changes to the below bits are controlled by the device and sent to the host through a periodic `Event` message. If periodic reporting is enabled by setting [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) bit `HEARTBEAT_EN`, the event will be periodically emitted at a rate of 1 Hz, in sync with updates to the [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds) register.
+This register is read-only and used to provide status information about the Device. Any changes to the below bits are controlled by the Device and sent to the Controller through a periodic `Event` message. If periodic reporting is enabled by setting [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) bit `HEARTBEAT_EN`, the event will be periodically emitted at a rate of 1 Hz, in sync with updates to the [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds) register.
 
-* **IS_ACTIVE [Bit 0]:** If this bit is set, the device MUST be in `Active` mode. The bit must be cleared if the device is in any other mode (see [Operation Mode](#operation-mode) for information on available device modes).
+* **IS_ACTIVE [Bit 0]:** If this bit is set, the Device MUST be in `Active` mode. The bit must be cleared if the Device is in any other mode (see [Operation Mode](#operation-mode) for information on available device modes).
 
-* **IS_SYNCHRONIZED [Bit 1]:** If this bit is set, the device MUST be synchronized with an external Harp clock generator. If the device is itself a clock generator (see [`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration) bit `CLK_GEN`), this bit MUST always be set.
+* **IS_SYNCHRONIZED [Bit 1]:** If this bit is set, the Device MUST be synchronized with an external Harp clock generator. If the Device is itself a clock generator (see [`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration) bit `CLK_GEN`), this bit MUST always be set.
 
 ### **`R_VERSION` (U8) – Semantic version information**
 
@@ -510,21 +510,21 @@ gantt
     -      :d4, after sdk_id, 32
 ```
 
-The bytes in this register specify the [semantic version](https://semver.org/) of different device components. Each component version is made up of three bytes, following the order `major`, `minor`, `patch`. The register also includes a unique identifier of the core microcontroller SDK and a hash digest of the interface schema file describing the device capabilities.
+The bytes in this register specify the [semantic version](https://semver.org/) of different Device components. Each component version is made up of three bytes, following the order `major`, `minor`, `patch`. The register also includes a unique identifier of the core microcontroller SDK and a hash digest of the interface schema file describing the Device Interface.
 
-* **PROTOCOL:** The semantic version of the Harp protocol implemented by the device.
+* **PROTOCOL:** The semantic version of the Harp protocol implemented by the Device.
 
-* **FIRMWARE:** The semantic version of the device firmware application.
+* **FIRMWARE:** The semantic version of the Device firmware application.
 
-* **HARDWARE:** The semantic version of the device hardware.
+* **HARDWARE:** The semantic version of the Device hardware.
 
-* **SDK_ID:** The three-character code of the core microcontroller SDK used to implement the device.
+* **SDK_ID:** The three-character code of the core microcontroller SDK used to implement the Device.
 
-* **INTERFACE_HASH:** The SHA-1 hash value of the device interface schema file (`device.yml`). The byte-order is little-endian. If the client SHOULD NOT perform any validation of its device interface schema, the device MUST set this value to `0` (Zero). 
+* **INTERFACE_HASH:** The SHA-1 hash value of the Device Interface schema file (`device.yml`). The byte-order is little-endian. If the client SHOULD NOT perform any validation of its Device Interface schema, the Device MUST set this value to `0` (Zero). 
 
 ## Deprecated Core Registers
 
-The following registers are deprecated and their functionality SHOULD NOT be implemented in new devices. They MUST still exist as read-only registers, and included in the [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) register dump. They are kept for backward compatibility with older hosts and may be removed in future protocol versions.
+The following registers are deprecated and their functionality SHOULD NOT be implemented in new devices. They MUST still exist as read-only registers, and included in the [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) register dump. They are kept for backward compatibility with older Controllers and may be removed in future protocol versions.
 
 ### **`R_HW_VERSION_H` (U8) – Major Hardware Version**
 
@@ -554,7 +554,7 @@ gantt
     -      :d1, 0, 1
 ```
 
-Specifies the major hardware version number. The value of this register is persistent and MUST NOT be changeable by the host.
+Specifies the major hardware version number. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_HW_VERSION_L` (U8) – Minor Hardware Version**
 
@@ -584,13 +584,13 @@ gantt
     -      :d1, 0, 1
 ```
 
-Specifies the minor hardware version number. The value of this register is persistent and MUST NOT be changeable by the host.
+Specifies the minor hardware version number. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_ASSEMBLY_VERSION` (U8) – Version of the Assembled Components**
 
 > [!WARNING]
 >
-> This register is deprecated as we do not require tracking the version of assembled components directly in the device firmware.
+> This register is deprecated as we do not require tracking the version of assembled components directly in the Device firmware.
 
 Address: `003`
 
@@ -614,7 +614,7 @@ gantt
     0      :d1, 0, 1
 ```
 
-Specifies the version number of the assembled components. The value of this register is persistent and MUST NOT be changeable by the host. If this register is not implemented, it MUST have the default value of `0` (Zero).
+Specifies the version number of the assembled components. The value of this register is persistent and MUST NOT be changeable by the Controller. If this register is not implemented, it MUST store a fixed default value of `0` (Zero).
 
 ### **`R_CORE_VERSION_H` (U8) – Major Core Version**
 
@@ -644,7 +644,7 @@ gantt
     -      :d1, 0, 1
 ```
 
-Contains the major version of the Harp protocol specification. The value of this register is persistent and MUST NOT be changeable by the host.
+Contains the major version of the Harp protocol specification. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_CORE_VERSION_L` (U8) – Minor Core Version**
 
@@ -674,7 +674,7 @@ gantt
     -      :d1, 0, 1
 ```
 
-Contains the minor version of the Harp Protocol specification. The value of this register is persistent and MUST NOT be changeable by the host.
+Contains the minor version of the Harp Protocol specification. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_FW_VERSION_H` (U8) – Major Firmware Version**
 
@@ -704,7 +704,7 @@ gantt
     -      :d1, 0, 1
 ```
 
-Contains the major firmware version number. The value of this register is persistent and MUST NOT be changeable by the host.
+Contains the major firmware version number. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_FW_VERSION_L` (U8) – Minor Firmware Version**
 
@@ -732,7 +732,7 @@ gantt
     -      :d1, 0, 1
 ```
 
-Contains the minor firmware version number. The value of this register is persistent and MUST NOT be changeable by the host.
+Contains the minor firmware version number. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
 ### **`R_SERIAL_NUMBER` (U16) – Device serial number**
 
@@ -763,14 +763,14 @@ gantt
     -      :d1, 0, 2
 ```
 
-Specifies a serial number for the device. This register is optional. If implemented, this number SHOULD be unique for each unit with the same device product identifier stored in `R_WHO_AM_I`.
+Specifies a device serial number. If this register is implemented, the number SHOULD be unique for each unit with the same device product identifier stored in `R_WHO_AM_I`. If the register functionality is not implemented, the Device MUST reply to any `Read` requests with a fixed default value of `0` (Zero).
 
-`Write` commands to this register are optional. If `Write` commands are supported, the following two-step write sequence MUST be implemented:
+Supporting `Write` requests to this register is OPTIONAL. If `Write` requests are supported, the following two-step write sequence MUST be implemented:
 
   1. Receive a `Write` message with the value `0xFFFF`.
-  2. Receive a second `Write` message with the new serial number. The device MUST reset after the second `Write` message is received.
+  2. Receive a second `Write` message with the new serial number. The Device MUST reset after the second `Write` message is received.
 
-Otherwise, if `Write` commands are not supported, the device MUST respond to any `Write` commands with the fixed device serial number.
+Otherwise, if `Write` requests are not supported, the Device MUST reply to any `Write` requests with the fixed device serial number.
 
 ### **`R_TIMESTAMP_OFFSET` (U8) – Clock calibration offset**
 
@@ -800,7 +800,7 @@ gantt
     0      :d1, 0, 1
 ```
 
-When the value of this register is greater than `0` (Zero), the device’s timestamp will be offset by this amount. The register is sensitive to 500 microsecond increments. This register is non-volatile.
+When the value of this register is greater than `0` (Zero), the Device timestamp SHOULD be offset by this amount. The register is sensitive to 500 microsecond increments. This register is non-volatile.
 
 
 ## Release Notes
@@ -851,7 +851,7 @@ When the value of this register is greater than `0` (Zero), the device’s times
   * Minor improvements to clarity of introduction.
 
 - v1.9.2
-  * Clarify `Connected` behavior between host and device and add application examples.
+  * Clarify `Connected` behavior between Controller and Device and add application examples.
 
 - v1.10.0
   * Add `R_UID` register
@@ -868,5 +868,5 @@ When the value of this register is greater than `0` (Zero), the device’s times
   * Add `R_VERSION` register
   * Deprecate legacy version registers and `R_TIMESTAMP_OFFSET`
   * Clarify meaning of optional registers
-  * Add device interface clarifications
+  * Add Device Interface clarifications
   * Adopt requirement key words from RFC 2119

From 74ca890cb6cd6809cda1eb8f2ebee3269fa718da Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Tue, 18 Nov 2025 13:49:04 +0000
Subject: [PATCH 02/17] Clarify that reply must be sent before rebooting

---
 Device.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index c145ef1..40af975 100644
--- a/Device.md
+++ b/Device.md
@@ -293,6 +293,8 @@ gantt
     0      :d0, after bit1  , 8
 ```
 
+This register is used to reboot the Device, optionally save or restore non-volatile registers, or enter firmware update mode. The Device MUST send a reply to a `Write` request from the Controller before rebooting.
+
 * **RST_DEF [Bit 0]:** If this bit is set, the Device MUST reset and reboot with all core and application registers set to their default values. Any available non-volatile memory MUST be erased and all Device default values MUST be restored as the permanent boot option. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
 * **RST_EE [Bit 1]:** If this bit is set and non-volatile memory is available, the Device MUST reset and reboot with all core and application registers set to the values saved in persistent storage, usually an EEPROM. Any currently stored values MUST remain the permanent boot option. If this bit is set and non-volatile memory is not available, the Device MUST reply with an `Error` message. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
@@ -301,7 +303,7 @@ gantt
 
 * **NAME_TO_DEFAULT [Bit 3]:** If this bit is set, the Device MUST reboot and restore the value of [`R_DEVICE_NAME`](#r_device_name-25-bytes--devices-name) to its default value. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
-* **UPDATE_FIRMWARE [Bit 5]:** If this bit is set, the Device MUST enter firmware update mode. In this mode the Device MAY NOT reply to any requests until the update completes. Once completed, the Device MUST reset. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
+* **UPDATE_FIRMWARE [Bit 5]:** If this bit is set, the Device MUST enter firmware update mode. In this mode the Device MAY NOT reply to any requests until the update completes. Once completed, the Device MUST reboot. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 
 * **BOOT_DEF [Bit 6]:** When sending a reply to a `Read` request, the Device MUST set this bit if it booted with the default register values. If non-volatile memory is not available, the Device MUST always set this bit when sending a reply to a `Read` request. This bit is read-only state, so if this bit is set on a request message, the Device MUST reply with an `Error` message.
 

From 87a43d58e1202b7f5b4c84fea9ba48f3af02407f Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Tue, 18 Nov 2025 14:18:00 +0000
Subject: [PATCH 03/17] Clarify dump bit behavior

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index 40af975..126e508 100644
--- a/Device.md
+++ b/Device.md
@@ -234,7 +234,7 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 > The Device MUST reply with `Error` in case this operation mode is not supported.
 
 * **HEARTBEAT_EN [Bit 2]:** If this bit is set, the Device MUST send an `Event` message every second with the contents of [`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device). This allows the Controller to check the status of the Device periodically. If the `ALIVE_EN` bit is also set, this bit has precedence and the Device must send `R_HEARTBEAT` periodically instead of `R_TIMESTAMP_SECOND`.
-* **DUMP [Bit 3]:** If this bit is set, the Device adds the content of all registers to the streaming buffer as `Read` messages. This bit is always read as 0.
+* **DUMP [Bit 3]:** If this bit is set on a `Write` request, the Device SHALL send a sequence of `Read` messages to the Controller, one per register, with the current contents of all core and application registers. These messages MUST be sent following the `Write` reply to the request from the Controller. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 * **MUTE_RPL [Bit 4]:** If this bit is set, the Device SHALL NOT send any messages in reply to a request from the Controller.
 * **VISUAL_EN [Bit 5]:** If this bit is set, any visual indicators, typically LEDs, available on the Device SHOULD be enabled. Otherwise, if the bit is cleared, all visual indicators SHOULD be turned off.
 * **OPLED_EN [Bit 6]:** If this bit is set, the LED present on the Device SHOULD indicate the current Operation Mode.

From 72652ebf511ce5b57c097b7c85806c2b89085ede Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Tue, 18 Nov 2025 14:44:48 +0000
Subject: [PATCH 04/17] Indicate device name payload type is array

This is an alternative to explicitly specifying the length in the title
while maintaining good readability in document TOC.
---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index 126e508..19f4509 100644
--- a/Device.md
+++ b/Device.md
@@ -313,7 +313,7 @@ This register is used to reboot the Device, optionally save or restore non-volat
 >
 > To avoid unexpected behavior, the Controller SHOULD set only one bit at a time when sending a `Write` request to `R_RESET_DEV`.
 
-### **`R_DEVICE_NAME` (25 Bytes) – Human-readable device name**
+### **`R_DEVICE_NAME` (U8 Array) – Human-readable device name**
 
 Address: `012`
 

From fc554755abeb13cc9bce0758eb2526ff89785885 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Tue, 18 Nov 2025 21:25:11 +0000
Subject: [PATCH 05/17] Fix core register backlinks and naming convention

---
 Device.md | 38 +++++++++++++++++++-------------------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/Device.md b/Device.md
index 19f4509..c777a6c 100644
--- a/Device.md
+++ b/Device.md
@@ -47,26 +47,26 @@ The following set of Device core registers MUST be implemented. These reserved r
 
 |**Name**|**Volatile**|**Read Only**|**Type**|**Add.**|**Default**|**Brief Description**|**Necessity**|
 | :- | :-: | :-: | :-: | :-: | :-: | :- | :-: |
-|[`R_WHO_AM_I`](#r_who_am_i-u16--who-am-i)|-|Yes|U16|000|a)|Who am I|Required|
+|[`R_WHO_AM_I`](#r_who_am_i-u16--product-identifier)|-|Yes|U16|000|a)|Product identifier|Required|
 |[`R_HW_VERSION_H`](#r_hw_version_h-u8--major-hardware-version)|-|Yes|U8|001|a)|Major Hardware version|Deprecated|
 |[`R_HW_VERSION_L`](#r_hw_version_l-u8--minor-hardware-version)|-|Yes|U8|002|a)|Minor Hardware version|Deprecated|
-|[`R_ASSEMBLY_VERSION`](#r_assembly_version-u8--version-of-the-assembled-components)|-|Yes|U8|003|a)|Version of the assembled components|Deprecated|
+|[`R_ASSEMBLY_VERSION`](#r_assembly_version-u8--version-of-assembled-components)|-|Yes|U8|003|a)|Version of assembled components|Deprecated|
 |[`R_CORE_VERSION_H`](#r_core_version_h-u8--major-core-version)|-|Yes|U8|004|a)|Major core version|Deprecated|
 |[`R_CORE_VERSION_L`](#r_core_version_l-u8--minor-core-version)|-|Yes|U8|005|a)|Minor core version|Deprecated|
 |[`R_FW_VERSION_H`](#r_fw_version_h-u8--major-firmware-version)|-|Yes|U8|006|a)|Major Firmware version of the application|Deprecated|
 |[`R_FW_VERSION_L`](#r_fw_version_l-u8--minor-firmware-version)|-|Yes|U8|007|a)|Minor Firmware version of the application|Deprecated|
 |[`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds)|Yes|No|U32|008|0|System timestamp: seconds|Required|
 |[`R_TIMESTAMP_MICRO`](#r_timestamp_micro-u16--system-timestamp-microseconds)|Yes|Yes|U16|009|0|System timestamp: microseconds|Required|
-|[`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration)|No|No|U8|010|b)|Configuration of the operation mode|Required|
+|[`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration)|No|No|U8|010|b)|Configuration of the device operation mode|Required|
 |[`R_RESET_DEV`](#r_reset_dev-u8--reset-device-and-save-non-volatile-registers)|No|No|U8|011|b)|Reset device and save non-volatile registers|Optional|
-|[`R_DEVICE_NAME`](#r_device_name-25-bytes--human-readable-device-name)|No|No|U8|012|b)|Human-readable device name|Optional|
-|[`R_SERIAL_NUMBER`](#r_serial_number-u16--device-serial-number)|No|No|U16|013|b)|Unique serial number of the Device|Deprecated|
+|[`R_DEVICE_NAME`](#r_device_name-u8-array--human-readable-device-name)|No|No|U8|012|b)|Human-readable device name|Optional|
+|[`R_SERIAL_NUMBER`](#r_serial_number-u16--device-serial-number)|No|No|U16|013|b)|Unique serial number of the device|Deprecated|
 |[`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration)|No|No|U8|014|b)|Synchronization clock configuration|Optional|
 |[`R_TIMESTAMP_OFFSET`](#r_timestamp_offset-u8--clock-calibration-offset)|No|No|U8|015|b)|Configures an offset for Timestamp updates|Deprecated|
 |[`R_UID`](#r_uid-16-bytes--unique-identifier)|No|Yes|U8|016|b)|Stores a unique identifier (UID) |Optional|
 |[`R_TAG`](#r_tag-8-bytes--firmware-tag)|-|Yes|U8|017|b)|Firmware tag|Optional|
-|[`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device)|Yes|Yes|U16|018|b)|Monitors the state of the Device|Required|
-|[`R_VERSION`](#r_version-u8--semantic-version-information)|-|Yes|U8|019|a)|Semantic version information for the Device|Required|
+|[`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information)|Yes|Yes|U16|018|b)|Monitors device status|Required|
+|[`R_VERSION`](#r_version-u8--device-version-information)|-|Yes|U8|019|a)|Device version information|Required|
 
 ||a) These values MUST be stored during the firmware build process and are persistent, i.e. they SHALL NOT be changeable by the Controller.<br>b) Check register notes on the specific register explanation |
 | :- | :- |
@@ -76,7 +76,7 @@ Tables can be generated here https://www.tablesgenerator.com/html_tables
 Mermaid plots can be generated here: https://mermaid.live/
 --->
 
-### **`R_WHO_AM_I` (U16) – Who Am I**
+### **`R_WHO_AM_I` (U16) – Product identifier**
 
 Address: `000`
 
@@ -233,7 +233,7 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 >
 > The Device MUST reply with `Error` in case this operation mode is not supported.
 
-* **HEARTBEAT_EN [Bit 2]:** If this bit is set, the Device MUST send an `Event` message every second with the contents of [`R_HEARTBEAT`](#r_heartbeat-u16--heartbeat-register-reporting-the-current-status-of-the-device). This allows the Controller to check the status of the Device periodically. If the `ALIVE_EN` bit is also set, this bit has precedence and the Device must send `R_HEARTBEAT` periodically instead of `R_TIMESTAMP_SECOND`.
+* **HEARTBEAT_EN [Bit 2]:** If this bit is set, the Device MUST send an `Event` message every second with the contents of [`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information). This allows the Controller to check the status of the Device periodically. If the `ALIVE_EN` bit is also set, this bit has precedence and the Device must send `R_HEARTBEAT` periodically instead of `R_TIMESTAMP_SECOND`.
 * **DUMP [Bit 3]:** If this bit is set on a `Write` request, the Device SHALL send a sequence of `Read` messages to the Controller, one per register, with the current contents of all core and application registers. These messages MUST be sent following the `Write` reply to the request from the Controller. When sending a reply to a `Read` request, the Device MUST clear this bit in the message payload.
 * **MUTE_RPL [Bit 4]:** If this bit is set, the Device SHALL NOT send any messages in reply to a request from the Controller.
 * **VISUAL_EN [Bit 5]:** If this bit is set, any visual indicators, typically LEDs, available on the Device SHOULD be enabled. Otherwise, if the bit is cleared, all visual indicators SHOULD be turned off.
@@ -436,7 +436,7 @@ An array of 8 bytes that can be used to store a tag for a specific firmware buil
 
 If not implemented, the Device MUST return a default value of `0` (Zero) for all bytes.
 
-### **`R_HEARTBEAT` (U16) – Heartbeat register reporting the current status of the device**
+### **`R_HEARTBEAT` (U16) – Device status information**
 
 Address: `018`
 
@@ -471,7 +471,7 @@ This register is read-only and used to provide status information about the Devi
 
 * **IS_SYNCHRONIZED [Bit 1]:** If this bit is set, the Device MUST be synchronized with an external Harp clock generator. If the Device is itself a clock generator (see [`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration) bit `CLK_GEN`), this bit MUST always be set.
 
-### **`R_VERSION` (U8) – Semantic version information**
+### **`R_VERSION` (U8) – Device version information**
 
 Address: `019`
 
@@ -512,7 +512,7 @@ gantt
     -      :d4, after sdk_id, 32
 ```
 
-The bytes in this register specify the [semantic version](https://semver.org/) of different Device components. Each component version is made up of three bytes, following the order `major`, `minor`, `patch`. The register also includes a unique identifier of the core microcontroller SDK and a hash digest of the interface schema file describing the Device Interface.
+The bytes in this register specify the [semantic version](https://semver.org/) of the components making up the Device. Each component version is made up of three bytes, following the order `major`, `minor`, `patch`. The register also includes a unique identifier of the core microcontroller SDK and a hash digest of the interface schema file describing the Device Interface.
 
 * **PROTOCOL:** The semantic version of the Harp protocol implemented by the Device.
 
@@ -532,7 +532,7 @@ The following registers are deprecated and their functionality SHOULD NOT be imp
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the major `HARDWARE` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the major `HARDWARE` version in `R_VERSION`.
 
 Address: `001`
 
@@ -562,7 +562,7 @@ Specifies the major hardware version number. The value of this register is persi
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the minor `HARDWARE` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the minor `HARDWARE` version in `R_VERSION`.
 
 Address: `002`
 
@@ -588,7 +588,7 @@ gantt
 
 Specifies the minor hardware version number. The value of this register is persistent and MUST NOT be changeable by the Controller.
 
-### **`R_ASSEMBLY_VERSION` (U8) – Version of the Assembled Components**
+### **`R_ASSEMBLY_VERSION` (U8) – Version of Assembled Components**
 
 > [!WARNING]
 >
@@ -622,7 +622,7 @@ Specifies the version number of the assembled components. The value of this regi
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the major `PROTOCOL` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the major `PROTOCOL` version in `R_VERSION`.
 
 Address: `004`
 
@@ -652,7 +652,7 @@ Contains the major version of the Harp protocol specification. The value of this
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the minor `PROTOCOL` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the minor `PROTOCOL` version in `R_VERSION`.
 
 Address: `005`
 
@@ -682,7 +682,7 @@ Contains the minor version of the Harp Protocol specification. The value of this
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the major `FIRMWARE` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the major `FIRMWARE` version in `R_VERSION`.
 
 Address: `006`
 
@@ -712,7 +712,7 @@ Contains the major firmware version number. The value of this register is persis
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--semantic-version-information). The value of this register MUST be equal to the minor `FIRMWARE` version in `R_VERSION`.
+> This register is deprecated in favor of [`R_VERSION`](#r_version-u8--device-version-information). The value of this register MUST be equal to the minor `FIRMWARE` version in `R_VERSION`.
 
 ```mermaid
 ---

From c7931dacdff45f5fa9f94825772e39b6ecbbd6fe Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:23:49 +0000
Subject: [PATCH 06/17] Ensure R_WHO_AM_I spec is consistent with core.yml

---
 Device.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Device.md b/Device.md
index c777a6c..144b02a 100644
--- a/Device.md
+++ b/Device.md
@@ -76,7 +76,7 @@ Tables can be generated here https://www.tablesgenerator.com/html_tables
 Mermaid plots can be generated here: https://mermaid.live/
 --->
 
-### **`R_WHO_AM_I` (U16) – Product identifier**
+### **`R_WHO_AM_I` (U16) – Device Identity Class**
 
 Address: `000`
 
@@ -101,7 +101,7 @@ gantt
     0      :d1, 0, 2
 ```
 
-Specifies the product identifier of the Device. The list of reserved device product identifiers can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific identifiers for your project or company, please follow the instructions in that repository. If the Device does not have a pre-allocated identifier, this register MUST be set to its default value of `0` (Zero).
+Specifies the identity class of the Device. The list of reserved device product identifiers can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific identifiers for your project or company, please follow the instructions in that repository. If the Device does not have a pre-allocated identifier, this register MUST be set to its default value of `0` (Zero).
 
 ### **`R_TIMESTAMP_SECOND` (U32) – System timestamp (seconds)**
 

From 750e34dd133f4bbb36982977418e8bd1234ff814 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:38:55 +0000
Subject: [PATCH 07/17] Clarify alternative to ALIVE_EN bit

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index 144b02a..f962594 100644
--- a/Device.md
+++ b/Device.md
@@ -248,7 +248,7 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 | 1          	| Speed Mode.                                                                                              	|
 | 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the Device from this Mode. 	|
 
-* **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This allows the Controller to check the status of the Device periodically. This feature is deprecated and may be removed from future protocol versions.
+* **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This feature has been deprecated and may be removed from future protocol versions. The Controller should set the `HEARTBEAT_EN` bit and monitor [`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information) instead for periodically checking the status of the Device.
 
 ### **`R_RESET_DEV` (U8) – Reset device and save non-volatile registers**
 

From 813e7f003cf4a39da1a6f5ea335fb3d5b1429c2f Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:41:11 +0000
Subject: [PATCH 08/17] Clarify that the R_HEARTBEAT event is mandatory

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index f962594..5921c05 100644
--- a/Device.md
+++ b/Device.md
@@ -465,7 +465,7 @@ gantt
     -      :d6, after bit1, 3
 ```
 
-This register is read-only and used to provide status information about the Device. Any changes to the below bits are controlled by the Device and sent to the Controller through a periodic `Event` message. If periodic reporting is enabled by setting [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) bit `HEARTBEAT_EN`, the event will be periodically emitted at a rate of 1 Hz, in sync with updates to the [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds) register.
+This register is read-only and used to provide status information about the Device. Any changes to the below bits are controlled by the Device and sent to the Controller through a periodic `Event` message. If periodic reporting is enabled by setting [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) bit `HEARTBEAT_EN`, the Device MUST emit a periodic event on this register at a rate of 1 Hz, in sync with updates to the [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds) register.
 
 * **IS_ACTIVE [Bit 0]:** If this bit is set, the Device MUST be in `Active` mode. The bit must be cleared if the Device is in any other mode (see [Operation Mode](#operation-mode) for information on available device modes).
 

From ff5c4f0492785aac654b5ebe16b0e0820ada488b Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:44:08 +0000
Subject: [PATCH 09/17] Fix register link

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index 5921c05..a57bb92 100644
--- a/Device.md
+++ b/Device.md
@@ -47,7 +47,7 @@ The following set of Device core registers MUST be implemented. These reserved r
 
 |**Name**|**Volatile**|**Read Only**|**Type**|**Add.**|**Default**|**Brief Description**|**Necessity**|
 | :- | :-: | :-: | :-: | :-: | :-: | :- | :-: |
-|[`R_WHO_AM_I`](#r_who_am_i-u16--product-identifier)|-|Yes|U16|000|a)|Product identifier|Required|
+|[`R_WHO_AM_I`](#r_who_am_i-u16--device-identity-class)|-|Yes|U16|000|a)|Product identifier|Required|
 |[`R_HW_VERSION_H`](#r_hw_version_h-u8--major-hardware-version)|-|Yes|U8|001|a)|Major Hardware version|Deprecated|
 |[`R_HW_VERSION_L`](#r_hw_version_l-u8--minor-hardware-version)|-|Yes|U8|002|a)|Minor Hardware version|Deprecated|
 |[`R_ASSEMBLY_VERSION`](#r_assembly_version-u8--version-of-assembled-components)|-|Yes|U8|003|a)|Version of assembled components|Deprecated|

From 7e9df0041dfd30016e411b4db1ca7ae64297a9a0 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:53:46 +0000
Subject: [PATCH 10/17] Minor wording improvement

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index a57bb92..c59c871 100644
--- a/Device.md
+++ b/Device.md
@@ -68,7 +68,7 @@ The following set of Device core registers MUST be implemented. These reserved r
 |[`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information)|Yes|Yes|U16|018|b)|Monitors device status|Required|
 |[`R_VERSION`](#r_version-u8--device-version-information)|-|Yes|U8|019|a)|Device version information|Required|
 
-||a) These values MUST be stored during the firmware build process and are persistent, i.e. they SHALL NOT be changeable by the Controller.<br>b) Check register notes on the specific register explanation |
+||a) These values MUST be stored during the firmware build process and are persistent, i.e. they SHALL NOT be changeable by the Controller.<br>b) Check notes on the specific register specification. |
 | :- | :- |
 
 <!---

From 64366fe1602a1cb5152d6c89d3e112997937f0dc Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 21:55:52 +0000
Subject: [PATCH 11/17] Improve wording consistency

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index c59c871..b1e4d35 100644
--- a/Device.md
+++ b/Device.md
@@ -101,7 +101,7 @@ gantt
     0      :d1, 0, 2
 ```
 
-Specifies the identity class of the Device. The list of reserved device product identifiers can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific identifiers for your project or company, please follow the instructions in that repository. If the Device does not have a pre-allocated identifier, this register MUST be set to its default value of `0` (Zero).
+Specifies the identity class of the Device. The list of reserved device identity classes can be found at [harp-tech/whoami](https://github.com/harp-tech/whoami). To reserve specific device identity classes for your project or company, please follow the instructions in that repository. If the Device does not have a pre-allocated identity class, this register MUST be set to its default value of `0` (Zero).
 
 ### **`R_TIMESTAMP_SECOND` (U32) – System timestamp (seconds)**
 

From b5a8ee1cd7e54fd5b2ea0464be0dafbc4610d5fb Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:03:05 +0000
Subject: [PATCH 12/17] Improve formatting and table punctuation

---
 Device.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/Device.md b/Device.md
index b1e4d35..cde0ee3 100644
--- a/Device.md
+++ b/Device.md
@@ -222,10 +222,10 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 
 | OP_MODE[1:0] 	| Configuration          	|
 |--------------	|------------------------	|
-| 0            	| Standby Mode.           |
-| 1            	| Active Mode.    	      |
-| 2            	| Reserved.              	|
-| 3            	| Speed Mode. Deprecated.	|
+| 0            	| Standby Mode            |
+| 1            	| Active Mode             |
+| 2            	| Reserved                |
+| 3            	| Speed Mode              |
 
 > [!WARNING]
 >
@@ -241,12 +241,12 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 
 **Table - Visual LED toggle feedback**
 
-| Period (s) 	| Operation Mode                                                                                           	|
+| Period (s) 	| Operation Mode                                                                                            |
 |------------	|----------------------------------------------------------------------------------------------------------	|
-| 4          	| Standby Mode.                                                                                            	|
-| 2          	| Active Mode.                                                                                             	|
-| 1          	| Speed Mode.                                                                                              	|
-| 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the Device from this Mode. 	|
+| 4          	| Standby Mode                                                                                              |
+| 2          	| Active Mode                                                                                               |
+| 1          	| Speed Mode                                                                                                |
+| 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the Device from this Mode.  |
 
 * **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This feature has been deprecated and may be removed from future protocol versions. The Controller should set the `HEARTBEAT_EN` bit and monitor [`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information) instead for periodically checking the status of the Device.
 

From 9baea211e6e1596928134a3d941bad6a40b8bddc Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:05:05 +0000
Subject: [PATCH 13/17] Clarify wording of ALIVE_EN bit

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index cde0ee3..8065ca6 100644
--- a/Device.md
+++ b/Device.md
@@ -248,7 +248,7 @@ b) `Standby` and `Active` modes are mandatory. `Speed` mode is deprecated.
 | 1          	| Speed Mode                                                                                                |
 | 0.1        	| A critical error occurred. Only a hardware reset or a new power up can remove the Device from this Mode.  |
 
-* **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This feature has been deprecated and may be removed from future protocol versions. The Controller should set the `HEARTBEAT_EN` bit and monitor [`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information) instead for periodically checking the status of the Device.
+* **ALIVE_EN [Bit 7]:** If this bit is set, the Device SHOULD send an `Event` message every second with the contents of [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds). This feature has been deprecated and may be removed from future protocol versions. The Controller SHOULD set the `HEARTBEAT_EN` bit and monitor [`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information) instead for periodically checking the status of the Device.
 
 ### **`R_RESET_DEV` (U8) – Reset device and save non-volatile registers**
 

From 478e47706520afccabbd380304f2dc3a3fdb8709 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:13:01 +0000
Subject: [PATCH 14/17] Use consistent notation for array registers

---
 Device.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/Device.md b/Device.md
index 8065ca6..f69ba17 100644
--- a/Device.md
+++ b/Device.md
@@ -63,8 +63,8 @@ The following set of Device core registers MUST be implemented. These reserved r
 |[`R_SERIAL_NUMBER`](#r_serial_number-u16--device-serial-number)|No|No|U16|013|b)|Unique serial number of the device|Deprecated|
 |[`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration)|No|No|U8|014|b)|Synchronization clock configuration|Optional|
 |[`R_TIMESTAMP_OFFSET`](#r_timestamp_offset-u8--clock-calibration-offset)|No|No|U8|015|b)|Configures an offset for Timestamp updates|Deprecated|
-|[`R_UID`](#r_uid-16-bytes--unique-identifier)|No|Yes|U8|016|b)|Stores a unique identifier (UID) |Optional|
-|[`R_TAG`](#r_tag-8-bytes--firmware-tag)|-|Yes|U8|017|b)|Firmware tag|Optional|
+|[`R_UID`](#r_uid-u8-array--unique-identifier)|No|Yes|U8|016|b)|Stores a unique identifier (UID) |Optional|
+|[`R_TAG`](#r_tag-u8-array--firmware-tag)|-|Yes|U8|017|b)|Firmware tag|Optional|
 |[`R_HEARTBEAT`](#r_heartbeat-u16--device-status-information)|Yes|Yes|U16|018|b)|Monitors device status|Required|
 |[`R_VERSION`](#r_version-u8--device-version-information)|-|Yes|U8|019|a)|Device version information|Required|
 
@@ -382,7 +382,7 @@ The implementation of this register is RECOMMENDED if the Device provides a [Syn
 >
 > The Device MUST always boot with the timestamp register in the unlocked state.
 
-### **`R_UID` (16 Bytes) – Unique Identifier**
+### **`R_UID` (U8 Array) – Unique Identifier**
 
 Address: `016`
 
@@ -408,7 +408,7 @@ gantt
 
 An array of 16 bytes specifying a (128-bit) UID (Unique Identifier) for the Device. This register is non-volatile and read-only. The byte-order is little-endian. If not implemented, the Device MUST return a default value of `0` (Zero) for all bytes.
 
-### **`R_TAG` (8 Bytes) – Firmware tag**
+### **`R_TAG` (U8 Array) – Firmware tag**
 
 Address: `017`
 
@@ -740,7 +740,7 @@ Contains the minor firmware version number. The value of this register is persis
 
 > [!WARNING]
 >
-> This register is deprecated in favor of [`R_UID`](#r_uid-16-bytes--unique-identifier). The value of this register MUST duplicate the first two bytes of `R_UID`, in little-endian order.
+> This register is deprecated in favor of [`R_UID`](#r_uid-u8-array--unique-identifier). The value of this register MUST duplicate the first two bytes of `R_UID`, in little-endian order.
 
 Address: `013`
 

From 43cf752e496425788cf2def08f713bfc9364791f Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:17:17 +0000
Subject: [PATCH 15/17] Missing requirements language

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index f69ba17..58dc220 100644
--- a/Device.md
+++ b/Device.md
@@ -467,7 +467,7 @@ gantt
 
 This register is read-only and used to provide status information about the Device. Any changes to the below bits are controlled by the Device and sent to the Controller through a periodic `Event` message. If periodic reporting is enabled by setting [`R_OPERATION_CTRL`](#r_operation_ctrl-u8--operation-mode-configuration) bit `HEARTBEAT_EN`, the Device MUST emit a periodic event on this register at a rate of 1 Hz, in sync with updates to the [`R_TIMESTAMP_SECOND`](#r_timestamp_second-u32--system-timestamp-seconds) register.
 
-* **IS_ACTIVE [Bit 0]:** If this bit is set, the Device MUST be in `Active` mode. The bit must be cleared if the Device is in any other mode (see [Operation Mode](#operation-mode) for information on available device modes).
+* **IS_ACTIVE [Bit 0]:** If this bit is set, the Device MUST be in `Active` mode. This bit MUST be cleared if the Device is in any other mode (see [Operation Mode](#operation-mode) for information on available device modes).
 
 * **IS_SYNCHRONIZED [Bit 1]:** If this bit is set, the Device MUST be synchronized with an external Harp clock generator. If the Device is itself a clock generator (see [`R_CLOCK_CONFIG`](#r_clock_config-u8--synchronization-clock-configuration) bit `CLK_GEN`), this bit MUST always be set.
 

From 2b9a6d268a5585d11197c631d3769f331a0f4d06 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:20:59 +0000
Subject: [PATCH 16/17] Clarify wording of INTERFACE_HASH

---
 Device.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Device.md b/Device.md
index 58dc220..e9b792c 100644
--- a/Device.md
+++ b/Device.md
@@ -522,7 +522,7 @@ The bytes in this register specify the [semantic version](https://semver.org/) o
 
 * **SDK_ID:** The three-character code of the core microcontroller SDK used to implement the Device.
 
-* **INTERFACE_HASH:** The SHA-1 hash value of the Device Interface schema file (`device.yml`). The byte-order is little-endian. If the client SHOULD NOT perform any validation of its Device Interface schema, the Device MUST set this value to `0` (Zero). 
+* **INTERFACE_HASH:** The SHA-1 hash value of the Device Interface schema file (`device.yml`). The byte-order is little-endian. The Controller SHOULD NOT perform any validation of its Device Interface schema if this value is set to `0` (Zero). 
 
 ## Deprecated Core Registers
 

From 5a01ada0fbd8add726760bf5f613ea7f533eef24 Mon Sep 17 00:00:00 2001
From: glopesdev <g.lopes@neurogears.org>
Date: Thu, 27 Nov 2025 22:25:40 +0000
Subject: [PATCH 17/17] Use consistent wording for references to WHO_AM_I

---
 Device.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Device.md b/Device.md
index e9b792c..cc4501a 100644
--- a/Device.md
+++ b/Device.md
@@ -47,7 +47,7 @@ The following set of Device core registers MUST be implemented. These reserved r
 
 |**Name**|**Volatile**|**Read Only**|**Type**|**Add.**|**Default**|**Brief Description**|**Necessity**|
 | :- | :-: | :-: | :-: | :-: | :-: | :- | :-: |
-|[`R_WHO_AM_I`](#r_who_am_i-u16--device-identity-class)|-|Yes|U16|000|a)|Product identifier|Required|
+|[`R_WHO_AM_I`](#r_who_am_i-u16--device-identity-class)|-|Yes|U16|000|a)|Device identity class|Required|
 |[`R_HW_VERSION_H`](#r_hw_version_h-u8--major-hardware-version)|-|Yes|U8|001|a)|Major Hardware version|Deprecated|
 |[`R_HW_VERSION_L`](#r_hw_version_l-u8--minor-hardware-version)|-|Yes|U8|002|a)|Minor Hardware version|Deprecated|
 |[`R_ASSEMBLY_VERSION`](#r_assembly_version-u8--version-of-assembled-components)|-|Yes|U8|003|a)|Version of assembled components|Deprecated|
@@ -765,7 +765,7 @@ gantt
     -      :d1, 0, 2
 ```
 
-Specifies a device serial number. If this register is implemented, the number SHOULD be unique for each unit with the same device product identifier stored in `R_WHO_AM_I`. If the register functionality is not implemented, the Device MUST reply to any `Read` requests with a fixed default value of `0` (Zero).
+Specifies a device serial number. If this register is implemented, the number SHOULD be unique for each unit with the same device identity class stored in `R_WHO_AM_I`. If the register functionality is not implemented, the Device MUST reply to any `Read` requests with a fixed default value of `0` (Zero).
 
 Supporting `Write` requests to this register is OPTIONAL. If `Write` requests are supported, the following two-step write sequence MUST be implemented: