Release 3.33.1 documentation (#1405)

* docs: Release 3.33.1 * doc: Add featured section * doc: Fix `v3.33.0` `whats-new` * doc: Fix API messages --------- Co-authored-by: Aleksander Borowski <aleksander.borowski@thethingsindustries.com>
TheThingsIndustries · Feb 11, 2025 · ca4fdd4 · ca4fdd4
1 parent 7c68b2d
commit ca4fdd4
Show file tree

Hide file tree

Showing 18 changed files with 507 additions and 29 deletions.
diff --git a/doc/config/_default/config.toml b/doc/config/_default/config.toml
@@ -23,7 +23,7 @@ pygmentsUseClasses = true
   github_repository = "https://github.com/TheThingsIndustries/lorawan-stack-docs"
   github_repository_edit = "https://github.com/TheThingsIndustries/lorawan-stack-docs/blob/master/doc/content"
   tts_github_repository = "https://github.com/TheThingsNetwork/lorawan-stack"
-  version = "3.33.0"
+  version = "3.33.1"
 
 [markup]
   [markup.goldmark]

diff --git a/doc/content/api/reference/grpc/application_server.md b/doc/content/api/reference/grpc/application_server.md
@@ -120,6 +120,8 @@ List of Application Server APIs.
 
 {{< proto/message message="KeyEnvelope" >}}
 
+{{< proto/message message="LastBatteryPercentage" >}}
+
 {{< proto/message message="Location" >}}
 
 {{< proto/message message="LoRaDataRate" >}}

diff --git a/doc/content/api/reference/grpc/network_server.md b/doc/content/api/reference/grpc/network_server.md
@@ -142,6 +142,8 @@ List of Network Server APIs.
 
 {{< proto/message message="KeyEnvelope" >}}
 
+{{< proto/message message="LastBatteryPercentage" >}}
+
 {{< proto/message message="Location" >}}
 
 {{< proto/message message="LoRaDataRate" >}}

diff --git a/doc/content/api/reference/grpc/storage_integration.md b/doc/content/api/reference/grpc/storage_integration.md
@@ -63,6 +63,8 @@ List of Storage Integration APIs.
 
 {{< proto/message message="KeyEnvelope" >}}
 
+{{< proto/message message="LastBatteryPercentage" >}}
+
 {{< proto/message message="LoRaDataRate" >}}
 
 {{< proto/message message="Location" >}}

diff --git a/doc/content/enterprise/aws/ecs/changelog/index.md b/doc/content/enterprise/aws/ecs/changelog/index.md
@@ -1,15 +1,15 @@
 ---
 title: "Template Changelog"
-aliases:
-  [/getting-started/aws/ecs/changelog, /the-things-stack/host/aws/ecs/changelog]
+aliases: [/getting-started/aws/ecs/changelog]
 ---
-
 # Upgrading
 
 All meaningful changes to templates are documented in this file.
 
 ## Unreleased
 
+## 3.33.1
+
 ## 3.33.0
 
 ## 3.32.3

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_applications_storage_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_applications_storage_get.md
@@ -157,6 +157,7 @@ ttn-lw-cli applications storage get [application-id] [flags]
       --up.uplink-message.f-port                                                            select the up.uplink_message.f_port field
       --up.uplink-message.frm-payload                                                       select the up.uplink_message.frm_payload field
       --up.uplink-message.last-a-f-cnt-down                                                 select the up.uplink_message.last_a_f_cnt_down field
+      --up.uplink-message.last-battery-percentage                                           select the up.uplink_message.last_battery_percentage field and all allowed sub-fields
       --up.uplink-message.locations                                                         select the up.uplink_message.locations field
       --up.uplink-message.network-ids                                                       select the up.uplink_message.network_ids field and all allowed sub-fields
       --up.uplink-message.network-ids.cluster-address                                       select the up.uplink_message.network_ids.cluster_address field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_storage_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_end-devices_storage_get.md
@@ -160,6 +160,7 @@ ttn-lw-cli end-devices storage get [application-id] [device-id] [flags]
       --up.uplink-message.f-port                                                            select the up.uplink_message.f_port field
       --up.uplink-message.frm-payload                                                       select the up.uplink_message.frm_payload field
       --up.uplink-message.last-a-f-cnt-down                                                 select the up.uplink_message.last_a_f_cnt_down field
+      --up.uplink-message.last-battery-percentage                                           select the up.uplink_message.last_battery_percentage field and all allowed sub-fields
       --up.uplink-message.locations                                                         select the up.uplink_message.locations field
       --up.uplink-message.network-ids                                                       select the up.uplink_message.network_ids field and all allowed sub-fields
       --up.uplink-message.network-ids.cluster-address                                       select the up.uplink_message.network_ids.cluster_address field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_create.md b/doc/content/ttn-lw-cli/ttn-lw-cli_tenants_create.md
@@ -65,6 +65,7 @@ ttn-lw-cli tenants create [tenant-id] [flags]
       --initial-user.attributes stringToString                                                          
       --initial-user.client-limit uint                                                                  
       --initial-user.console-preferences.console-theme string                                           allowed values: CONSOLE_THEME_SYSTEM, CONSOLE_THEME_LIGHT, CONSOLE_THEME_DARK
+      --initial-user.console-preferences.tutorials.seen strings                                         allowed values: TUTORIAL_UNKNOWN, TUTORIAL_LIVE_DATA_SPLIT_VIEW
       --initial-user.description string                                                                 
       --initial-user.gateway-limit uint                                                                 
       --initial-user.ids.user-id string                                                                 

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_users_create.md b/doc/content/ttn-lw-cli/ttn-lw-cli_users_create.md
@@ -19,6 +19,7 @@ ttn-lw-cli users create [user-id] [flags]
       --attributes stringToString                      
       --client-limit uint                              
       --console-preferences.console-theme string       allowed values: CONSOLE_THEME_SYSTEM, CONSOLE_THEME_LIGHT, CONSOLE_THEME_DARK
+      --console-preferences.tutorials.seen strings     allowed values: TUTORIAL_UNKNOWN, TUTORIAL_LIVE_DATA_SPLIT_VIEW
       --description string                             
       --gateway-limit uint                             
   -h, --help                                           help for create

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_users_get.md b/doc/content/ttn-lw-cli/ttn-lw-cli_users_get.md
@@ -24,6 +24,7 @@ ttn-lw-cli users get [user-id] [flags]
       --console-preferences.dashboard-layouts   select the console_preferences.dashboard_layouts field and all allowed sub-fields
       --console-preferences.sort-by             select the console_preferences.sort_by field and all allowed sub-fields
       --console-preferences.tutorials           select the console_preferences.tutorials field and all allowed sub-fields
+      --console-preferences.tutorials.seen      select the console_preferences.tutorials.seen field
       --contact-info                            select the contact_info field
       --deleted-at                              select the deleted_at field
       --description                             select the description field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_users_list.md b/doc/content/ttn-lw-cli/ttn-lw-cli_users_list.md
@@ -24,6 +24,7 @@ ttn-lw-cli users list [flags]
       --console-preferences.dashboard-layouts   select the console_preferences.dashboard_layouts field and all allowed sub-fields
       --console-preferences.sort-by             select the console_preferences.sort_by field and all allowed sub-fields
       --console-preferences.tutorials           select the console_preferences.tutorials field and all allowed sub-fields
+      --console-preferences.tutorials.seen      select the console_preferences.tutorials.seen field
       --contact-info                            select the contact_info field
       --deleted                                 
       --deleted-at                              select the deleted_at field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_users_search.md b/doc/content/ttn-lw-cli/ttn-lw-cli_users_search.md
@@ -25,6 +25,7 @@ ttn-lw-cli users search [flags]
       --console-preferences.dashboard-layouts   select the console_preferences.dashboard_layouts field and all allowed sub-fields
       --console-preferences.sort-by             select the console_preferences.sort_by field and all allowed sub-fields
       --console-preferences.tutorials           select the console_preferences.tutorials field and all allowed sub-fields
+      --console-preferences.tutorials.seen      select the console_preferences.tutorials.seen field
       --contact-info                            select the contact_info field
       --deleted                                 
       --deleted-at                              select the deleted_at field

diff --git a/doc/content/ttn-lw-cli/ttn-lw-cli_users_set.md b/doc/content/ttn-lw-cli/ttn-lw-cli_users_set.md
@@ -19,6 +19,7 @@ ttn-lw-cli users set [user-id] [flags]
       --attributes stringToString                      
       --client-limit uint                              
       --console-preferences.console-theme string       allowed values: CONSOLE_THEME_SYSTEM, CONSOLE_THEME_LIGHT, CONSOLE_THEME_DARK
+      --console-preferences.tutorials.seen strings     allowed values: TUTORIAL_UNKNOWN, TUTORIAL_LIVE_DATA_SPLIT_VIEW
       --description string                             
       --gateway-limit uint                             
   -h, --help                                           help for set

diff --git a/doc/content/whats-new/3.33.0.md b/doc/content/whats-new/3.33.0.md
@@ -42,7 +42,6 @@ featured:
 ### Fixed
 
 - Subscription nudge not showing correct device count in the Console.
-- Enforce default page limit on AS and NS List RPCs if a value is not provided in the request.
 - Fix OAuth client authorizations delete request in the Console.
 - Consecutive disconnect/reconnect messages in the Live Data view in the Console.
 - Set retention policy for `application_webhook_failure` table in the Network Operation Center's store.

diff --git a/doc/content/whats-new/3.33.1.md b/doc/content/whats-new/3.33.1.md
@@ -0,0 +1,26 @@
+---
+date: 2025-02-10T15:41:53Z
+title: "3.33.1"
+featured:
+  {
+    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.",
+      ],
+  }
+---
+
+### 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.
+- `LinkADRAns` MAC command verification when the end device does not support ADR.
+- Being able to remove all attributes in general settings.
diff --git a/doc/data/api/ttn.lorawan.v3/messages/ApplicationUplink.yml b/doc/data/api/ttn.lorawan.v3/messages/ApplicationUplink.yml
@@ -129,3 +129,11 @@ fields:
   message:
     name: NetworkIdentifiers
   default: {}
+- name: last_battery_percentage
+  comment: |-
+    Last battery percentage of the end device.
+    Received via the DevStatus MAC command at last_dev_status_received_at or earlier.
+    Set by the Network Server while handling the message.
+  message:
+    name: LastBatteryPercentage
+  default: {}
diff --git a/doc/data/api/ttn.lorawan.v3/messages/LastBatteryPercentage.yml b/doc/data/api/ttn.lorawan.v3/messages/LastBatteryPercentage.yml
@@ -0,0 +1,23 @@
+name: LastBatteryPercentage
+fields:
+- name: f_cnt
+  comment: Frame counter value of last uplink containing DevStatusAns.
+  type: uint32
+  default: 0
+- name: value
+  comment: |-
+    The battery percentage of the end device.
+    The value is defined in the [0, 100] interval.
+  message:
+    package: google.protobuf
+    name: FloatValue
+  rules:
+    lte: 100
+    gte: 0
+  default: null
+- name: received_at
+  comment: Time when last DevStatus MAC command was received.
+  message:
+    package: google.protobuf
+    name: Timestamp
+  default: "0001-01-01T00:00:00Z"