Learn, Make and Invent
  • Educational STEM Products
  • Early Primary
    • Bee Bot
    • Ozobot
    • Matatalab Coding Set
    • Neuron coding blocks
    • Osmo ios
    • Cubetto
    • Sphero Bolt
  • Primary
    • Codey Rocky AI Robot
      • Tutorials
        • Introduction
        • Get Started
        • Upload Mode
        • Emotion Blocks
        • IoT Blocks
        • Neuron Blocks
        • IR Remote
        • Use Python
      • Examples
      • Block Reference
        • Looks
        • Lighting
        • Speaker
        • Action
        • Sensing
        • Infrared
        • Events
        • Control
        • Operators
      • Python API Reference
        • Python API for Codey
        • Python API for Rocky
        • Python API for Third-Party Libraries
        • Python API for Neuron Extension Modules
      • FAQs
    • Edison
    • mBot
      • Introduction
      • Building mBot
      • Connect mBot
      • Preset Modes
    • Microbit
    • Merge Cube
    • Bare Conductive Board
    • Tello Edu
  • Secondary
    • Microbit Grove Inventor Kit
    • mBot Ranger
    • Arduino Science Kit
    • Arduino Starter Kit
    • Arduino Grove Starter Kit
    • CoDrone
  • Senior Secondary
    • CoDrone Pro
    • Arduino CTC Go
  • Digital Tech Kits
    • Digital Tech Kit for K-2
    • Digital Tech Kit for 3-5
    • Digital Tech Kit for 6-8
    • Digital Tech Kit for 9-10
  • Makerspace
    • Otto DIY
      • User guide
      • Assembly Instructions
        • Builder Kit
        • Builder Kit +
        • Builder Kit Humanoid
        • Builder Kit E
      • OTTO enclosures 3D and laser cut files
      • Code
    • Curcuitmess
      • Circuitmess Ringo
        • Inside the Box
        • Tools Needed
        • Soldering the parts
        • Assembling the parts
        • Set up your Ringo
  • Grove Ecosystem
    • Grove System
    • Grove Modules
      • Actuators
        • Atom Node
        • Grove 2 Coil Latching Relay
        • Grove Button
        • Grove Buzzer
        • Grove Dry Reed Relay
        • Grove EL Driver
        • Grove Haptic Motor
        • Grove I2C Motor Driver V1.2
        • Grove I2C Motor Driver V1.3
        • Grove I2C Motor Driver
        • Grove LED Matrix Driver v1.0
        • Grove Mini Fan
        • Grove Mini I2C Motor Driver v1.0
        • Grove MP3 v2.0
        • Grove Recorder v3.0
        • Grove Relay
        • Grove Serial MP3 Player
        • Grove Servo
        • Grove Solid State Relay
        • Grove Speaker
        • Grove Variable Color LED
        • Grove Vibration Motor
        • Grove Water Atomization
      • Display
        • Grove 4 Digit Display
        • Grove Circular LED
        • Grove LCD RGB Backlight
        • Grove LED Bar
        • Grove LED Socket Kit
        • Grove LED String Light
        • Grove LED Strip Driver
        • Grove OLED Display 0.96inch
        • Grove OLED Display 1.12inch
        • Grove Red LED
        • I2C LCD
      • Sensors
        • Grove 3 Axis Analog Accelerometer
        • Grove 3 Axis Compass V1.0
        • Grove 3 Axis Digital Accelerometer 1.5g
        • Grove 3 Axis Digital Accelerometer 16g
        • Grove 3 Axis Digital Accelerometer 400g
        • Grove 3 Axis Digital Gyro
        • Grove 6 Axis Accelerometer And Compass V2.0
        • Grove 6 Axis Accelerometer And Gyroscope
        • Grove 80cm Infrared Proximity Sensor
        • Grove Air Quality Sensor v1.3
        • Grove Alcohol Sensor
        • Grove Barometer Sensor BME280
        • Grove Barometer Sensor BMP180
        • Grove Barometer Sensor BMP280
        • Grove Barometer Sensor
        • Grove Barometer High Accuracy
        • Grove Chest Strap Heart Rate Sensor
        • Grove CO2 Sensor
        • Grove Collision Sensor
        • Grove Digital Infrared Temperature Sensor
        • Grove Digital Light Sensor
        • Grove Dust Sensor
        • Grove Ear clip Heart Rate Sensor
        • Grove Electricity Sensor
        • Grove Finger clip Heart Rate Sensor with shell
        • Grove Finger clip Heart Rate Sensor
        • Grove Fingerprint Sensor
        • Grove Gas Sensor O2
        • Grove Gas Sensor
        • Grove HCHO Sensor
        • Grove High Temperature Sensor
        • Grove IMU 10DOF v2.0
        • Grove Infrared Receiver
        • Grove Line Finder
        • Grove Temperature and Humidity Sensor Pro
        • Grove Temperature And Humidity Sensor
        • Grove Voltage Divider
        • Grove Water Sensor
        • Grove XBee Carrier
      • Communication
        • Grove High Precision RTC
        • Grove LoRa Radio
        • Grove NFC Tag
        • Grove NFC
        • Grove 125KHz RFID Reader
        • Grove 315MHz RF Kit
        • Grove 433MHz Simple RF Link Kit
        • Grove Bee Socket
        • Grove BLE v1
        • Grove BLE dual model v1.0
        • Grove DMX512
        • Grove GPS
        • Grove I2C ADC
        • Grove I2C FM Receiver
        • Grove Protoshield
        • Grove RJ45 Adapter
        • Grove Screw Terminal
        • Grove Serial Bluetooth v3.0
        • Grove Serial RF Pro
        • Grove UART Wifi
      • Others
        • Grove Base Booster Pack
        • Grove Base Cape for BeagleBone v2
        • Grove Base HAT
        • Grove Base Shield for NodeMCU V1.0
        • Grove Base Shield for Photon
        • Grove Breakout for LinkIt Smart 7688 Duo
        • Grove Cape for BeagleBone Series
        • Grove Indoor Environment Kit for Edison
        • Grove Inventor Kit for microbit
        • Grove IoT Developer Kit Microsoft Azure Edition
        • Grove IoT Starter Kits Powered by AWS
        • Grove Recorder
        • Grove Shield for Intel Joule
        • Grove Smart Plant Care Kit
        • Grove Speech Recognizer Kit for Arduino
        • Grove Starter Kit for BeagleBone Green
        • Grove Starter Kit for IoT based on Raspberry Pi
        • Grove Starter kit for LinkIt Smart7688 Duo
        • Grove Starter Kit v3
        • Grove AND
        • Grove Base Shield for IOIO OTG
        • Grove BlinkM
        • Grove DC Jack Power
        • Grove Differential Amplifier v1.0
        • Grove Differential Amplifier v1.2
        • Grove GSR Sensor
        • Grove I2C Hub
        • Grove Joint v2.0
        • Grove Mega Shield
        • Grove Mini Camera
        • Grove Mixer Pack V2
        • Grove MOSFET
        • Grove Node
        • Grove NOT
        • Grove NunChuck
        • Grove OR
        • Grove PS 2 Adapter
        • Grove Recorder v2.0
        • Grove Serial Bluetooth
        • Grove Serial LCD V1.0
        • Grove Single Axis Analog Gyro
        • Grove SPDT Relay 30A
        • Grove Starter Kit for LinkIt ONE
        • Grove Starter Kit for mbed
        • Grove Toy Kit
        • Grove Wrapper
        • GrovePi Plus
  • Arduino
    • Graphical coding with Grove sensors
    • Arduino Comparison Sheet
    • Tutorials
      • Setup Arduino Every board in Arduino IDE
      • Arduino Cloud
      • Installing Libraries
      • Motor, Servo for Arduino
      • Sensor for Arduino
    • Examples
      • Genuino 101
        • Prerequisites
        • Shock / Tap Detection
        • LED Control Over Bluetooth
        • Board Orientation Detection
        • Pedometer – Step Counting Over Bluetooth
        • Timer Switch
        • Appendices
          • Appendix A
          • Appendix B
  • micro:bit
    • Examples
      • Servo with micro:bit
  • Halocode
    • Introduction
    • Get Started
    • Upload Mode
    • Speech Recognition
    • User Cloud Message
    • Use Python with HaloCode
    • Code with Mu A Simple Python Editor
      • Examples
        • Basic Project
          • Color Mixer
          • Compare Strength
          • Connect Wi-Fi
          • Control Multiple HaloCodes via LAN
          • Energy Ring
          • Make a Smiling Face with the LED Ring
          • Make a Volume Detector
          • Press the Button to play LED Animation Meteor
          • Rainbow Button
        • Level Up
          • Control HaloCode's LEDs via Voice Command
          • Remote Control
          • Make HaloCode the Steering Wheel of the Car on Stage
          • HaloCode's Remote Control Deck
          • Emotion Detector
          • Deep Learning and Facial Recognition
          • Use Global Variable to Interact with Sprites
        • Workshop
          • A Kitten with Blinking Eyes and a Waving Tail
          • Pedometer
          • Smart Home
  • Troubleshooting
    • Matatalab
      • Matatalab Upgrade
        • Pre Upgrade Instructions - MatataBot
        • MatataBot Upgrade
        • Matata Tower Upgrade
        • Resources for Upgrade
      • Matatalab Pairing
