Recent changes to HowTo

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sun, 29 Dec 2024 17:59:32 -0000

--- v15
+++ v16
@@ -53,7 +53,7 @@
 Not used till now, look for yourself.

 ## Set PiRobot Home Path
-Open `MAIN.py` or `APP_BASE.py` (MAIN.py overwrites the path in APP_BASE.py)
+Open `MAIN.py` or `APP_BASE.py`with a text editor.  (MAIN.py overwrites the path in APP_BASE.py)

 You need to set the full path to the scripts in `APP_BASE.py` (or `MAIN.py`): 
 `APP_BASE.HOME_PATH="/full/path/to/this/scripts/"`

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sun, 29 Dec 2024 17:58:28 -0000

--- v14
+++ v15
@@ -62,7 +62,7 @@
 `APP_BASE.HOME_PATH="C:\\full/path/to/this/scripts/"`, with the drive at the beginning.

 You need to add a slash at the end!
-This is for proper file loading and saving into the `userdata` and `appdata` directories so that  this scripts can be started from somewhere other than their home dir. That is the case with the desktop file above. I have set `Path` in the desktop file but it did not work. So I added the `HOME_PATH`-variable to `APP_BASE`.
+This is for proper file loading and saving into the `userdata` and `appdata` directories so that  this scripts can be started from somewhere other than their home dir. That is the case with the desktop file below. I have set `Path` in the desktop file but it did not work. So I added the `HOME_PATH`-variable to `APP_BASE`.

 ##Usage
 Run it on autostart with the desktop file below or with `python3 MAIN.py` in the directory of this scripts.

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sun, 29 Dec 2024 17:56:20 -0000

--- v13
+++ v14
@@ -52,6 +52,33 @@
 ####MacOS:
 Not used till now, look for yourself.

