https://github.com/lupin3000/picovision
Some simple retro games for PicoVision device from Pimoroni
https://github.com/lupin3000/picovision
micropython pico picovision python3 raspberry rp2040
Last synced: about 1 month ago
JSON representation
Some simple retro games for PicoVision device from Pimoroni
- Host: GitHub
- URL: https://github.com/lupin3000/picovision
- Owner: Lupin3000
- Created: 2023-11-25T08:56:12.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-27T18:22:13.000Z (over 2 years ago)
- Last Synced: 2025-01-26T13:31:33.412Z (over 1 year ago)
- Topics: micropython, pico, picovision, python3, raspberry, rp2040
- Language: Python
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PicoVision
## Overview of games
- [Pico Pong](pico_pong.py) ready for improvements
- [Pico Invaders](pico_invaders.py) ready for improvements
- [Battle Tank](battle_tank.py) in development
## Requirements
> If you start the first time have a look on this [website](https://learn.pimoroni.com/article/getting-started-with-picovision)! The original MicroPython firmware and examples (_from Pimoroni_) are available on [GitHub](https://github.com/pimoroni/picovision#introduction).
- Python 3.x installed
- latest [VCP](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads) driver installed
- 1x PicoVision (_[Pimoroni Shop](https://shop.pimoroni.com/products/picovision)_)
- 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!
```shell
# 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_)!
```shell
# 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.
```shell
# 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