├── .vscode
    ├── launch.json
    └── settings.json
├── README.md
└── index.html


/.vscode/launch.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     // Use IntelliSense to learn about possible attributes.
 3 |     // Hover to view descriptions of existing attributes.
 4 |     // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
 5 |     "version": "0.2.0",
 6 |     "configurations": [
 7 |         {
 8 |             "type": "chrome",
 9 |             "request": "launch",
10 |             "name": "Launch Chrome against localhost",
11 |             "webRoot": "${workspaceFolder}",
12 |             "file": "${workspaceFolder}/index.html",
13 |             "disableNetworkCache": true
14 |         }
15 |     ]
16 | }


--------------------------------------------------------------------------------
/.vscode/settings.json:
--------------------------------------------------------------------------------
1 | {
2 |     "debug.allowBreakpointsEverywhere": true
3 | }


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Cyber Robot [Web Interface](https://rogalmic.github.io/cyber-robot-web-if/)
  2 | [Clementoni Cyber Robot](https://www.google.pl/search?q=Clementoni+cyber+robot&source=lnms&tbm=isch) web access via Google Chrome 
  3 | 
  4 | Chrome's Web Bluetooth "experimental web platform" feature in `chrome://flags/#enable-experimental-web-platform-features` (this needs to be done separately for Chrome-vscode debugging process, since different user folder is used). `Debugger for Chrome` extension needs to be installed to debug via VS Code launch configuration. [Link](https://rogalmic.github.io/cyber-robot-web-if/) to working sample after enabling BT.
  5 | 
  6 | Some info about protocol - [CyberRobotBrain java project](https://github.com/prof18/CyberRobotBrain/tree/master/app/src/main/java/com/clemgmelc/cyberrobotbrain)
  7 | 
  8 | 
  9 | # Bluetooth specific details
 10 | 
 11 | Some bluetooth Gatt info about the device:
 12 | 
 13 | ```
 14 | BTHLEDevice\{00001800-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&0001
 15 | BTHLEDevice\{00001801-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&000c
 16 | BTHLEDevice\{0000180a-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&0010
 17 | BTHLEDevice\{0000feba-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&0027
 18 | BTHLEDevice\{0000fff0-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&0047
 19 | BTHLEDevice\{0000fff3-0000-1000-8000-00805f9b34fb}_Dev_VID&0100c0_PID&0000_REV&0000_1b7e9706073d\9&8c643bc&0&0051
 20 | ```
 21 | 
 22 | ```
 23 | Requesting any Bluetooth Device...
 24 | Connecting to GATT Server...
 25 | Getting Services...
 26 | Getting Characteristics...
 27 | > Service: 00001800-0000-1000-8000-00805f9b34fb
 28 | >> Characteristic: 00002a00-0000-1000-8000-00805f9b34fb [READ]
 29 | >> Characteristic: 00002a01-0000-1000-8000-00805f9b34fb [READ]
 30 | >> Characteristic: 00002a02-0000-1000-8000-00805f9b34fb [READ]
 31 | >> Characteristic: 00002a04-0000-1000-8000-00805f9b34fb [READ]
 32 | > Service: 00001801-0000-1000-8000-00805f9b34fb
 33 | >> Characteristic: 00002a05-0000-1000-8000-00805f9b34fb [READ, INDICATE]
 34 | > Service: 0000180a-0000-1000-8000-00805f9b34fb
 35 | >> Characteristic: 00002a24-0000-1000-8000-00805f9b34fb [READ]
 36 | >> Characteristic: 00002a29-0000-1000-8000-00805f9b34fb [READ]
 37 | >> Characteristic: 00002a23-0000-1000-8000-00805f9b34fb [READ]
 38 | >> Characteristic: 00002a26-0000-1000-8000-00805f9b34fb [READ]
 39 | >> Characteristic: 00002a27-0000-1000-8000-00805f9b34fb [READ]
 40 | >> Characteristic: 00002a28-0000-1000-8000-00805f9b34fb [READ]
 41 | >> Characteristic: 00002a50-0000-1000-8000-00805f9b34fb [READ]
 42 | > Service: 0000feba-0000-1000-8000-00805f9b34fb
 43 | >> Characteristic: 0000fa12-0000-1000-8000-00805f9b34fb [READ]
 44 | >> Characteristic: 0000fa10-0000-1000-8000-00805f9b34fb [WRITEWITHOUTRESPONSE, NOTIFY]
 45 | >> Characteristic: 0000fa11-0000-1000-8000-00805f9b34fb [WRITE, INDICATE]
 46 | > Service: 0000fff3-0000-1000-8000-00805f9b34fb
 47 | >> Characteristic: 0000fff4-0000-1000-8000-00805f9b34fb [NOTIFY]
 48 | >> Characteristic: 0000fff5-0000-1000-8000-00805f9b34fb [WRITEWITHOUTRESPONSE] // MOVEMENT CHARACTERISTICS HERE
 49 | > Service: 0000fff0-0000-1000-8000-00805f9b34fb
 50 | >> Characteristic: 0000fff1-0000-1000-8000-00805f9b34fb [NOTIFY]
 51 | >> Characteristic: 0000fff6-0000-1000-8000-00805f9b34fb [NOTIFY]
 52 | >> Characteristic: 0000fff2-0000-1000-8000-00805f9b34fb [WRITE, NOTIFY]
 53 | ```
 54 | 
 55 | ```
 56 | Requesting any Bluetooth Device...
 57 | Connecting to GATT Server...
 58 | Getting Device Information Service...
 59 | Getting Device Information Characteristics...
 60 | > Manufacturer Name String: AMICCOM Elec.
 61 | > Model Number String: MD7107
 62 | > System ID: 
 63 |   > Manufacturer Identifier: 55AA55AA55
 64 |   > Organizationally Unique Identifier: AA55AA
 65 | > Manufacturer Name String: AMICCOM Elec.
 66 | > Firmware Revision String: 01.1
 67 | > System ID: 
 68 |   > Manufacturer Identifier: 55AA55AA55
 69 |   > Organizationally Unique Identifier: AA55AA
 70 | > Hardware Revision String: U01
 71 | > Firmware Revision String: 01.1
 72 | > Software Revision String: 0093
 73 | > Hardware Revision String: U01
 74 | > PnP ID:
 75 |   > Vendor ID Source: Bluetooth
 76 |   > Vendor ID: 192
 77 |   > Product ID: 0
 78 |   > Product Version: 0
 79 | > Software Revision String: 0093
 80 | > PnP ID:
 81 |   > Vendor ID Source: Bluetooth
 82 |   > Vendor ID: 192
 83 |   > Product ID: 0
 84 |   > Product Version: 0
 85 | ```
 86 | 
 87 | # Cyber Robot Sample Javascript Communication
 88 | 
 89 | Kindof-working communication sample (after enabling experimental feature in chrome):
 90 | ```
 91 | navigator.bluetooth.requestDevice({ filters: [{ services: ['0000fff3-0000-1000-8000-00805f9b34fb'] }] })
 92 | .then(device => device.gatt.connect())
 93 | .then(server => server.getPrimaryService('0000fff3-0000-1000-8000-00805f9b34fb'))
 94 | .then(service => service.getCharacteristic('0000fff5-0000-1000-8000-00805f9b34fb'))
 95 | .then(characteristic => {
 96 |   var forwardCommand = Uint8Array.of(0x31, 0x32, 0x44, 0x30, 0x53, 0x2d, 0x31);
 97 |   return characteristic.writeValue(forwardCommand);
 98 | })
 99 | .then(_ => {
100 |   console.log('Command sent.');
101 | })
102 | .catch(error => { console.log(error); });
103 | ```
104 | 
105 | # Cyber Robot Protocol
106 | 
107 | Single messages (full ASCII):
108 | ```
109 | move = `12D${p1}S${p2}`
110 | sound = `56${p1}E`
111 | led = `78${p1}`
112 | stop = `99SP`
113 | ```
114 | Sequence messages:
115 | ```
116 | binary_sequence[20] = `34(0x11, ..., 0x34)`
117 | 
118 | binarystart = 51 , 52 (`34`)
119 | binaryforward = 0-3
120 | binaryback = 4-7
121 | binaryleft = 8-11
122 | binaryright = 12-15
123 | binarystop = 17
124 | binaryled = 18 - ?
125 | binaryvoice = 22 - ?
126 | binaryendsequence = 52
127 | ```
128 | 


--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | 
  4 | <head>
  5 |   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  6 |   <title>Cyber Robot Chrome controller</title>
  7 |   <script type="text/javascript">
  8 |     var gattServer = null;
  9 | 
 10 |     var oldLog = console.log;
 11 |     console.log = function (message) {
 12 |       logText(message);
 13 |       oldLog.apply(console, arguments);
 14 |     };
 15 | 
 16 |     window.addEventListener('error', function (error) {
 17 |       console.error(error);
 18 |       error.preventDefault();
 19 |     });
 20 |     window.addEventListener("keydown", function (event) {
 21 |       if (event.defaultPrevented) {
 22 |         return;
 23 |       }
 24 | 
 25 |       if (document.getElementById('message').value) {
 26 |         return;
 27 |       }
 28 | 
 29 |       switch (event.key) {
 30 |         case 'F1':
 31 |           sendToRobot('781');
 32 |           break;
 33 |         case 'F2':
 34 |           sendToRobot('782');
 35 |           break;
 36 |         case 'F3':
 37 |           sendToRobot('783');
 38 |           break;
 39 |         case 'F4':
 40 |           sendToRobot('784');
 41 |           break;
 42 |         case 'ArrowDown':
 43 |           sendToRobot('12D1S-1');
 44 |           break;
 45 |         case "ArrowUp":
 46 |           sendToRobot('12D0S-1');
 47 |           break;
 48 |         case 'ArrowLeft':
 49 |           sendToRobot('12D2S-1');
 50 |           break;
 51 |         case 'ArrowRight':
 52 |           sendToRobot('12D3S-1');
 53 |           break;
 54 |         case 'Spacebar':
 55 |         case ' ':
 56 |           sendToRobot('12DE');
 57 |           break;
 58 |         case 'Enter':
 59 |           sendToRobot('99SP');
 60 |           break;
 61 |         case '1':
 62 |           sendToRobot('561E');
 63 |           break;
 64 |         case '2':
 65 |           sendToRobot('562E');
 66 |           break;
 67 |         case '3':
 68 |           sendToRobot('563E');
 69 |           break;
 70 |         case '4':
 71 |           sendToRobot('564E');
 72 |           break;
 73 |         case '5':
 74 |           sendToRobot('565E');
 75 |           break;
 76 |         case '6':
 77 |           sendToRobot('566E');
 78 |           break;
 79 |         case '7':
 80 |           sendToRobot('567E');
 81 |           break;
 82 |         case '8':
 83 |           sendToRobot('568E');
 84 |           break;
 85 |         case '9':
 86 |           sendToRobot('569E');
 87 |           break;
 88 |         case '0':
 89 |           sendToRobot('5610E');
 90 |         default:
 91 |           return;
 92 |       }
 93 | 
 94 |       event.preventDefault();
 95 |     }, true);
 96 | 
 97 |     function sendToRobot(message) {
 98 |       let encoder = new TextEncoder('utf-8'); 
 99 |       let serviceUuid = '0000fff3-0000-1000-8000-00805f9b34fb';
100 |       let characteristicUuid = '0000fff5-0000-1000-8000-00805f9b34fb';
101 |       let notificationUuid = '0000fff4-0000-1000-8000-00805f9b34fb';
102 | 
103 |       if (gattServer === null) {
104 |         gattServer = 'loading';
105 |         navigator.bluetooth.requestDevice({
106 |           optionalServices: [serviceUuid],
107 |           acceptAllDevices: true 
108 |         })
109 |           .then(device => device.gatt.connect())
110 |           .then(server => {
111 |             gattServer = server;
112 |             return server;
113 |           })
114 |           .then(server => server.getPrimaryService(serviceUuid))
115 |           .then(service => service.getCharacteristic(notificationUuid))
116 |           .then(characteristic => characteristic.startNotifications()
117 |             .then(_ => characteristic.addEventListener('characteristicvaluechanged', handleNotifications)))          
118 |           .catch(e => {
119 |             console.error(e);
120 |             gattServer = null;
121 |           });
122 |       }
123 | 
124 |       if (gattServer == 'loading') {
125 |         setTimeout(() => sendToRobot(message), 100);
126 |         return;
127 |       }
128 | 
129 |       gattServer.getPrimaryService(serviceUuid)
130 |         .then(service => service.getCharacteristic(characteristicUuid))
131 |         .then(characteristic => {
132 |           var binaryCommand = encoder.encode(message);
133 |           return characteristic.writeValue(binaryCommand);
134 |         })
135 |         .then(_ => {
136 |           console.log(`'${message}' sent.`);
137 |         })
138 |         .catch(e => console.error(e));
139 |     }
140 | 
141 |     function onButtonClick() {
142 |       var message = document.getElementById('message').value;
143 |       sendToRobot(message);
144 |     }
145 | 
146 |     function logText(text) {
147 |       document.getElementById('log').value += `${text}\n`;
148 |     }
149 | 
150 |     function handleNotifications(event) {
151 |         let value = event.target.value;
152 |         let a = [];
153 |         for (let i = 0; i < value.byteLength; i++) {
154 |           a.push('0x' + ('00' + value.getUint8(i).toString(16)).slice(-2));
155 |         }
156 |         console.log('> ' + a.join(' '));
157 |       }
158 |   </script>
159 | 
160 |   <style>
161 |     * {
162 |       font-size: 20px;
163 |       font-family: Tahoma, sans-serif;
164 |     }
165 | 
166 |     *:focus {
167 |       outline: none;
168 |     }
169 | 
170 |     html,
171 |     body {
172 |       width: 100%;
173 |       height: 100%;
174 |     }
175 | 
176 |     body {
177 |       background: radial-gradient(circle at 30%, #eee, #fff 30%, #ccc 75%, #fff 75%);
178 |       overflow: hidden;
179 |     }
180 | 
181 |     div#container {
182 |       margin-left: -300px;
183 |       margin-top: -250px;
184 |       position: absolute;
185 |       left: 50%;
186 |       top: 50%;
187 |       position: absolute;
188 |       width: 600px;
189 |       height: 400px;
190 |     }
191 | 
192 |     input {
193 |       color: white;
194 |       border-radius: 8px;
195 |       text-shadow: 0 1px 1px rgba(0, 0, 0, 0.2);
196 |       background: rgb(66, 184, 221);
197 |       padding: 10px 20px;
198 |     }
199 | 
200 |     textarea#log {
201 |       display: block; 
202 |       font: 10px monospace;
203 |       width: 100%;
204 |       height : 250px;
205 |       margin: 10px;
206 |     }
207 |   </style>
208 | </head>
209 | 
210 | <body>
211 |   <div id="container">
212 |     <ul>
213 |       <li>Use keyboard arrow keys to move, space to stop</li>
214 |       <li>Use F1-F4 to control lights</li>
215 |       <li>Use 0-9 to control sounds</li>
216 |       <li>Use Enter for `99SP`</li>
217 |     </ul>
218 | 
219 |     <input type="text" id="message" style="text-transform: uppercase;" />
220 |     <input type="button" onclick="javascript:onButtonClick()" value="Send to robot" />
221 | 
222 |     <textarea id="log" readonly></textarea>
223 |   </div>
224 | </body>
225 | 
226 | </html>
227 | 


--------------------------------------------------------------------------------