Merge branch 'v3.33' into v3.34

TheThingsNetwork · Jan 28, 2025 · 43c77c7 · 43c77c7
2 parents 4c69dbd + 15f18a5
commit 43c77c7
Show file tree

Hide file tree

Showing 88 changed files with 7,769 additions and 2,874 deletions.
diff --git a/.golangci.yml b/.golangci.yml
@@ -1,7 +1,3 @@
-run:
-  skip-dirs:
-    - node_modules
-
 linters:
   disable-all: true
   enable:
@@ -113,3 +109,6 @@ issues:
     - linters:
         - paralleltest
       text: 'does not use range value in test Run'
+  exclude-dirs:
+    - node_modules
+
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,18 +11,44 @@ For details about compatibility between different releases, see the **Commitment
 
 ### Added
 
+- Add recvTime field to the decodeUplink input in payload formatters
+- Add the latest battery percentage of the end device in the `ApplicationUplink` message.
+- Add live data split view tutorial to the Console.
+- Add end device attributes to ApplicationUp messages.
+  - Add the locations, version_ids, network_ids fields to the following ApplicationUp messages:
+    - ApplicationJoinAccept
+    - ApplicationDownlink
+    - ApplicationDownlinkFailed
+    - ApplicationInvalidatedDownlinks
+    - ApplicationServiceData
+  - Add Timeout and Cache fields in the EndDeviceMetadataStorageConfig of the AS.
+
 ### Changed
 
 ### Deprecated
 
+- Deprecate the Location field (and its subfields) in the EndDeviceMetadataStorageConfig of AS.
+
 ### Removed
 
 ### Fixed
 
+### Security
+
+## [3.33.1] - unreleased
+
+### Added
+
+- Add recvTime field to the decodeUplink input in payload formatters
+- Add the latest battery percentage of the end device in the `ApplicationUplink` message.
+- Add live data split view tutorial to the Console.
+
+### Fixed
+
 - Enforce default page limit on AS and NS List RPCs if a value is not provided in the request.
 - Swapped field order in `RelayNotifyNewEndDeviceReq` MAC command.
-
-### Security
+- `LinkADRAns` MAC command verification when the end device does not support ADR.
+- Being able to remove all attributes in general settings.
 
 ## [3.34.0] - unreleased
 
@@ -2936,7 +2962,8 @@ For details about compatibility between different releases, see the **Commitment
 NOTE: These links should respect backports. See https://github.com/TheThingsNetwork/lorawan-stack/pull/1444/files#r333379706.
 -->
 
-[unreleased]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.33.0...v3.33
+[unreleased]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.33.1...v3.33
+[3.33.1]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.33.0...v3.33.1
 [3.33.0]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.32.3...v3.33.0
 [3.32.2]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.32.2...v3.32.3
 [3.32.2]: https://github.com/TheThingsNetwork/lorawan-stack/compare/v3.32.1...v3.32.2

diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
diff --git a/api/ttn/lorawan/v3/api.md b/api/ttn/lorawan/v3/api.md
diff --git a/api/ttn/lorawan/v3/api.swagger.json b/api/ttn/lorawan/v3/api.swagger.json
@@ -20326,6 +20326,28 @@
         },
         "confirmed_retry": {
           "$ref": "#/definitions/ApplicationDownlinkConfirmedRetry"
+        },
+        "locations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/lorawanv3Location"
+          },
+          "description": "End device location metadata, set by the Application Server while handling the message."
+        },
+        "version_ids": {
+          "$ref": "#/definitions/v3EndDeviceVersionIdentifiers",
+          "description": "End device version identifiers, set by the Application Server while handling the message."
+        },
+        "network_ids": {
+          "$ref": "#/definitions/v3NetworkIdentifiers",
+          "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -20337,6 +20359,28 @@
         },
         "error": {
           "$ref": "#/definitions/v3ErrorDetails"
+        },
+        "locations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/lorawanv3Location"
+          },
+          "description": "End device location metadata, set by the Application Server while handling the message."
+        },
+        "version_ids": {
+          "$ref": "#/definitions/v3EndDeviceVersionIdentifiers",
+          "description": "End device version identifiers, set by the Application Server while handling the message."
+        },
+        "network_ids": {
+          "$ref": "#/definitions/v3NetworkIdentifiers",
+          "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -20377,6 +20421,28 @@
         "session_key_id": {
           "type": "string",
           "format": "byte"
+        },
+        "locations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/lorawanv3Location"
+          },
+          "description": "End device location metadata, set by the Application Server while handling the message."
+        },
+        "version_ids": {
+          "$ref": "#/definitions/v3EndDeviceVersionIdentifiers",
+          "description": "End device version identifiers, set by the Application Server while handling the message."
+        },
+        "network_ids": {
+          "$ref": "#/definitions/v3NetworkIdentifiers",
+          "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -20408,6 +20474,28 @@
           "type": "string",
           "format": "date-time",
           "description": "Server time when the Network Server received the message."
+        },
+        "locations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/lorawanv3Location"
+          },
+          "description": "End device location metadata, set by the Application Server while handling the message."
+        },
+        "version_ids": {
+          "$ref": "#/definitions/v3EndDeviceVersionIdentifiers",
+          "description": "End device version identifiers, set by the Application Server while handling the message."
+        },
+        "network_ids": {
+          "$ref": "#/definitions/v3NetworkIdentifiers",
+          "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -20907,6 +20995,28 @@
         },
         "data": {
           "type": "object"
+        },
+        "locations": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/lorawanv3Location"
+          },
+          "description": "End device location metadata, set by the Application Server while handling the message."
+        },
+        "version_ids": {
+          "$ref": "#/definitions/v3EndDeviceVersionIdentifiers",
+          "description": "End device version identifiers, set by the Application Server while handling the message."
+        },
+        "network_ids": {
+          "$ref": "#/definitions/v3NetworkIdentifiers",
+          "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -21068,6 +21178,17 @@
         "network_ids": {
           "$ref": "#/definitions/v3NetworkIdentifiers",
           "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "last_battery_percentage": {
+          "$ref": "#/definitions/v3LastBatteryPercentage",
+          "description": "Last battery percentage of the end device.\nReceived via the DevStatus MAC command at last_dev_status_received_at or earlier.\nSet by the Network Server while handling the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -21144,6 +21265,13 @@
         "network_ids": {
           "$ref": "#/definitions/v3NetworkIdentifiers",
           "description": "Network identifiers, set by the Network Server that handles the message."
+        },
+        "attributes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Attributes for devices, set by the Application Server while handling the message."
         }
       }
     },
@@ -25802,6 +25930,26 @@
         }
       }
     },
+    "v3LastBatteryPercentage": {
+      "type": "object",
+      "properties": {
+        "f_cnt": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Frame counter value of last uplink containing DevStatusAns."
+        },
+        "value": {
+          "type": "number",
+          "format": "float",
+          "description": "The battery percentage of the end device.\nThe value is defined in the [0, 100] interval."
+        },
+        "received_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Time when last DevStatus MAC command was received."
+        }
+      }
+    },
     "v3ListBandsResponse": {
       "type": "object",
       "properties": {