+## Set PiRobot Home Path
+Open `MAIN.py` or `APP_BASE.py` (MAIN.py overwrites the path in APP_BASE.py)
+
+You need to set the full path to the scripts in `APP_BASE.py` (or `MAIN.py`): 
+`APP_BASE.HOME_PATH="/full/path/to/this/scripts/"`
+
+On Windows it's:
+`APP_BASE.HOME_PATH="C:\\full/path/to/this/scripts/"`, with the drive at the beginning.
+
+You need to add a slash at the end!
+This is for proper file loading and saving into the `userdata` and `appdata` directories so that  this scripts can be started from somewhere other than their home dir. That is the case with the desktop file above. I have set `Path` in the desktop file but it did not work. So I added the `HOME_PATH`-variable to `APP_BASE`.
+
+##Usage
+Run it on autostart with the desktop file below or with `python3 MAIN.py` in the directory of this scripts.
+
+It shows you a face. 
+The face app is the "underlying application", or the "system root" or whatever you may call that. You can change it of course.
+
+Press/touch a mouse button on the upper part of the screen to show the time. (Mouse is hidden because it's a touch screen.)
+Left eye is hours, right eye is minutes.
+If you release it on the lower part of the screen, it will show you a menu.
+This menu is customizable. Here you can switch between the "installed" Apps.
+Several games are programmed into it and you may add new menu items or change the old ones easily.
+
+Have Fun with the games and maybe draw something with your fingers.
+You can save and load images from the drawing App and game states in the chess App right now.
+
 ## Add autostart (Raspbian Linux)
 You can skip this if you run it on another machine/OS than Raspberry Pi with Raspbian.

@@ -81,33 +108,6 @@
 Everything was preinstalled on my Raspbian, even the pygame library.
 If not, try `pip install pygame` - maybe you need to install pip, too. Should not happen nowadays.

-## Set PiRobot Home Path
-Open `MAIN.py` or `APP_BASE.py` (MAIN.py overwrites the path in APP_BASE.py)
-
-You need to set the full path to the scripts in `APP_BASE.py` (or `MAIN.py`): 
-`APP_BASE.HOME_PATH="/full/path/to/this/scripts/"`
-
-On Windows it's:
-`APP_BASE.HOME_PATH="C:\\full/path/to/this/scripts/"`, with the drive at the beginning.
-
-You need to add a slash at the end!
-This is for proper file loading and saving into the `userdata` and `appdata` directories so that  this scripts can be started from somewhere other than their home dir. That is the case with the desktop file above. I have set `Path` in the desktop file but it did not work. So I added the `HOME_PATH`-variable to `APP_BASE`.
-
-##Usage
-Run it on autostart wit the desktop file above or with `python3 MAIN.py` in the directory of this scripts.
-
-It shows you a face. 
-The face app is the "underlying application", or the "system root" or whatever you may call that. You can change it of course.
-
-Press/touch a mouse button on the upper part of the screen to show the time. (Mouse is hidden because it's a touch screen.)
-Left eye is hours, right eye is minutes.
-If you release it on the lower part of the screen, it will show you a menu.
-This menu is customizable. Here you can switch between the "installed" Apps.
-Several games are programmed into it and you may add new menu items or change the old ones easily.
-
-Have Fun with the games and maybe draw something with your fingers.
-You can save and load images from the drawing App and game states in the chess App right now.
-
 ## Further information
 Look into the files for further information. Everything is well commented.
 Begin with `MAIN.py`, this is the startup file.

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:30:55 -0000

--- v12
+++ v13
@@ -5,7 +5,7 @@
 You can run this framework on any machine you like. 
 If you want/have some other machine/OS than a Raspberry Pi (e.g. a Windows Laptop),  just download the code and set the framework home path like described below.

-I could not bring the Music Player to run on Windows.
+NOTE: I could not bring the Music Player to run on Windows because of missing depencies.

 ##Get the following:
 You can skip this if you run the framework on another machine or OS.
@@ -14,7 +14,7 @@
 Touch Display for it:  https://www.pi-shop.ch/7-touch-display-kit-for-raspberry-pi-zero
 And some power: https://www.pi-shop.ch/27w-usb-c-pd-power-supply-eu-plug-white

-The parts can be simply sticked together, No soldering needed. 
+The parts can be simply sticked together, No soldering needed.

 You have a computer for under 100 CHF then.

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:22:51 -0000

--- v11
+++ v12
@@ -39,16 +39,17 @@

 Maybe you need to install git before.

-###Debian Linux:
-`apt install git`
+### (How to install GIT)
+####Debian Linux:
+`sudo apt install git`

-###Alpine Linux:
-`apk add git`
+####Alpine Linux:
+`apk add git` as root user.

-###Windows:
+####Windows:
 Head to the [git website](https://git-scm.com/downloads/win), download the installer and install it on your machine.

-###MacOS:
+####MacOS:
 Not used till now, look for yourself.

 ## Add autostart (Raspbian Linux)

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:19:16 -0000

--- v10
+++ v11
@@ -80,9 +80,15 @@
 Everything was preinstalled on my Raspbian, even the pygame library.
 If not, try `pip install pygame` - maybe you need to install pip, too. Should not happen nowadays.

-## Set Home Path
+## Set PiRobot Home Path
+Open `MAIN.py` or `APP_BASE.py` (MAIN.py overwrites the path in APP_BASE.py)
+
 You need to set the full path to the scripts in `APP_BASE.py` (or `MAIN.py`): 
 `APP_BASE.HOME_PATH="/full/path/to/this/scripts/"`
+
+On Windows it's:
+`APP_BASE.HOME_PATH="C:\\full/path/to/this/scripts/"`, with the drive at the beginning.
+
 You need to add a slash at the end!
 This is for proper file loading and saving into the `userdata` and `appdata` directories so that  this scripts can be started from somewhere other than their home dir. That is the case with the desktop file above. I have set `Path` in the desktop file but it did not work. So I added the `HOME_PATH`-variable to `APP_BASE`.

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:14:53 -0000

--- v9
+++ v10
@@ -3,7 +3,8 @@
 Back to [Home]

 You can run this framework on any machine you like. 
-If you want/have some other machine/OS (e.g. a Windows Laptop),  just download the code and set the framework home path like described below.
+If you want/have some other machine/OS than a Raspberry Pi (e.g. a Windows Laptop),  just download the code and set the framework home path like described below.
+
 I could not bring the Music Player to run on Windows.

 ##Get the following:

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:13:57 -0000

--- v8
+++ v9
@@ -50,7 +50,7 @@
 ###MacOS:
 Not used till now, look for yourself.

-## Add autostart
+## Add autostart (Raspbian Linux)
 You can skip this if you run it on another machine/OS than Raspberry Pi with Raspbian.

 User is `pi` and `MAIN.py` is in `/home/pi/robot` here, you may have other name and directory:

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:13:10 -0000

--- v7
+++ v8
@@ -3,7 +3,7 @@
 Back to [Home]

 You can run this framework on any machine you like. 
-If you want/have some other machine/OS (e.g. a Windows Laptop),  just download the code and set the home path like described below.
+If you want/have some other machine/OS (e.g. a Windows Laptop),  just download the code and set the framework home path like described below.
 I could not bring the Music Player to run on Windows.

 ##Get the following:

HowTo modified by Benedict Jäggi

Benedict Jäggi — Sat, 28 Dec 2024 23:12:27 -0000

--- v6
+++ v7
@@ -2,7 +2,13 @@
 #HowTo
 Back to [Home]

+You can run this framework on any machine you like. 
+If you want/have some other machine/OS (e.g. a Windows Laptop),  just download the code and set the home path like described below.
+I could not bring the Music Player to run on Windows.
+
 ##Get the following:
+You can skip this if you run the framework on another machine or OS.
+
 Raspberry Pi Zero 2 W: https://www.pi-shop.ch/raspberry-pi-zero-2-w-starter-kit
 Touch Display for it:  https://www.pi-shop.ch/7-touch-display-kit-for-raspberry-pi-zero
 And some power: https://www.pi-shop.ch/27w-usb-c-pd-power-supply-eu-plug-white
@@ -12,6 +18,8 @@
 You have a computer for under 100 CHF then.

 ##Flash Raspbian 32bit Desktop onto the SD Card
+You can skip this if you run the framework on another machine or OS.
+
 I first used 64bit but it was freaking slow. Maybe because I  fiddled with the display settings and set the GPU RAM to 256MB?
 I now use 32bit version and did not change anything on the display settings anymore. It just works fine.

@@ -24,7 +32,27 @@
 From the git repository here.
 See Code section for further information.

+Short: `git clone https://git.code.sf.net/p/pirobot/code robot`
+
+This will clone the framework into the `robot` directory.
+
+Maybe you need to install git before.
+
+###Debian Linux:
+`apt install git`
+
+###Alpine Linux:
+`apk add git`
+
+###Windows:
+Head to the [git website](https://git-scm.com/downloads/win), download the installer and install it on your machine.
+
+###MacOS:
+Not used till now, look for yourself.
+
 ## Add autostart
+You can skip this if you run it on another machine/OS than Raspberry Pi with Raspbian.
+
 User is `pi` and `MAIN.py` is in `/home/pi/robot` here, you may have other name and directory:

 `cd /home/pi/.config`