PicoVision

Overview of games

• Pico Pong ready for improvements
• Pico Invaders ready for improvements
• Battle Tank in development

Requirements

If you start the first time have a look on this website! The original MicroPython firmware and examples (from Pimoroni) are available on GitHub.

• Python 3.x installed
• latest VCP driver installed
• 1x PicoVision (Pimoroni Shop)
• 1x HDMI cable
• 1x Monitor
• 1x USB cable (USB-A or USB-C to Micro-USB)
• optional speaker (3.5mm stereo jack)

Prepare local project and MicroPython environment

Download project from GitHub to your local device, create a Python virtual environment and install all needed Python libraries on your local device.

The described usage of Python virtual environment is recommended but not mandatory!

# clone project to local from GitHub
$ git clone https://github.com/Lupin3000/PicoVision.git

# change into git directory
$ cd PicoVision

# create virtual environment
$ python3 -m venv ./venv

# activate virtualenv
$ source venv/bin/activate

# install requirements
(venv) $ pip install -r requirements.txt

Prepare the PicoVision device

Backup all Pimoroni examples to local project directory examples and delete them on PicoVision device to save some storage.

The serial device interface example usbmodem14301 could be named different on you system (depending on your OS and USB port)!

# verify device connected
(venv) $ ls -la /dev/cu.usb*
crw-rw-rw-  1 root  wheel  0x9000005 Nov 25 10:17 /dev/cu.usbmodem14301

# create local backup directory
(venv) $ mkdir examples

# list all files and folders on device (optional)
(venv) $ rshell -p /dev/cu.usbmodem14301 ls /pyboard/

# copy examples from device to local backup directory
(venv) $ rshell -p /dev/cu.usbmodem14301 cp -r /pyboard/* examples/

# remove all files and directories on device
(venv) $ rshell -p /dev/cu.usbmodem14301 rm -r /pyboard/*

# copy main.py back to device
(venv) $ rshell -p /dev/cu.usbmodem14301 cp examples/main.py /pyboard/

# copy toaster.png back to device
(venv) $ rshell -p /dev/cu.usbmodem14301 cp examples/toaster.png /pyboard/

Upload games to PicoVision

Upload local files and folders to PicoVision device. After the successful upload, you can press the PicoVision RESET button to restart the device.

After the upload and first tests, you can delete the games you don't like.

# upload all Python files (example)
(venv) $ rshell -p /dev/cu.usbmodem14301 cp *.py /pyboard/

Participate the project

You are very welcome to take part in this project! No matter whether you want to develop new games or expand / optimize existing games. There are very few rules:

• Games must be developed in MicroPython
• No insults are allowed
• The code should be at least somewhat documented (e.g. DocStrings)
• Anyone who destroys something has to fix it again
• Do not upload Pimoroni examples