Powered by GitBook
On this page

Was this helpful?

  1. Halocode

Code with Mu A Simple Python Editor

PreviousUse Python with HaloCodeNextExamples

Last updated 5 years ago

Was this helpful?

Mu is a simple Python editor for beginner programmers. With the support of Mu, you can write Python and Micro Python code in the editor to control the Halocode and its associated electronic modules.

In addition to the basic features of Mu, this version supports more features, like firmware upgrade, code upload, online debugging through the REPL controller, and real-time viewing of variables and sensor values through plotter.

Preparation Before Use

Visit the website below to download the latest version of Mu and firmware of Halocode from GitHub: Unzip the file mu-editor.rar after downloading.

Quick Start Guide

After installation, the programming learning journey will begin!

1、Hardware Connection

Connect Halocode to your computer via the Micro USB cable. Note: You can also connect Halocode to your computer via Makeblock Bluetooth dongle.

2、Open the Software

Open the unzipped folder mu-editor, then double-click on the the file .main.exe to open Mu.

3、Select Mode

From the pop-up Select Mode page, select Makeblock HaloCode and click OK.

Note:You can also click Mode to select mode.

4、Update the Firmware

Before using the Mu editor, you need to use the latest Halocode firmware that we haven't released yet. Click Firmware and select the file firefly_firmware_25_01_004-ht1.bin from the pop-up dialog box. You can check the upgrade progress in the lower left corner of the software.

