Skip to content

Commit b8c97af

Browse files
committed
docs update
1 parent 9cfbdf2 commit b8c97af

File tree

6 files changed

+39
-29
lines changed

6 files changed

+39
-29
lines changed

docs.ts

+1
Original file line numberDiff line numberDiff line change
@@ -266,6 +266,7 @@ namespace docs {
266266
microcode.TID_MODIFIER_RGB_LED_COLOR_SPARKLE,
267267
microcode.TID_ACTUATOR_SERVO_SET_ANGLE,
268268
microcode.TID_ACTUATOR_RELAY,
269+
microcode.TID_ACTUATOR_SERVO_POWER,
269270
// editor icons
270271
"delete",
271272
"plus",

docs/images/JacdacKits.png

426 KB
Loading

docs/images/generated/icon_A23.png

342 Bytes
Loading

docs/jacdac.md

+28-3
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,32 @@ image: ./docs/images/generated/sample_railroad_crossing.png
55

66
![Smiley Button MicroCode program](./images/generated/sample_railroad_crossing.png){:class="screenshot"}
77

8-
MicroCode integrates with [Jacdac](https://aka.ms.jacdac) in several ways
8+
MicroCode will detect [Jacdac](https://aka.ms/jacdac) modules and automatically display tiles for some of them. Tiles are available for all modules in [Kittenbot Jacdac Kit A](https://microsoft.github.io/jacdac-docs/devices/kittenbot/jacdacstarterkitawithjacdaptorformicrobitv2v10/),
9+
as as well as the [Forward Education Climate Kit](https://microsoft.github.io/jacdac-docs/devices/forward-education/climateactionkitv10/). Many of the modules in [Kittenbot Jacdac Kit B](https://microsoft.github.io/jacdac-docs/devices/kittenbot/jacdacdeveloperstoolelectronicmodulekitbv10/) also are supported.
910

10-
- the MicroCode program is compiled to the bytecode of the Jacdac virtual machine (JDVM), which can be run on the same micro:bit or exported to other micro:bits
11-
- the MicroCode editor recognizes a small set of Jacdac modules, when connected, providing programming tiles for those modules
11+
Programming tiles for Jacdac modules appear in the user interface when the modules are connected to the shield. The Jacdac tiles have a small yellow square in the lower-right corner.
12+
13+
### WHEN modules
14+
15+
#### Sensors
16+
17+
- ![magnet sensor](./images/generated/icon_S10.png){:class="icon"} `magnet sensor` detects the presence of a magnet (levels 1 - 5, where 1 means no magnet present and 5 means strong presence of magnetic field)
18+
- ![light sensor](./images/generated/icon_S5.png){:class="icon"} `light sensor` measures the amount of light (levels 1 - 5, where 1 means little light present and 5 means a lot of light present)
19+
- ![moisture sensor](./images/generated/icon_S16.png){:class="icon"}
20+
measures the amount of moisture (levels 1 - 5, where 1 means very dry and 5 means very wet)
21+
- ![distance sensor](./images/generated/icon_S17.png){:class="icon"} `distance sensor` measures the distance to an object (levels 1 - 5, where 1 means very close and 5 means far away)
22+
- ![line sensor](./images/generated/icon_S18.png){:class="icon"} `line sensor` detects
23+
whether the surface under the sensor is dark or light
24+
25+
#### User inputs
26+
27+
- ![slider](./images/generated/icon_S11.png){:class="icon"} `slider` measures the position of a physical slider (1-5, where 1 is minimum position and 5 is maximum position)
28+
- ![dial](./images/generated/icon_S12.png){:class="icon"} `dial` has two associated events: turn left ![turn left](./images/generated/icon_F21L.png){:class="icon"} and turn right ![turn right](./images/generated/icon_F21R.png){:class="icon"}
29+
- ![key](./images/generated/icon_F5.png){:class="icon"} `key` is available in the press/release event.
30+
31+
### DO modules
32+
33+
- ![LED](./images/generated/icon_A8.png){:class="icon"} `LED` set a color animation on a programmable LED strip
34+
- ![relay tile](./images/generated/icon_A22.png){:class="icon"} `relay` controls a relay switch (turning it on or off)
35+
- ![servo power tile](./images/generated/icon_A23.png){:class="icon"} `servo power` controls the power to a servo motor (turning it on or off)
36+
- ![servo set angle tile](./images/generated/icon_A21_.png){:class="icon"} `set servo angle` controls the orientation of a servo motor arm. The ![servo set angle tile](./images/generated/icon_A21_.png){:class="icon"} `servo` arm orientation is mapped to the wall clock hours: `0` (or `12`) is on rotated 90 degree from the resting position to the left, `6` is rotated 90 degree right from the rest position. This operation depends on the servo being powered on.

docs/language.md

+4-23
Original file line numberDiff line numberDiff line change
@@ -184,33 +184,14 @@ after `repeat` determine the number of iterations. If no value is given, it repe
184184

185185
- **when** ![press](./images/generated/icon_S2.png){:class="icon"} press ![logo](./images/generated/icon_F7.png){:class="icon"} micro:bit logo, **do** ![screen](./images/generated/icon_A5.png){:class="icon"} show image happy animation and ![repeat](./images/generated/icon_M23.png){:class="icon"} repeat ![value 3](./images/generated/icon_M8.png){:class="icon"} 3 times.
186186

187-
## Jacdac Modules {#jacdac}
187+
## Jacdac {#jacdac}
188188

189-
MicroCode will detect [Jacdac](https://aka.ms/jacdac) modules and automatically display tiles for some of them. Tiles are available for all modules in [Kittenbot Jacdac Kit A](https://microsoft.github.io/jacdac-docs/devices/kittenbot/jacdacstarterkitawithjacdaptorformicrobitv2v10/). Tiles appear when the modules are connected.
190-
191-
### WHEN modules
192-
193-
#### Sensors
194-
195-
- ![magnet sensor](./images/generated/icon_S10.png){:class="icon"} `magnet sensor` detects the presence of a magnet (levels 1 - 5, where 1 means no magnet present and 5 means strong presence of magnetic field)
196-
- ![light sensor](./images/generated/icon_S5.png){:class="icon"} `light sensor` measures the amount of light (levels 1 - 5, where 1 means little light present and 5 means a lot of light present)
197-
198-
#### User inputs
199-
200-
- ![slider](./images/generated/icon_S11.png){:class="icon"} `slider` measures the position of a physical slider (1-5, where 1 is minimum position and 5 is maximum position)
201-
- ![dial](./images/generated/icon_S12.png){:class="icon"} `dial` has two associated events: turn left ![turn left](./images/generated/icon_F21L.png){:class="icon"} and turn right ![turn right](./images/generated/icon_F21R.png){:class="icon"}
202-
- ![key](./images/generated/icon_F5.png){:class="icon"} `key` is available in the press/release event.
203-
204-
### DO modules
205-
206-
- ![LED](./images/generated/icon_A8.png){:class="icon"} `LED` set a color animation on a programmable LED strip
207-
- ![servo set angle tile](./images/generated/icon_A21_.png){:class="icon"} `servo` controls the orientation of a servo motor arm. The ![servo set angle tile](./images/generated/icon_A21_.png){:class="icon"} `servo` arm orientation is mapped to the wall clock hours: `0` (or `12`) is on rotated 90 degree from the resting position to the left, `6` is rotated 90 degree right from the rest position.
189+
MicroCode will detect connected [Jacdac](./jacdac) modules and automatically display programming tiles for them. Tiles are available for all modules in [Kittenbot Jacdac Kit A](https://microsoft.github.io/jacdac-docs/devices/kittenbot/jacdacstarterkitawithjacdaptorformicrobitv2v10/),
190+
as as well as the [Forward Education Climate Kit](https://microsoft.github.io/jacdac-docs/devices/forward-education/climateactionkitv10/). Many of the modules in [Kittenbot Jacdac Kit B](https://microsoft.github.io/jacdac-docs/devices/kittenbot/jacdacdeveloperstoolelectronicmodulekitbv10/) also are supported.
208191

209192
## Robot {#robot}
210193

211-
MicroCode can be used to control a micro:bit robot ([read more](./robot)).
212-
213-
Make to start your program by setting the same radio group as the robot.
194+
MicroCode can be used to control a micro:bit robot ([read more](./robot)). Make sure to start your program by setting the same radio group as the robot.
214195

215196
![setting radio group 3 on page start](./images/generated/sample_robot_shake_page_1_rule_1.png){:class="rule"}
216197

docs/manual.md

+6-3
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: User guide for the MicroCode editor
88

99
MicroCode makes it possible to program the [micro:bit V2](https://microbit.org)
1010
**without the need for an extra computer or Internet connection**.
11-
As shown above, the micro:bit slots into a (commercially available) shield that provides a color display and extra inputs.
11+
As shown above, the micro:bit slots into a (commercially available) shield that provides a color display and extra inputs.
1212
The MicroCode visual programming model is based on Kodu and targets children age 6-9, younger than the traditional audience for the micro:bit. MicroCode features:
1313

1414
- [arcade shields](#arcade-shields) for the micro:bit V2 enable "on the go" programming with familiar game console controls
@@ -90,8 +90,11 @@ to follow lines, avoid obstacles and more.
9090

9191
## Accessories {#jacdac}
9292

93-
MicroCode supports accessories to extend the micro:bit device with LEDs, servos, motors, ...
94-
In this video, we launch an LED animation when a clap is detected. The accessories are powered by [Jacdac](https://microsoft.github.io/jacdac-docs).
93+
[![Photograph of Jacdac kits](./images/JacdacKits.png){:class="photo"}](./jacdac)
94+
95+
MicroCode recognizes many commercially-available
96+
[Jacdac modules](https://aka.ms/jacdac) that allow you to extend the micro:bit device with LEDs, servos, and much more.
97+
In this video, we launch an LED animation when a clap is detected.
9598

9699
<video class="sample" poster="./videos/jacdac-led.png" src="./videos/jacdac-led.mp4" controls="true"></video>
97100

0 commit comments

Comments
 (0)