renaming brick.setLight to brick.setStatusLight (#307)

* renaming brick.setLight to brick.setStatusLight

* updated docs

docs/SUMMARY.md

@@ -52,7 +52,7 @@
         * [is pressed](/reference/brick/button/is-pressed)
         * [was pressed](/reference/brick/button/was-pressed)
         * [pause until](/reference/brick/button/pause-until)
-        * [set light](/reference/brick/set-light)
+        * [set light](/reference/brick/set-status-light)
         * [battery level](/reference/brick/battery-level)
     * [Motors](/reference/motors)
         * [set speed](/reference/motors/motor/set-speed)

docs/coding/reversing-the-robot-1.md

@@ -6,7 +6,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
     sensors.touch1.pauseUntil(ButtonEvent.Pressed)
     motors.largeBC.setSpeed(0)
     loops.pause(1000)
-    brick.setLight(BrickLight.OrangeFlash)
+    brick.setStatusLight(StatusLight.OrangeFlash)
     motors.largeBC.setSpeed(-50)
     loops.pause(2000)
     motors.largeBC.setSpeed(0)

docs/coding/reversing-the-robot-2.md

@@ -7,7 +7,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
     sensors.touch2.pauseUntil(ButtonEvent.Pressed)
     motors.largeBC.setSpeed(0)
     loops.pause(1000)
-    brick.setLight(BrickLight.OrangeFlash)
+    brick.setStatusLight(StatusLight.OrangeFlash)
     motors.largeBC.setSpeed(-50)
     loops.pause(2000)
     motors.largeBC.setSpeed(0)

docs/coding/reversing-the-robot-3.md

@@ -10,7 +10,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
     brick.showImage(images.eyesTiredMiddle)
     motors.largeBC.setSpeed(0)
     loops.pause(1000)
-    brick.setLight(BrickLight.OrangeFlash)
+    brick.setStatusLight(StatusLight.OrangeFlash)
     brick.showImage(images.eyesDizzy)
     motors.largeBC.setSpeed(-50)
     loops.pause(2000)

docs/examples/core-set/gyroboy-labview.md

@@ -146,11 +146,11 @@ loops.forever(function () {
     }
     motors.stopAllMotors()
     st = 0;
-    brick.setLight(BrickLight.RedPulse);
+    brick.setStatusLight(StatusLight.RedPulse);
     brick.showImage(images.eyesKnockedOut)
     music.playSoundEffect(sounds.movementsSpeedDown)
     sensors.touch3.pauseUntil(ButtonEvent.Pressed)
-    brick.setLight(BrickLight.Off);
+    brick.setStatusLight(StatusLight.Off);
 })
 
 // BHV

docs/examples/core-set/puppy-labview.md