5、Start Programming

Now let's complete a programming task! Try to make the LEDs on the Halocode turn green. Here is the sample code:

import halo

halo.led.show_all(0, 255, 0)

6、Upload Your Program to the Halocode

More Features: Use the REPL Platform to Debug the Program

Reporting information

You can use the print() function in your program as long as the Halocode is connected to your computer (via the Micro USB cable or Makeblock Bluetooth dongle).Then you can check the real-time returns of print() in the REPL platform.

Here is a simple, write the code as shown below and upload it to the Halocode, then click REPL platform and check the value of microphone in the platform.

import halo

while True:

print(halo.microphone.get_loudness("maximum"))

Sending a Command

You can also use the platform to debug the program in real time.

More Features: Plotter

Check the variable values in real time

The plotter can graphically map variable values or sensor output values to make it easier to check the changes of the values.

Here is a simple, write code as shown below and upload it to the Halocode, click Plotter to check the value of microphone in real time.

import halo

while True:

halo.print_plot(halo.microphone.get_loudness())

time.sleep(0.1)

Note:When you connect the Halocode to the computer via Makeblock Bluetooth dongle, the plotter may have some delays due to the limit of Bluetooth communication speed.

Check changes of multiple variables simultaneously

The plotter supports checking the changes of multiple variables simultaneously.

Here is a simple, write the code as shown below and upload it to the Halocode, then click Plotter to check the changes of loudness and i%100.

import halo

i=1

while True:

halo.print_plot(halo.microphone.get_loudness(),i%100)

i=i+1

time.sleep(0.1)

More Documentation

Basic documentation

Note: We are simplifying our APIs to improve the user experience. (API is too long to use!) It will be expected to be completed in August. But we will keep the current APIs as possible as we can though some changes will take place.

Advanced documentation

The Halocode has powerful performance and networking capabilities, and we provide some sophisticated APIs for you, so you can build exciting hardware projects with the Halocode and its associated electronic modules, and learn from such things as network communication, IoT applications, APP development, etc. But be aware that these features are often more difficult to navigate.

The Halocode has powerful performance and networking capabilities, and we provide some sophisticated APIs for you, so you can build exciting hardware projects with the Halocode and its associated electronic modules, and learn from such things as network communication, IoT applications, APP development, etc. But be aware that these features are often more difficult to navigate.

network

Using the APIs in the network will help you make fully use of the Halocode networking capabilities.

