MicroPython for ODROID-GO - Hello World
- Make sure that you've followed the MicroPython setup guide.
You will write code to display “Hello, ODROID-GO” on your ODROID-GO by following this guide.
MicroPython for ODROID-GO
We're providing a module for MicroPython development: odroid_go.py.
The module helps you to control the components on the board such as LCD, a lot of buttons, speaker, etc.
This module should be included first.
To prepare the board for use, it should be initialized. To initialize the board, use the GO.begin() function.
But the module calls GO.begin() function automatically when it loaded.
If you want to control the buttons on the board, you have to use the GO.update() function to apply the changes from the code.
The GO.update() function isn't used in this guide since only the LCD will be used to display a simple string.
Okay, let's see the initializing code.
from odroid_go import GO
This code will import GO instance from odroid_go.py module.
The GO instance has not only the 2 core functions but also a lot of helper functions that let you control the components on the board.
Now, let's use the GO.lcd functions to show “Hello, ODROID-GO”.
Hello World
We will use the GO.lcd.print function to show a string.
from odroid_go import GO GO.lcd.print("Hello, ODROID-GO")
This code would work like a charm, but the results text on the LCD will be too small to see.
Let's increase the font size by using the GO.lcd.set_font() function.
There're 4 different sizes of fonts implemented by default which you can select one of them accessing GO.lcd.fonts.*:
- GLCDFONT, TT14, TT24, TT32
GO.lcd.fonts.GLCDFONT is the original Adafruit-GFX-Library 5×7 font.
from odroid_go import GO GO.lcd.set_font(GO.lcd.fonts.TT24) GO.lcd.print("Hello, ODROID-GO")
You can also change the text color with GO.lcd.set_color(). Change the text to green with keeping the background as black.
There're a few pre-defined colors that you can select one of them accessing GO.lcd.colors.*:
- RED, GREEN, BLUE, BLACK, WHITE
You have to choose both of foreground and backgrounds color when you're using GO.lcd.set.color(fg, bg).
from odroid_go import GO GO.lcd.set_font(GO.lcd.fonts.TT24) GO.lcd.set_color(GO.lcd.colors.GREEN, GO.lcd.colors.BLACK) GO.lcd.print("Hello, ODROID-GO")
After then, save and overwrite this code file as boot.py in the ODROID-GO module installation directory.
Upload a module
- To execute this module properly, make sure you've uploaded ODROID-GO module. And you have to upload the written file called boot.py using rshell or ampy.
- If you uploaded properly, MicroPython will execute boot.py when the device boots automatically.
- Please refer to setup guide to further information: Install the ODROID-GO MicroPython module.
- Or you also can do them in REPL. Write the codes line by line in order.
Upload the boot.py file using rshell or ampy, enter to REPL prompt, and restart ODROID-GO.
If the procedure goes well, you can see “Hello, ODROID-GO” on your device.
A completed example
The complete example is available in following path:
- odroid_go/examples/hello_world/hello_world.py
Copy and paste to try the example.