maixbit_tutorials

Tutorials and samples for Maix Bit

This repo is based on MaixPy official documentation, but specialized for Maix Bit.

Set up

Add user in dialout group

sudo adduser $(whoami) dialout

After this command, you need to logout and login.

Connect Maix Bit

Connect Maix Bit, LCD, camera and USB-C like below.

Check whether Maix Bit is detected

ls -alF /dev/ttyUSB*
# /dev/ttyUSB0 might be detected.

Update firmware

Download latest firmware

Download latest firmware MaixPy v0.3.2 from here.

Download kflash_gui

Download kflash_gui v1.3.2 from links below.

• Ubuntu 18.04
• Ubuntu 16.04

Run kflash_gui

cd ~/Downloads
tar xvzf kflash_gui_v1.3.2_ubuntu16.tar.xz
cd kflash_gui
./kflash_gui

Burn firmware

Set kflash_gui like below and burn maixpy_v0.3.2_full.bin into Flash.

Install and set up minicom

Install minicom

sudo apt install minicom

Set up minicom

sudo minicom -s

Set up following settings.

• Serial Device: /dev/ttyUSB0
• Backspace key sends: DEL
• Line wtap: Yes

For more detailed information, read here.

Try minicom

minicom

In minicom, you can try import MaixPy.

>>> import Maix
>>>
# no error means success.

You can also try LED blink test as below.

from Maix import GPIO

fm.register(board_info.LED_R, fm.fpioa.GPIO0)

led_r=GPIO(GPIO.GPIO0,GPIO.OUT)
led_r.value(0)

Finish minicom

You can finish minicom with Ctrl+A X.

Install uPyLoader

Download uPyLoader

Download uPyLoader from here.

Install uPyLoader

cd ~/Downloads
mkdir ~/.local/bin
export PATH=$HOME/.local/bin:$PATH
# you can write it in ~/.bashrc
cp ./uPyLoader-linux ~/.local/bin/uPyLoader
uPyLoader

Run display demo

Clone this repo

git clone https://github.com/knorth55/maixbit_tutorials.git

Upload scripts/demo_fps_display.py

cd maixbit_tutorials
uPyLoader

First click connect button to connect /dev/ttyUSB0.

Then, select scripts/demo_fps_display.py and click Transfer button below.

Run display demo via minicom

Run minicom

minicom

Then, execute demo_fps_display.py as below.

with open('demo_fps_display.py') as f:
    exec(f.read())
fps_display()

Now, LCD show camera RGB image with FPS.

Run YOLO find face demo

Clone this repo

Same as here .

Burn face_model_at_0x300000.kfpkg into Maix Bit Flash

First, download face_model_at_0x300000.kfpkg YOLO face detection model from here.

Then, burn face_model_at_0x300000.kfpkg by kflash_gui as below.

cd ~/Downloads/kflash_gui
./kflash_gui

Upload scripts/demo_find_face.py

Same as here.

Run find face demo via minicom

minicom

Then, execute demo_find_face.py as below.

with open('demo_find_face.py') as f:
    exec(f.read())
find_face()

Finally, you can get face detection as below.