docs/README-RPi.md

Thu, 11 Jul 2024 14:21:34 +0200

author
Detlev Offenbach <detlev@die-offenbachs.de>
date
Thu, 11 Jul 2024 14:21:34 +0200
branch
eric7
changeset 10840
c8045d0dbaa7
parent 10107
da76865312f1
child 11044
6d9f0f28de34
permissions
-rw-r--r--

MicroPython
- Updated the list of known CircuitPython boards for CPy 9.1.0.
- Updated the list of known UF2 capable boards.

10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
1 # Readme for use on a Raspberry Pi 4
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
2
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
3 In order to use eric7 on a Raspberry Pi 4 computer a Linux distribution providing
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
4 `Qt6` and `PyQt6` packages need to be installed. This recipe was tested on
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
5 __Manjaro ARM__.
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
6
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
7 This requirement is there because up to now no `PyQt6` and `PyQt6-Qt6` (and the like)
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
8 wheels are available form ARM computers via the Python Packaging Index PyPI.
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
9
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
10 ## 1. Step 1: Qt6 and PyQt6
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
11 Ensure the following `Qt6` and `PyQt6` packages are installed or install them.
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
12
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
13 - qt6-base
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
14 - qt6-charts
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
15 - qt6-doc
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
16 - qt6-imageformats
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
17 - qt6-multimedia
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
18 - qt6-serialport
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
19 - qt6-svg
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
20 - qt6-tools
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
21 - qt6-translations
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
22 - qt6-webchannel
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
23 - qt6-webengine
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
24 - python-pyqt6
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
25 - python-pyqt6-charts
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
26 - python-pyqt6-sip
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
27 - python-pyqt6-webengine
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
28 - python-qscintilla-qt6
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
29 - qscintilla-qt6
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
30
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
31
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
32 ## 2. Step 2: Spell Checking
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
33 If spell checking is desired, ensure the following packages are installed.
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
34
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
35 - enchant
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
36 - python-enchant
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
37 - aspell
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
38 - any aspell language dictionary desired (suggested at least 'aspell-en')
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
39
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
40 ## 3. Step 3: Prepare eric7 Installation
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
41 In order to install eric7 it is recommended to create a Python virtual environment in
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
42 order to isolate the eric7 execution environment as much as possible from the standard
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
43 installation. In order to create this environment execute the following in a terminal
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
44 window.
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
45
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
46 python3 -m venv --system-site-packages eric7_env
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
47 ~/eric7_env/bin/python3 -m pip install --upgrade pip
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
48
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
49 __Note:__ The switch `--system-site-packages` is necessary because there are no
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
50 PyQt6/Qt6 packages available for the AArch64 (ARM) platform. This necessitates
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
51 the use of the packages provided by the distribution.
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
52
10107
da76865312f1 Changed the included documentation to Markdown format and corrected some of the texts.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 10031
diff changeset
53 ## 4. Step 4: Install eric7 (eric-ide)
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
54 Install eric7 into the created Python virtual environment by following these steps.
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
55
10031
6d4b46787f30 Updated the installation instructions in various README files to include the "--prefer-binary" option.
Detlev Offenbach <detlev@die-offenbachs.de>
parents: 9354
diff changeset
56 ~/eric7_env/bin/python3 -m pip install --prefer-binary eric-ide
9354
91ae1bc5ee9b Added a read-me file for installing eric on a Raspberry Pi 4 computer.
Detlev Offenbach <detlev@die-offenbachs.de>
parents:
diff changeset
57 ~/eric7_env/bin/eric7_post_install

eric ide

mercurial