From c449a258f1de107f2f80ec36ec14947b07f222bf Mon Sep 17 00:00:00 2001
From: Gordon Williams <gw@pur3.co.uk>
Date: Wed, 24 Jun 2020 09:55:28 +0100
Subject: [PATCH] Added Espruino control (fix #417)

---
 apps.json                     |  14 ++
 apps/espruinoctrl/ChangeLog   |   1 +
 apps/espruinoctrl/README.md   |  28 ++++
 apps/espruinoctrl/app-icon.js |   1 +
 apps/espruinoctrl/app.png     | Bin 0 -> 1302 bytes
 apps/espruinoctrl/custom.html | 275 ++++++++++++++++++++++++++++++++++
 6 files changed, 319 insertions(+)
 create mode 100644 apps/espruinoctrl/ChangeLog
 create mode 100644 apps/espruinoctrl/README.md
 create mode 100644 apps/espruinoctrl/app-icon.js
 create mode 100644 apps/espruinoctrl/app.png
 create mode 100644 apps/espruinoctrl/custom.html

diff --git a/apps.json b/apps.json
index 14feabe80..eb9b7b6a3 100644
--- a/apps.json
+++ b/apps.json
@@ -1987,5 +1987,19 @@
     "storage": [
       {"name":"gpsautotime.wid.js","url":"widget.js"}
     ]
+  },
+  { "id": "espruinoctrl",
+    "name": "Espruino Control",
+    "shortName":"Espruino Ctrl",
+    "icon": "app.png",
+    "version":"0.01",
+    "description": "Send commands to other Espruino devices via the Bluetooth UART interface. Customisable commands!",
+    "tags": "",
+    "readme": "README.md",
+    "custom": "custom.html",
+    "storage": [
+      {"name":"espruinoctrl.app.js"},
+      {"name":"espruinoctrl.img","url":"app-icon.js","evaluate":true}
+    ]
   }
 ]
