dmsg: ublox PL command

Author: addshore

devices/api/messages/53-ublox-protection-level.md

@@ -0,0 +1,42 @@
+---
+aside: false
+outline: false
+---
+
+<script setup>
+import ProtocolBytes from '../../../components/ProtocolBytes.vue';
+import SplitColumnView from '../../../components/SplitColumnView.vue';
+import GenerateConsts from '../../../components/GenerateConsts.vue'
+import PayloadTable from '../../../components/PayloadTable.vue'
+</script>
+
+::: danger ⚠️ Not yet public
+The Device API currently in development and is not yet accessible on production devices.
+
+These pages can be seen as a view of what is to come later this year.
+:::
+
+# 53: Ublox protection level
+
+<SplitColumnView>
+<template #left>
+
+Used to retrieve [ublox protection level](https://www.u-blox.com/en/technologies/protection-level) information, on devices that have
+
+</template>
+<template #right>
+
+<PayloadTable :messageId="53" headerText="Payload" headerMarginTop="0px" />
+
+</template>
+</SplitColumnView>
+
+## Examples
+
+TODO
+
+## Code
+
+For convenience, the following constants can be used to reference the payload fields.
+
+<GenerateConsts :messageId="53"/>

public/files/protocol-v3.yaml

@@ -672,6 +672,40 @@ messages:
             name: "Enable"
           2:
             name: "Disable"
+  53:
+    name: "Ublox Protection Level"
+    description: "Get information about the ublox protection level"
+    group: "ungrouped"
+    # Only supports GET
+    data:
+      1:
+        name: "PL Valid"
+        description: "Indicates if the protection level is valid"
+        type: "uint8"
+      2:
+        name: "PL X"
+        description: "Protection level in the X direction in mm"
+        type: "uint32"
+      3:
+        name: "PL Y"
+        description: "Protection level in the Y direction in mm"
+        type: "uint32"
+      4:
+        name: "PL Z"
+        description: "Protection level in the Z direction in mm"
+        type: "uint32"
+      5:
+        name: "Horizontal Orientation"
+        description: "Horizontal orientation of the protection level"
+        type: "uint16"
+      6:
+        name: "TMIR Coefficient"
+        description: "TMIR coefficient for protection level calculation"
+        type: "uint8"
+      7:
+        name: "TMIR Exponent"
+        description: "TMIR exponent for protection level calculation"
+        type: "int8"
   1004:
     name: "LORA"
     group: "ungrouped"