network2

Using the APIs in the network will help you make fully use of the Halocode networking capabilities.

Default config:

DEFAULT_AP_IP = "192.168.4.1"

DEFAULT_STA_IP = "192.168.4.2"

DEFAULT_NETMARK = "255.255.255.0"

DEFAULT_GATEWAY = "192.168.1.1"

DEFAULT_DNS = "172.16.50.20"

DEFAULT_AUTHMODE = AUTH_WPA2_PSK

DEFAULT_PORT = 5050

API Reference

network2.config_ap(ssid, password)

Set the Halocode as an AP.

Note: The Halocode can not be AP and STA at the same time currently.

Parameters:

ssid (str) – wifi ssid password(str) – wifi password

Returns:

None

config_sta(ssid, password)

Set the Halocode as an STA.

Note: The Halocode can not be AP and STA at the same time currently.

Parameters:

ssid (str) – wifi ssid password(str) – wifi password

Returns:

None

is_connected()

Check first whether the Halocode is connected to other devices through WIFI. The API is effective when the Halocode functions as an AP or STA. Therefore, you can always obtain the connection status of the Halocode through this API.

set_ip(ip)

Set the IP address of the Halocode. The Halocode has a default IP address before using this API. DEFAULT_AP_IP = "192.168.4.1" DEFAULT_STA_IP = "192.168.4.2"

Parameters:

ip (str) – ipv4

Returns:

None

get_ip()

Gain Halocode own IP address.

set_subnet_mark(mark)

Set Halocode subnet mask.

Parameters:

mark (str) – wifi mark, 255.255.255.0 as defualt

Returns:

None

get_subnet_mark()

Get Halocode subnet mask.

set_gateway(gw)

Get Halocode subnet mask.

Parameters:

gateway (str) –

Returns:

None

get_gateway()

Get Halocode gateway.

create_client()

Set Halocode as a client.

client_connect_to(ip_to, port = DEFAULT_PORT)

Connect the Halocode to the server with the specified IP address and port.

create_server(port = DEFAULT_PORT)

Set Halocode as a server.

server_wait_connection(port = DEFAULT_PORT)

This API blocks the thread until a client connects to the server via a specific port, which returns information about the client.

server_get_connections(port = DEFAULT_PORT)

Get the IP addresses of all connected clients in list format.

server_get_latest_connection(port = DEFAULT_PORT)

Get the IP address of the client that was last connected.

write(data, mode, ip_to, port = DEFAULT_PORT)

Send data.

write_line(data, mode, ip_to, port = DEFAULT_PORT)

Send data line.

read(mode, ip_from, port = DEFAULT_PORT)

Accept data.

read_line(mode, ip_from, port = DEFAULT_PORT)

Accept data line.

communication

disable_channel_default(channel)

The Halocode communicates with its electronic module through the hardware serial port. The specific communication protocol is used between the two. If the communication protocol is to be closed, the serial port command of the optical ring board can be “customized”. Please use this instruction.

Parameters:

channel (str) – “uart1/ble”

Returns:

None

enable_channel_default(channel)

The Halocode communicates with its electronic module through the hardware serial port. A specific communication protocol is used between the two. To restore the communication command, use this command.

Parameters:

channel (str) – “uart1/ble”

Returns:

None

read(channel)

Read data through a specific channel.

Parameters:

channel (str) – “uart1/ble”

Returns:

bytearray

send(channel, data)

Send data through the set channel.

Parameters:

channel (str) – “uart1/ble” data (bytearray) – the data to send

Returns:

bytearray

Note:Please refer to to learn more about the function instructions。

Click Uploading to upload your program to the Halocode, then check if the LEDs turn green?

Here is a simple, write code in the platform and press the enter key, now check if the LEDs of Halocode turn red? You can also continue to send commands to check the loudness detected by the microphone:

If you want to implement more features of Halocode and its extension modules in Mu, please refer to 。

If you are not familiar with Python APIs of halocode, please refer to .

Micropython has implemented a network module and provides the corresponding documentation, which can be found at the following link:

We have developed the serial communication interface of the Ring Board, so that you can use these interfaces with a variety of hardware with serial communication capability (such as Raspberry Pie, some camera modules) .

Python API Reference
Python API Reference
Convert Blocks to Python Code
http://docs.micropython.org/en/latest/library/network.html
https://github.com/FFtust/mu/releases/tag/V0.0.1