pxt-ev3/docs/about.md

47 lines
1.8 KiB
Markdown
Raw Normal View History

2017-06-29 16:47:26 +02:00
# About
Welcome to the **Microsoft MakeCode** editor for the **@boardname@**!
## Programming: [Blocks](/blocks) or [JavaScript](/javascript)
You can program the @boardname@ using [Blocks](/blocks) or [JavaScript](/javascript) in your web browser:
2018-01-19 01:43:16 +01:00
```blocks
brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
2018-02-19 16:35:08 +01:00
motors.largeA.run(50)
2017-06-29 16:47:26 +02:00
})
```
```typescript
brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
2018-02-19 16:35:08 +01:00
motors.largeA.run(50)
2017-06-29 16:47:26 +02:00
})
```
The editor works in [most modern browsers](/browsers). It works [offline](/offline) once loaded and doesn't require any installation. Take a look at some of the [features](/about/editor-features) of the editor.
2017-06-29 16:47:26 +02:00
2018-02-03 18:09:10 +01:00
## Compile and Flash: Your Program!
2017-06-29 16:47:26 +02:00
When you have your code ready, you connect your EV3 Brick to a computer with a USB cable so it appears as an attached drive (named **@drivename@**).
2017-06-29 16:47:26 +02:00
Compilation to machine code from [Blocks](/blocks) or [JavaScript](/javascript) happens in the browser. You save the binary
program to a **.uf2** file, which you then copy to the **@drivename@** drive. The process of copying will flash the device with the new program.
2017-06-29 16:47:26 +02:00
### ~ hint
Not seeing the **@drivename@** drive? Make sure to upgrade your firmware at https://ev3manager.education.lego.com/. Try these [troubleshooting](/troubleshoot) tips if you still have trouble getting the drive to appear.
### ~
2017-06-29 16:47:26 +02:00
## Simulator: Test Your Code
You can run your code using the @boardname@ simulator, all inside the same browser window.
The simulator has support for the EV3 Brick screen, buttons, sensors, and motors.
2017-06-29 16:47:26 +02:00
```sim
brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => {
2018-02-19 16:35:08 +01:00
motors.largeA.run(50)
motors.mediumD.run(50)
sensors.touch1.pauseUntil(ButtonEvent.Pressed)
sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected)
2017-06-29 16:47:26 +02:00
})
```