diff --git a/apps/espruinoctrl/ChangeLog b/apps/espruinoctrl/ChangeLog
new file mode 100644
index 000000000..5560f00bc
--- /dev/null
+++ b/apps/espruinoctrl/ChangeLog
@@ -0,0 +1 @@
+0.01: New App!
diff --git a/apps/espruinoctrl/README.md b/apps/espruinoctrl/README.md
new file mode 100644
index 000000000..a7bca662c
--- /dev/null
+++ b/apps/espruinoctrl/README.md
@@ -0,0 +1,28 @@
+# Espruino Control
+
+Send commands to other Espruino devices via the Bluetooth UART interface.
+
+## Customising
+
+Click the customise button and you can customise your commands
+with 4 options:
+
+
+* **Title** - The title of the menu item that will be displayed
+* **Command** - The JS command to execute, eg. `LED.toggle()`
+* **MAC Address** - If specified, of the form `aa:bb:cc:dd:ee:ff`. The device
+with this address will be connected to directly. If not specified a menu
+showing available Espruino devices is popped up.
+* **RX** - If checked, the app will display any data received from the
+device being connected to. Use this if you want to print data - eg: `print(E.getBattery())`
+
+When done, click 'Upload'. Your changes will be saved to local storage
+so they'll be remembered next time you upload from the same device.s
+
+## Usage
+
+Simply load the app and you'll see a menu with the menu items
+you defined. Select one and you'll be able to connect to the device
+and send the command.
+
+If a command should wait for a response then
diff --git a/apps/espruinoctrl/app-icon.js b/apps/espruinoctrl/app-icon.js
new file mode 100644
index 000000000..70d2dd062
--- /dev/null
+++ b/apps/espruinoctrl/app-icon.js
@@ -0,0 +1 @@
+require("heatshrink").decompress(atob("mEwhH+AH4A/AH4A/AH4AFwIuuAAIllAAYIGF041IF34AKqwuuAANXF9QuCAANdGHqQgGBwvdGCIud5mjGB4udAAIwPFz3MSR61VFxQwNci4vGeh4uXGAguHGBK3WGA4AIegtXc69dGBxoBGAouWO4IwNe4gwZa4YwLFwikEFzAwLFwwwCFzQwKFw68YGB4AdF5AwmF5IwlF5QwkF5Yw/F8IwEL9WBB4IuuADwuzGxAugFAgliGBYutAH4A/AH4A/ADA="))
diff --git a/apps/espruinoctrl/app.png b/apps/espruinoctrl/app.png
new file mode 100644
index 0000000000000000000000000000000000000000..900861e43729a5385ffe8352888915c2d4653c50
GIT binary patch
literal 1302
zcmV+x1?l>UP)<h;3K|Lk000e1NJLTq001xm001xu1^@s6R|5Hm00006VoOIv0RI60
z0RN!9r;`8x1j|W8K~!jg?O1J0TV)h}-rMr2i4>?ZmN^iIB{MNu%(l4E0-}r2scX4p
zZrw1(#6MHOm~3N<^2fPpB5Z!d9|jg#m#vI$ktK7+tYJWmOVlMQo7Rn@K(&-XbOZWz
zk3XQ@rK7#~;ss3X^N;f$&ig#?Ip@BoFOWnMNhGn9U`tIP9-3_q9)vC9%XK>&%gaOY
z{Qi>yX2>50pk=_RvE{lK;)&2MCb1)SyIu%rod8zfu}C;nx5K>Wu+6cR2yGE=1XSq;
z$NT`SbH!XV0Zpx^vxESBfw{;70K@L4V-5omo{r%a7C4-X7k42`hyfq~IB2)ulO9a@
z3Pg`8j1eY=n)>Z#TcS-=M`L3n_v4LV3j?`I*KYhkz~q+zTc<Eg2q0^n)p9bCljdLW
zoD)3HYrI-r3qUmhDsJBT>tTIPPKDAq#BiqGYI#%2kDC|EL>uR?`e=qc0AO@{e6y?H
zeL-m)Mld(GISxwssV+bWQyYN4#kN03d=<Z3@9$C^jA6Hwi|PU#AHLHo2=o+UM0kCp
zrg@2wfa(H(X%Ua)xnE4z1_iNwAw(?5JwRO<E5JJ5y*iT59q6@SGL#x!^ZG_j0J@4F
zC^V_Dm-<cIm9YX$aDq@|$Q{Ps#~eWo6DGwzYGy)J0b=qqra(#VkR=#qPhifTaCb|D
z?33D4u>hXuHC43@pO|a+8O8Rw$b(SD%KV-28{1c!AQOE=RH>=}p64}`x2gq%S2&_`
z=GPj^Z?A@HMCAP-JkQGfosm^VUngSUhqx3|{SJ#qO#w_;R@@4Poil%DazJM^6UM;X
z01jjN<at)+zheN4h>+-sZ-umA<r~{J`{a;PB7ivHa*XY+NG2Eq!RW7thSrErJ{BF-
z@8A8F(XPqR24>m4zERUv*RP**NUwOky84D(Qi@8bbnS*u^*K2mG3HDTI2#ecHU@r*
z_y2S;Z4(G*N^*x%8#Z(x_MY&KjX&FcspnNCoMa1VYCWALVCwusMTM4SdVOr;MMX%F
z2apZ`2L14WK|j0=z^z$+gkmU|l4S|_*mhROrO<f*>j9vsaHUC!h*<Jq7yz;I{d;XE
z1%Wo<c4MDlf4E-4%<l*}kQ}Gq`^<4K5WWD0HDY_VE~_9I2zK3^m?#jLQy9P-)|GyJ
z<(qCd08mfrY6#33B@bMOhAU&nsR01Ea;fKc!+K*cV+b&h>*e<L_OM*?fQ(c%A9M5p
zD2caz&HbCx<Mqa#`h);H<2Z7_Nd$(AX-xoXBPY*HQ~gRvCW4$2ic1~<iVE&8PgG9P
zuM=oLIL@dhc|cwUWYy!f{(&yf$Vlvf7R|)G*vWuuvyjrpRtu^Qb4wvY^>KQ!MMw)^
z*rPOPQQ=Bco<28rRL<mpYNfHHASs}3yZI1-PALuiU|~V2K0DhXGM!)^*Dj@Tq#${b
zHQO9K1KS7X<@Q~E&V5zxp+PTzG3Ieum0nVEknl4qekE2I_p*>0dR#PBMxPngM%+`4
zLp}_!gin18_(2;+Wz0ytAmo7r0+@j3Fq?dcF<9%YTec=>?4Py4(387r%%iHZOn|s0
zWVhQj!vXD4Oux%Zz7j7L681o&)2Y=BjvXaNol>vFNhFa(68}&91AovF7oUbDTL1t6
M07*qoM6N<$g0ps59{>OV

literal 0
HcmV?d00001

diff --git a/apps/espruinoctrl/custom.html b/apps/espruinoctrl/custom.html
new file mode 100644
index 000000000..e6297cf2e
--- /dev/null
+++ b/apps/espruinoctrl/custom.html
@@ -0,0 +1,275 @@
+<html>
+  <head>
+    <link rel="stylesheet" href="../../css/spectre.min.css">
+    <link rel="stylesheet" href="../../css/spectre-exp.min.css">
+    <link rel="stylesheet" href="../../css/spectre-icons.min.css">
+    <style>
+    .badgeerror[data-badge]::after { background-color: red; }
+    </style>
+  </head>
+  <body>
+    <p>Enter the menu items you'd like to see appear in the app below. <code>MAC Address</code> is the MAC address
+    of the device to use. If it isn't specified then a menu will be presented showing available devices.</p>
+    <div style="overflow-x:scroll">
+    <table class="table">
+      <thead>
+        <tr>
+          <th>Title</th>
+          <th>Command</th>
+          <th>MAC Address</th>
+          <th>RX</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody id="tbody">
+      </tbody>
+    </table>
+  </div>
+    <p><button id="upload" class="btn btn-primary">Upload to Bangle.js</button></p>
+
+    <script src="../../lib/customize.js"></script>
+
+    <script>
+      var options;
+      try {
+        options = JSON.parse(localStorage.getItem("espruinoctrl"));
+      } catch (e) {}
+      if (!Array.isArray(options))
+        setDefaults();
+
+      function setDefaults() {
+        options = [
+          {"title":"Blink LED",cmd:"digitalPulse(LED1,1,100)",mac:"",rx:false},
+          {"title":"Restart",cmd:"load()",mac:"",rx:false},
+          {"title":"process.env",cmd:"print(process.env)",mac:"",rx:true},
+          {"title":"Battery",cmd:"print(`Battery ${E.getBattery()}%`)",mac:"",rx:true},
+        ];
+      }
+
+      function changed() {
+        localStorage.setItem("espruinoctrl",JSON.stringify(options));
+      }
+
+      function isMACValid(mac) {
+        return mac.trim().match(/^[A-Fa-f0-9][A-Fa-f0-9]:[A-Fa-f0-9][A-Fa-f0-9]:[A-Fa-f0-9][A-Fa-f0-9]:[A-Fa-f0-9][A-Fa-f0-9]:[A-Fa-f0-9][A-Fa-f0-9]:[A-Fa-f0-9][A-Fa-f0-9]$/)!=null;
+      }
+
+      function refresh() {
+        var tbody = document.getElementById("tbody");
+        tbody.innerHTML = "";
+        options.forEach((option,idx)=>{
+          var tr = document.createElement("tr");
+          tr.innerHTML = `
+            <td><input type="text" name="title"></td>
+            <td><input type="text" name="command"></td>
+            <td><span data-badge="!"><input type="text" name="mac"></span></td>
+            <td><label class="form-switch"><input type="checkbox"><i class="form-icon"></i></label></td>
+            <td><button class="btn btn-action"><i class="icon icon-delete"></i></button></td>
+          `;
+          var titleInput = tr.children[0].firstChild;
+          titleInput.value = option.title;
+          titleInput.addEventListener("change", function(e) {
+            option.title = titleInput.value;
+            changed();
+          });
+          var cmdInput = tr.children[1].firstChild;
+          cmdInput.value = option.cmd;
+          cmdInput.addEventListener("change", function(e) {
+            option.cmd = cmdInput.value;
+            changed();
+          });
+          var warningspan = tr.children[2].firstChild;
+          var macInput = warningspan.firstChild;
+          macInput.value = option.mac;
+          macInput.addEventListener("change", function(e) {
+            if (isMACValid(macInput.value)) {
+              warningspan.classList.remove("badge");
+              warningspan.classList.remove("badgeerror");
+            } else {
+              warningspan.classList.add("badge");
+              warningspan.classList.add("badgeerror");
+            }
+            option.mac = macInput.value.trim();
+            changed();
+          });
+          var cmdRX = tr.children[3].firstChild.firstChild;
+          cmdRX.checked = option.rx;
+          cmdRX.addEventListener("change", function(e) {
+            option.rx = cmdRX.checked;
+            changed();
+          });
+          tr.children[4].firstChild.addEventListener("click", function() {
+            options.splice(idx,1);
+            changed();
+            refresh();
+          });
+          tbody.appendChild(tr);
+        });
+        var tr = document.createElement("tr");
+        tr.innerHTML = `
+          <td></td>
+          <td></td>
+          <td><button class="btn">Reset to Defaults</button></td>
+          <td></td>
+          <td><button class="btn btn-action"><i class="icon icon-plus"></i></button></td>
+        `;
+        tr.children[2].firstChild.addEventListener("click", function() {
+          setDefaults();
+          changed();
+          refresh();
+        });
+        tr.children[4].firstChild.addEventListener("click", function() {
+          options.push({"title":"",cmd:"",mac:""});
+          changed();
+          refresh();
+        });
+        tbody.appendChild(tr);
+      }
+
+
+      refresh();
+      document.getElementById("upload").addEventListener("click", function() {
+        var app = `
+var menu = {
+  "" : {title:"Espruino Ctrl"},
+  ${options.filter(o=>o.title.trim()!="").map(o=>
+      `${JSON.stringify(o.title)} : ()=>cmd(${JSON.stringify(o.cmd.trim())},${JSON.stringify(isMACValid(o.mac)?o.mac:undefined)},${!!o.rx})`
+    ).join(",\n  ")},
+  "< Back" : () => load()
+};
+
+var knownDevices = [
+  "Espruino","MDBT42Q","Puck.js","Bangle.js","Pixl.js"
+];
+
+Bangle.loadWidgets();
+Bangle.drawWidgets();
+E.showMenu(menu);
+
+function cmd(cmd,mac,rx) {
+  cmd = "\\x03\\x10"+cmd+"\\n";
+  var send = rx ? sendCommandRX : sendCommand;
+  var m;
+  E.showMenu();
+  function onDone() {
+    E.showMenu(menu);
+  }
+  function err(msg) {
+    print("Error:",msg);
+    E.showAlert(msg.toString(),"Error").then(function() {
+      E.showMenu(m || menu);
+    });
+  }
+
+  if (mac) {
+    E.showMessage("Connecting\\n"+mac);
+    if (mac.length==17) mac+=" random";
+    NRF.connect(mac).then(dev=>send(dev,cmd,onDone)).catch(err);
+  } else {
+    E.showMessage("Scanning...");
+    NRF.findDevices(devices => {
+      m =  { "" : {title:"Devices"} };
+      devices.filter(dev=>dev.name &&
+        knownDevices.some(n=>dev.name.startsWith(n))
+      ).forEach(dev=>{
+        m[dev.name] = ()=>{
+          dev.gatt.connect().then(dev=>send(dev,cmd,onDone)).catch(err);
+        };
+      });
+      m["< Back"] = onDone;
+      E.showMenu(m);
+    },{active:true});
+  }
+}
+
+
+// Send a command to a connected device, get response
+function sendCommandRX(device, text, callback) {
+  var service,rx,tx;
+  var timeout;
+  E.showMessage("Connected");
+
+  return new Promise((resolve,reject) => {
+    function done() {
+      Terminal.println("\\n============\\n     Disconnected");
+      device.disconnect();
+      setTimeout(function() {
+        setWatch(function() {
+          if (callback) callback();
+          resolve();
+        }, BTN3);
+        g.reset().setFont("6x8",2).setFontAlign(0,0,1);
+        g.drawString("Back", g.getWidth()-10, g.getHeight()-50);
+      }, 200);
+    }
+    device.getPrimaryService("6e400001-b5a3-f393-e0a9-e50e24dcca9e").then(function(s) {
+      service = s;
+      return service.getCharacteristic("6e400002-b5a3-f393-e0a9-e50e24dcca9e");
+    }).then(function(c) {
+      tx = c;
+      return service.getCharacteristic("6e400003-b5a3-f393-e0a9-e50e24dcca9e");
+    }).then(function(c) {
+      rx = c;
+      rx.on('characteristicvaluechanged', function(event) {
+        if (timeout) clearTimeout(timeout);
+        timeout = setTimeout(done, 500);
+        Terminal.print(E.toString(event.target.value.buffer));
+      });
+      return rx.startNotifications();
+    }).then(function() {
+      E.showMessage("Sending...\\n");
+      function sender(resolve, reject) {
+        if (text.length) {
+          tx.writeValue(text.substr(0,20)).then(()=>{
+            sender(resolve, reject);
+          }).catch(reject);
+          text = text.substr(20);
+        } else  {
+          resolve();
+        }
+      }
+      return new Promise(sender);
+    }).then(function() {
+      if (timeout) clearTimeout(timeout);
+      timeout = setTimeout(done, 500);
+    }).catch(err => {
+      if (timeout) clearTimeout(timeout);
+      reject(err);
+    });
+  });
+}
+
+// Send a command to a connected device
+function sendCommand(device, text, callback) {
+  E.showMessage("Connected");
+  return device.getPrimaryService("6e400001-b5a3-f393-e0a9-e50e24dcca9e").then(function(s) {
+    return s.getCharacteristic("6e400002-b5a3-f393-e0a9-e50e24dcca9e");
+  }).then(function(c) {
+    E.showMessage("Sending...");
+    function sender(resolve, reject) {
+      if (text.length) {
+        c.writeValue(text.substr(0,20)).then(()=>{
+          sender(resolve, reject);
+        }).catch(reject);
+        text = text.substr(20);
+      } else  {
+        resolve();
+      }
+    }
+    return new Promise(sender);
+  }).then(function() {
+    E.showMessage("Disconnect");
+    device.disconnect();
+    if (callback) callback();
+  });
+}
+`;
+        sendCustomizedApp({
+          storage:[
+            {name:"espruinoctrl.app.js", content:app},
+          ]
+        });
+      });
+    </script>
+  </body>
+</html>