@@ -29,7 +29,7 @@ function DN() {
 function MNRH() {
     motors.mediumC.setBrake(true)
     brick.showImage(images.legoEv3icon)
-    brick.setLight(BrickLight.OrangePulse)
+    brick.setStatusLight(StatusLight.OrangePulse)
     while (!brick.buttonEnter.wasPressed()) {
         if (brick.buttonUp.wasPressed()) {
             motors.mediumC.setSpeed(-100);
@@ -41,7 +41,7 @@ function MNRH() {
     }
     motors.mediumC.stop();
     motors.mediumC.clearCounts();
-    brick.setLight(BrickLight.Green);
+    brick.setStatusLight(StatusLight.Green);
 }
 
 function IS(t: number) {

docs/examples/core-set/robotarm-labview.md

@@ -20,9 +20,9 @@ INI()
 let down = false;
 loops.forever(function () {
     brick.showImage(images.informationQuestionMark)
-    brick.setLight(BrickLight.OrangePulse);
+    brick.setStatusLight(StatusLight.OrangePulse);
     pauseUntil(() => (down = brick.buttonDown.wasPressed()) || brick.buttonUp.wasPressed())
-    brick.setLight(BrickLight.Off)
+    brick.setStatusLight(StatusLight.Off)
     music.playSoundEffect(sounds.mechanicalAirRelease)
     brick.showImage(images.informationAccept)
     if (down) {

docs/examples/crane-labview.md

@@ -20,9 +20,9 @@ INI()
 let down = false;
 loops.forever(function () {
     brick.showImage(images.informationQuestionMark)
-    brick.setLight(BrickLight.OrangePulse);
+    brick.setStatusLight(StatusLight.OrangePulse);
     pauseUntil(() => (down = brick.buttonDown.wasPressed()) || brick.buttonUp.wasPressed())
-    brick.setLight(BrickLight.Off)
+    brick.setStatusLight(StatusLight.Off)
     music.playSoundEffect(sounds.mechanicalAirRelease)
     brick.showImage(images.informationAccept)
     if (down) {

docs/examples/gyro-boy-labview.md

@@ -146,11 +146,11 @@ loops.forever(function () {
     }
     motors.stopAllMotors()
     st = 0;
-    brick.setLight(BrickLight.RedPulse);
+    brick.setStatusLight(StatusLight.RedPulse);
     brick.showImage(images.eyesKnockedOut)
     music.playSoundEffect(sounds.movementsSpeedDown)
     sensors.touch3.pauseUntil(ButtonEvent.Pressed)
-    brick.setLight(BrickLight.Off);
+    brick.setStatusLight(StatusLight.Off);
 })
 
 // BHV

docs/reference/brick.md

@@ -20,7 +20,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, function () {
 brick.buttonEnter.pauseUntil(ButtonEvent.Bumped);
 brick.buttonEnter.isPressed()
 brick.buttonEnter.wasPressed()
-brick.setLight(BrickLight.Red);
+brick.setStatusLight(StatusLight.Red);
 ```
 
 ## Other

docs/reference/brick/battery-level.md

@@ -22,11 +22,11 @@ loops.forever(function() {
     battery = brick.batteryLevel();
     if (battery > 15)
     {
-        brick.setLight(BrickLight.Green);
+        brick.setStatusLight(StatusLight.Green);
     } else if (battery > 5) {
-        brick.setLight(BrickLight.Orange);
+        brick.setStatusLight(StatusLight.Orange);
     } else {
-        brick.setLight(BrickLight.RedPulse)
+        brick.setStatusLight(StatusLight.RedPulse)
     }
     loops.pause(30000)
 })

docs/reference/brick/button/is-pressed.md

@@ -34,11 +34,11 @@ Set the brick light to green when the `down` is pressed. When the button is not
 let isRed = false;
 loops.forever(function() {
     if (brick.buttonLeft.isPressed()) {
-        brick.setLight(BrickLight.Green);
+        brick.setStatusLight(StatusLight.Green);
         isRed = false;
     } else {
         if (!isRed) {
-            brick.setLight(BrickLight.Red);
+            brick.setStatusLight(StatusLight.Red);
             isRed = true;
         }
     }

docs/reference/brick/button/on-event.md

@@ -16,7 +16,7 @@ Your @boardname@ has touch sensors that work like buttons. Instead of saying `en
 
 ```block
 sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
-    brick.setLight(BrickLight.Orange);
+    brick.setStatusLight(StatusLight.Orange);
 });
 ```
 

docs/reference/brick/button/was-pressed.md

@@ -35,9 +35,9 @@ Set the brick light to green if the `right` button was pressed before the `left`
 ```blocks
 brick.buttonLeft.onEvent(ButtonEvent.Bumped, function() {
     if (brick.buttonRight.wasPressed()) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Off)
+        brick.setStatusLight(StatusLight.Off)
     }
 })
 ```

docs/reference/brick/set-status-light.md

@@ -3,7 +3,7 @@
 Set the light on the brick to a solid or flashing color.
 
 ```sig
-brick.setLight(BrickLight.Red);
+brick.setStatusLight(StatusLight.Red);
 ```
 ## Parameters
 
@@ -25,13 +25,13 @@ Repeatedly show a different color pattern for the brick light.
 
 ```blocks
 loops.forever(function () {
-    brick.setLight(BrickLight.Orange)
+    brick.setStatusLight(StatusLight.Orange)
     loops.pause(1000)
-    brick.setLight(BrickLight.GreenFlash)
+    brick.setStatusLight(StatusLight.GreenFlash)
     loops.pause(2000)
-    brick.setLight(BrickLight.RedPulse)
+    brick.setStatusLight(StatusLight.RedPulse)
     loops.pause(2000)
-    brick.setLight(BrickLight.Off)
+    brick.setStatusLight(StatusLight.Off)
     loops.pause(500)
 })
 ```

libs/color-sensor/docs/reference/sensors/color-sensor/ambient-light.md

@@ -3,9 +3,9 @@
 ```blocks
 loops.forever(function () {
     if (sensors.color1.ambientLight() > 20) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Orange)
+        brick.setStatusLight(StatusLight.Orange)
     }
 })
 ```

libs/color-sensor/docs/reference/sensors/color-sensor/color.md

@@ -3,9 +3,9 @@
 ```blocks
 loops.forever(function () {
     if (sensors.color1.color() == ColorSensorColor.Green) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Orange)
+        brick.setStatusLight(StatusLight.Orange)
     }
 })
 ```

libs/color-sensor/docs/reference/sensors/color-sensor/reflected-light.md

@@ -3,9 +3,9 @@
 ```blocks
 loops.forever(function () {
     if (sensors.color1.reflectedLight() > 20) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Orange)
+        brick.setStatusLight(StatusLight.Orange)
     }
 })
 ```

libs/core/buttons.ts

@@ -2,7 +2,7 @@
 /**
  * Patterns for lights under the buttons.
  */
-const enum BrickLight {
+const enum StatusLight {
     //% block=off enumval=0
     Off = 0,
     //% block=green enumval=1
@@ -244,16 +244,16 @@ namespace control {
 
 namespace brick {
     // the brick starts with the red color
-    let currPattern: BrickLight = BrickLight.Red;
+    let currPattern: StatusLight = StatusLight.Red;
 
     /**
      * Set lights.
      * @param pattern the lights pattern to use. eg: BrickLight.Orange
      */
-    //% blockId=setLights block="set light to %pattern"
+    //% blockId=setLights block="set status light to %pattern"
     //% weight=100 group="Buttons"
-    //% help=brick/set-light
+    //% help=brick/set-status-light
-    export function setLight(pattern: BrickLight): void {
+    export function setStatusLight(pattern: StatusLight): void {
         if (currPattern === pattern)
             return
         currPattern = pattern;

libs/core/test.ts

@@ -2,7 +2,7 @@ screen.clear()
 brick.print("PXT!", 10, 30, Draw.Quad)
 
 brick.drawRect(40, 40, 20, 10, Draw.Fill)
-brick.setLight(BrickLight.Orange)
+brick.setStatusLight(StatusLight.Orange)
 
 brick.heart.doubled().draw(100, 50, Draw.Double | Draw.Transparent)
 
@@ -12,7 +12,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
 
 brick.buttonLeft.onEvent(ButtonEvent.Bumped, () => {
     brick.drawRect(10, 70, 20, 10, Draw.Fill)
-    brick.setLight(BrickLight.Red)
+    brick.setStatusLight(StatusLight.Red)
     brick.setFont(brick.microbitFont())
 })
 

libs/mood/mood.ts

@@ -18,9 +18,9 @@ namespace brick {
     export class Mood {
         private image: Image;
         private sound: Sound;
-        private light: BrickLight;
+        private light: StatusLight;
 
-        constructor(image: Image, sound: Sound, light: BrickLight) {
+        constructor(image: Image, sound: Sound, light: StatusLight) {
             this.image = image;
             this.sound = sound;
             this.light = light;
@@ -30,7 +30,7 @@ namespace brick {
          * Shows the mood on the EV3
          */
         show() {
-            brick.setLight(this.light);
+            brick.setStatusLight(this.light);
             brick.showImage(this.image);
             music.playSoundEffectUntilDone(this.sound);
             loops.pause(20);
@@ -56,71 +56,71 @@ namespace moods {
      * A sleeping mood
      */
     //% fixedInstance jres=images.eyesSleeping
-    export const sleeping = new brick.Mood(images.eyesSleeping, sounds.expressionsSnoring, BrickLight.OrangePulse);
+    export const sleeping = new brick.Mood(images.eyesSleeping, sounds.expressionsSnoring, StatusLight.OrangePulse);
 
     /**
      * A awake mood
      */
     //% fixedInstance jres=images.eyesAwake
-    export const awake = new brick.Mood(images.eyesAwake, sounds.informationActivate, BrickLight.Orange);
+    export const awake = new brick.Mood(images.eyesAwake, sounds.informationActivate, StatusLight.Orange);
 
     /**
      * A tired mood
      */
     //% fixedInstance jres=images.eyesTiredMiddle
-    export const tired = new brick.Mood(images.eyesTiredMiddle, sounds.expressionsSneezing, BrickLight.OrangeFlash);
+    export const tired = new brick.Mood(images.eyesTiredMiddle, sounds.expressionsSneezing, StatusLight.OrangeFlash);
 
     /**
      * An angry mood
      */
     //% fixedInstance jres=images.eyesAngry
-    export const angry = new brick.Mood(images.eyesAngry, sounds.animalsDogGrowl, BrickLight.RedPulse);
+    export const angry = new brick.Mood(images.eyesAngry, sounds.animalsDogGrowl, StatusLight.RedPulse);
 
     /**
      * A sad mood
      */
     //% fixedInstance jres=images.eyesTear
-    export const sad = new brick.Mood(images.eyesTear, sounds.animalsDogWhine, BrickLight.Red);
+    export const sad = new brick.Mood(images.eyesTear, sounds.animalsDogWhine, StatusLight.Red);
 
     /**
      * A dizzy mood
      */
     //% fixedInstance jres=images.eyesDizzy
-    export const dizzy = new brick.Mood(images.eyesDizzy, sounds.expressionsUhOh, BrickLight.OrangeFlash);
+    export const dizzy = new brick.Mood(images.eyesDizzy, sounds.expressionsUhOh, StatusLight.OrangeFlash);
 
     /**
      * A knocked out mood
      */
     //% fixedInstance jres=images.eyesKnockedOut
-    export const knockedOut = new brick.Mood(images.eyesKnockedOut, sounds.informationError, BrickLight.RedFlash);
+    export const knockedOut = new brick.Mood(images.eyesKnockedOut, sounds.informationError, StatusLight.RedFlash);
 
     /**
      * Looking around left
      */
     //% fixedInstance jres=images.eyesMiddleLeft
-    export const middleLeft = new brick.Mood(images.eyesMiddleLeft, sounds.informationAnalyze, BrickLight.Off);
+    export const middleLeft = new brick.Mood(images.eyesMiddleLeft, sounds.informationAnalyze, StatusLight.Off);
 
     /**
      * Looking around right
      */
     //% fixedInstance jres=images.eyesMiddleRight
-    export const middleRight = new brick.Mood(images.eyesMiddleRight, sounds.informationAnalyze, BrickLight.Off);
+    export const middleRight = new brick.Mood(images.eyesMiddleRight, sounds.informationAnalyze, StatusLight.Off);
 
     /**
      * In love mood
      */
     //% fixedInstance jres=images.eyesLove
-    export const love = new brick.Mood(images.eyesLove, sounds.expressionsMagicWand, BrickLight.GreenPulse);
+    export const love = new brick.Mood(images.eyesLove, sounds.expressionsMagicWand, StatusLight.GreenPulse);
 
     /**
      * In laughing mood
      */
     //% fixedInstance jres=images.eyesWinking
-    export const winking = new brick.Mood(images.eyesWinking, sounds.expressionsLaughing1, BrickLight.GreenFlash);
+    export const winking = new brick.Mood(images.eyesWinking, sounds.expressionsLaughing1, StatusLight.GreenFlash);
 
     /**
      * In a neutral mood
      */
     //% fixedInstance jres=images.eyesNeutral
-    export const neutral = new brick.Mood(images.eyesNeutral, undefined, BrickLight.Green);
+    export const neutral = new brick.Mood(images.eyesNeutral, undefined, StatusLight.Green);
 }

libs/touch-sensor/docs/reference/sensors/touch-sensor/is-pressed.md

@@ -3,9 +3,9 @@
 ```blocks
 loops.forever(function () {
     if (sensors.touch1.isPressed()) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Orange)
+        brick.setStatusLight(StatusLight.Orange)
     }
 })
 ```

libs/touch-sensor/docs/reference/sensors/touch-sensor/was-pressed.md

@@ -3,9 +3,9 @@
 ```blocks
 loops.forever(function () {
     if (sensors.touch1.wasPressed()) {
-        brick.setLight(BrickLight.Green)
+        brick.setStatusLight(StatusLight.Green)
     } else {
-        brick.setLight(BrickLight.Orange)
+        brick.setStatusLight(StatusLight.Orange)
     }
 })
 ```