Skip to content

micro:bit programming environment (based on MIT Scratch)

License

Notifications You must be signed in to change notification settings

EiichiroIto/microwitch

Repository files navigation

micro:witch

micro:witch is a block-style programming environment for micro:bit based on MIT Scratch.

(BBC micro:bit v2 is supported now and some functions are available)

日本語

for Raspberry pi

You can try micro:witch v2 if you like.

micro:witch v2

screenshot1

Download and Install

  1. Open Releases page and select newest release.
  2. Download the release file from Assets. (ex. microwitch-v1.3.3-win.zip)
  3. Unzip the downloaded file to an appropriate folder.

Run

  1. Start microwitch.exe.

Upload firmware

To use the micro:witch, you need to upload the firmware to the micro:bit by following the steps below.

  1. Connect a micro:bit to your PC.
  2. Wait until the computer recognizes the micro:bit as storage device.
  3. Select "initialize micro:bit" from Device menu.
  4. Click Yes on "initialize micro:bit?" dialog.
  5. When the firmware has been transferred and the micro:bit is recognized again, you are done.

If the file selection dialog is displayed in the third step, micro:bit may not be recognized properly. Please check the connection.

Usage

  1. Connect a micro:bit to your PC.
  2. Select "Connect to micro:bit" from Device menu.
  3. It will automatically connect to the micro:bit and the status display will change to "Ready".
  4. When you click on the script you have created, it will be transferred to the micro:bit and executed.

Transferring a script

Just clicking on the script you have created will not save the script in the micro:bit, so the script in the micro:bit will be lost when you power off or reboot.

To save the script and have it run automatically when power is turned on, follow the steps below.

  1. Put up a block for "When the green flag is clicked".
  2. Create the scripts you need.
  3. After connecting micro:bit to the computer, select "Send to micro:bit".
  4. Once the script has been transferred, the micro:bit will automatically reset and the script will start running.

To stop the running script, press the red button in the upper right corner of the screen.

Trouble shooting

Cannot transfer firmware properly.

Unplug the micro:bit from the computer, wait a moment, stick it back in, and try again.

Make sure that the cable connecting the micro:bit to the PC is for data transfer.

The DAPLink firmware version may be out of date. Please search for "microbit firmware DAPLink update" and update the DAPLink firmware.

"Traceback ... and other messages are displayed. Or, the script cannot be executed.

The firmware version may be old. Please transfer the firmware to the micro:bit again.

You may be using commands (such as sound events) added in micro:bit v2 on an older micro:bit.

The script cannot be executed on micro:bit.

In the device menu, select "Connect to micro:bit" and choose a port.

Press the Stop button to confirm the "satus: ready" message is displayed.

Ultrasonic sensor or expansion boards cannot be used , or they do not respond

Create a script that uses the ultrasonic sensor or expansion board, and then do "Send to micro:bit" afterwards.

The program required for the operation will be transferred automatically. (It may take some time.)

Official Logo

micro:witch official logo created by Karin sama.

logo

License

MIT License