From 8c227a5a1809d7fa719838e89076edc42cd6316b Mon Sep 17 00:00:00 2001
From: Randy Mackay <rmackay9@yahoo.com>
Date: Mon, 10 Feb 2020 14:27:53 +0900
Subject: [PATCH] AP_Scripting: add esc-usage.lua

example script to retrieve esc usage time
---
 libraries/AP_Scripting/examples/esc-usage.lua | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 libraries/AP_Scripting/examples/esc-usage.lua

diff --git a/libraries/AP_Scripting/examples/esc-usage.lua b/libraries/AP_Scripting/examples/esc-usage.lua
new file mode 100644
index 0000000000..5ffbecfb0c
--- /dev/null
+++ b/libraries/AP_Scripting/examples/esc-usage.lua
@@ -0,0 +1,31 @@
+-- This script displays ESC usage time (supported only by ToshibaCAN ESCs)
+
+local usage_hours_max = 100 -- maximum safe usage for these ESCs in hours
+local usage_sec_max = usage_hours_max*60*60
+
+function update() -- this is the loop which periodically runs
+  if not arming:is_armed() then -- only run check when disarmed
+    local got_esc_usage = false
+    local esc_over_max = false
+    for i = 0, 3 do -- check first four ESCs
+      local usage_sec = esc_telem:get_usage_seconds(i)
+      if usage_sec > 0 then
+        got_esc_usage = true
+      end
+      if usage_sec > usage_sec_max then
+          esc_over_max = true
+          local usage_hours = usage_sec / 3600
+          local usage_minutes = (usage_sec / 60) % 60
+          gcs:send_text(0, string.format("ESC" .. tostring(i) .. ": " .. tostring(usage_hours) .. "hrs " .. tostring(usage_minutes) .. "min (limit is " .. tostring(usage_hours_max) .. "hrs)"))
+      end
+    end
+    if not got_esc_usage then
+      gcs:send_text(0, "Could not retrieve ESC usage time")
+    elseif not esc_over_max then
+      gcs:send_text(0, string.format("ESC usage time OK (under " .. tostring(usage_hours_max) .. "hrs limit)"))
+    end
+  end
+  return update, 5000 -- reschedules the loop in 5 seconds
+end
+
+return update() -- run immediately before starting to reschedule