add option to turn off hud

Author: pelikhan

.gitignore

@@ -15,3 +15,4 @@ codal-jacdac
 *.Identifier
 Gemfile.lock
 .jekyll-metadata
+.DS_Store

robot/README.md

@@ -12,17 +12,24 @@ and controlled by a MicroCode program running on the arcade shield.
 microcode.elecfreaksCuteBot.start()
 ```
 
+-   Use the blocks to control the robot.
+
+```blocks
+input.onButtonPressed(Button.A, () => {
+    microcode.motorRun(50, 50)
+})
+input.onButtonPressed(Button.B, () => {
+    microcode.motorStop()
+})
+```
+
 ## Usage with MicroCode
 
 Download this firmware onto the micro:bit that stays on the robot. Then use MicroCode to send commands
 to the robot.
 
 -   [Documentation](https://microsoft.github.io/microcode/docs/robot)
 
-You can also use blocks to configure the radio group and motor drift.
+```
 
-```blocks
-microcode.elecfreaksCuteBot.start()
-microcode.setRadioGroup(3)
-microcode.setMotorDrift(2)
 ```

robot/blocks.ts

@@ -7,7 +7,7 @@ namespace microcode {
     export let robot: RobotDriver
 
     function checkRobotDriver() {
-        if (!robot) throw "Add 'robot start' block in the 'on start' block"
+        if (!robot) throw "Add 'robot start ...' block in the 'on start' block"
     }
 
     /**
@@ -41,6 +41,31 @@ namespace microcode {
         robot.motorRun(0, 0)
     }
 
+    /**
+     * Sets the LED color
+     */
+    //% blockId="microcoderobotsetcolor" block="robot set color $rgb"
+    //% group="Motors"
+    //% weight=10
+    //% rgb.shadow=colorNumberPicker
+    export function setColor(rgb: number) {
+        checkRobotDriver()
+        robot.setColor(rgb)
+    }
+
+    /**
+     * Play a tone through the robot speaker
+     */
+    //% blockId="microcoderobotplaytone" block="robot play tone $frequency for $duration"
+    //% group="Motors"
+    //% weight=10
+    //% frequency.shadow=device_note
+    //% duration.shadow=device_beat
+    export function playTone(frequency: number, duration: number) {
+        checkRobotDriver()
+        robot.playTone(frequency, duration)
+    }
+
     /**
      * Gets the distance reported by the distance sensor
      */
@@ -115,14 +140,15 @@ namespace microcode {
     }
 
     /**
-     * Sets the LED color
+     * Enables or disables the display of the robot state on the LED matrix.
+     * @param enabled
      */
-    //% blockId="microcoderobotsetcolor" block="robot set color $rgb"
-    //% group="Motors"
-    //% weight=10
-    //% rgb.shadow=colorNumberPicker
-    export function setColor(rgb: number) {
+    //% block="robot set display to $enabled"
+    //% blockId="microcoderobotsetdisplay"
+    //% group="Configuration"
+    //% enabled.shadow=toggleOnOff
+    export function setDisplay(enabled: boolean) {
         checkRobotDriver()
-        robot.setColor(rgb)
+        robot.hud = !!enabled
     }
 }

robot/robotdriver.ts

@@ -34,6 +34,7 @@ namespace microcode {
         private readonly sonarDistanceFilter = new KalmanFilter1D()
         private lastSonarValue = 0
 
+        hud = true
         private showConfiguration: number = 0
         private configDrift: boolean = undefined
         private targetColor = 0
@@ -291,14 +292,12 @@ namespace microcode {
 
         private setMotorState(left: number, right: number) {
             this.robot.motorRun(left, right)
-            if (this.showConfiguration) return
+            if (this.showConfiguration || !this.hud) return
             this.showSingleMotorState(3, left)
             this.showSingleMotorState(1, right)
         }
 
         private showSingleMotorState(x: number, speed: number) {
-            if (this.showConfiguration) return
-
             if (Math.abs(speed) < 30) led.unplot(x, 2)
             else led.plot(x, 2)
             if (speed >= 30) led.plot(x, 1)
@@ -313,7 +312,7 @@ namespace microcode {
 
         private updateLineState() {
             const lineState = this.lineState()
-            if (this.showConfiguration) return
+            if (this.showConfiguration || !this.hud) return
 
             // render left/right lines
             const left =
@@ -350,7 +349,11 @@ namespace microcode {
                 )
             }
 
-            if (!this.showConfiguration && this.lastSonarValue !== undefined) {
+            if (
+                !this.showConfiguration &&
+                this.hud &&
+                this.lastSonarValue !== undefined
+            ) {
                 const d = this.lastSonarValue
                 for (let y = 0; y < 5; y++)
                     if (5 - y <= d) led.plot(2, y)