Code with Mu A Simple Python Editor

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: https://github.com/FFtust/mu/releases/tag/V0.0.1 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)

Note：Please refer to Python API Reference to learn more about the function instructions。

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

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

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.

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

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.

network

Micropython has implemented a network module and provides the corresponding documentation, which can be found at the following link: http://docs.micropython.org/en/latest/library/network.html

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.