2024-06-16 13:03:26 +02:00
|
|
|
TuxGo
|
|
|
|
|
=====
|
|
|
|
|
|
|
|
|
|
Dedication
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
*To my Daughters: Marta, Ola and Klara.*
|
2023-12-07 23:43:09 +01:00
|
|
|
|
|
|
|
|
Hardware requirements
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
Control box
|
|
|
|
|
^^^^^^^^^^^
|
|
|
|
|
- Raspberry Pi 4+ or later
|
|
|
|
|
- Camera (tested with Camera Module 3)
|
|
|
|
|
- Monitor that can be rotated to vertical (tested on 1024x1280)
|
|
|
|
|
- Keyboard
|
|
|
|
|
|
|
|
|
|
Robot
|
|
|
|
|
^^^^^
|
|
|
|
|
- bbc:microbit v1
|
|
|
|
|
- DFRobot Maqueen
|
|
|
|
|
|
|
|
|
|
It is technically possible to write firmware for any robot that can connect over
|
|
|
|
|
Bluetooth LE. Contributions are welcome.
|
|
|
|
|
|
|
|
|
|
Getting started
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
- Install RaspberryPi OS (at least 12/bookworm) on the SD card, as documented in
|
|
|
|
|
RPi documentation.
|
|
|
|
|
- Connect camera, keyboard and display.
|
|
|
|
|
- Start RPi and configure screen to vertical.
|
|
|
|
|
- Install dependencies:
|
|
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
|
|
sudo apt-get install \
|
|
|
|
|
python3-bleak \
|
|
|
|
|
python3-click \
|
|
|
|
|
python3-click-default-group \
|
|
|
|
|
python3-flask \
|
|
|
|
|
python3-funcparserlib \
|
2024-11-28 12:43:35 +01:00
|
|
|
python3-loguru \
|
2023-12-07 23:43:09 +01:00
|
|
|
python3-matplotlib \
|
|
|
|
|
python3-opencv \
|
2024-11-28 18:07:20 +01:00
|
|
|
python3-pygame \
|
2024-11-28 12:43:35 +01:00
|
|
|
python3-werkzeug
|
2023-12-07 23:43:09 +01:00
|
|
|
|
|
|
|
|
- Run the game:
|
|
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
|
|
python3 -m tuxgo
|
|
|
|
|
|
|
|
|
|
Acknowledgements
|
|
|
|
|
----------------
|
|
|
|
|
|
2024-06-16 13:03:26 +02:00
|
|
|
See ``Documentation/acknowledgements.rst``
|
2023-12-07 23:43:09 +01:00
|
|
|
|
|
|
|
|
.. vim: tw=80 ts=4 sts=4 sw=4 et
|
