Skip to content

Commit f40ab20

Browse files
Dygearrobotastic
andauthored
Update Pi Instructions for Trixie (#1042)
* Update Pi Instructions for Trixie Includes the newer `.sources` file format, and for the moment a comment and possible deletion of the dkms-xtra section. Wasn't needed at least on the 500+, we shall see if it's needed on the 500/5/CM5. * Removed deb-mm source as not needed. Removed the deb-mulimedia repo setup instructions as they are no longer needed. fdkaac can be installed from the stock repos. Thanks to @taclane for the assistance. * Update INSTALL-PI.md Updated RAM recommendations. * Update INSTALL-PI.md --------- Co-authored-by: Luke Berndt <[email protected]>
1 parent 0b5d494 commit f40ab20

File tree

1 file changed

+12
-28
lines changed

1 file changed

+12
-28
lines changed

docs/Install/INSTALL-PI.md

Lines changed: 12 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -56,24 +56,6 @@ This is a [good guide](https://www.raspberrypi.org/documentation/computers/remot
5656

5757
The following steps setup all of the libraries needed to build Trunk Recorder.
5858

59-
- Add the Debian Multimedia source and include non-free libraries, like **fdkaac**. Edit the sources.list file:
60-
```bash
61-
sudo nano /etc/apt/sources.list
62-
```
63-
- and add this line to the end:
64-
```
65-
deb https://www.deb-multimedia.org bookworm main non-free
66-
```
67-
- Download the keys for the apt source and install them:
68-
```bash
69-
wget https://www.deb-multimedia.org/pool/main/d/deb-multimedia-keyring/deb-multimedia-keyring_2024.9.1_all.deb
70-
sudo dpkg -i deb-multimedia-keyring_2024.9.1_all.deb
71-
```
72-
- You can verify the package integrity with:
73-
```bash
74-
sha256sum deb-multimedia-keyring_2024.9.1_all.deb
75-
8dc6cbb266c701cfe58bd1d2eb9fe2245a1d6341c7110cfbfe3a5a975dcf97ca deb-multimedia-keyring_2024.9.1_all.deb
76-
```
7759
- Update the OS:
7860
```
7961
sudo apt update
@@ -84,17 +66,11 @@ sudo apt upgrade
8466
sudo apt -y install libssl-dev openssl curl git fdkaac sox libcurl3-gnutls libcurl4 libcurl4-openssl-dev gnuradio gnuradio-dev gr-osmosdr libhackrf-dev libairspy-dev libairspyhf-dev libuhd-dev cmake make build-essential libboost-all-dev libusb-1.0-0-dev libsndfile1-dev
8567
```
8668

87-
- Remove xtra-dkms.
88-
DKMS is not needed on the Raspberry Pi platform, and just causes issues. The above command actually returns an error on Raspberry Pi OS. So we remove that module from our build so we do not get errors from subsaquent `apt` calls.
89-
```bash
90-
sudo apt remove xtrx-dkms
91-
```
92-
9369
## Configure RTL-SDRs to load correctly:
9470

9571
```bash
96-
sudo wget https://raw.githubusercontent.com/osmocom/rtl-sdr/master/rtl-sdr.rules ~/rtl-sdr.rules
97-
sudo mv ~/rtl-sdr.rules /etc/udev/rules.d/20.rtlsdr.rules
72+
wget https://raw.githubusercontent.com/osmocom/rtl-sdr/master/rtl-sdr.rules rtl-sdr.rules
73+
sudo mv rtl-sdr.rules /etc/udev/rules.d/20.rtlsdr.rules
9874
```
9975

10076
You will need to restart for the rules to take effect. Logging out and logging back in will not be enough.
@@ -103,7 +79,9 @@ You will need to restart for the rules to take effect. Logging out and logging b
10379
sudo shutdown -r now
10480
```
10581

106-
## Configuring the UHD for Ettus SDRs
82+
## Configuring the UHD for Ettus SDRs (Optional)
83+
84+
*You only need to do this step if you are going to be using an Ettus SDR*
10785

10886
If you haven't setup UHD yet there are a few extra steps you need to take:
10987

@@ -137,7 +115,13 @@ sudo udevadm trigger
137115

138116
In order to keep your copy of the Trunk Recorder source code free of build artifacts created by the build process, it is suggested to create a separate "out-of-tree" build directory. We will use `trunk-build` as our build directory. We by default do this in our home directory (`~` - Is a shortcut back to home.).
139117

140-
**Note:** Depending on the amount of RAM in your Raspberry Pi, it may be best to run `make -j1` (2GB), `make -j3` (4GB), and `make -j4` (8GB) in order to ensure that you do not run out of RAM, at the cost of making the compile process take longer. If you ran out of RAM the compile process will fail completely, so it can be an acceptable tradeoff.
118+
**Note:** Depending on the amount of RAM in your Raspberry Pi, you may need to adjust the number of parallel compilation jobs to avoid running out of memory. If you run out of RAM, the compile process will fail completely, so it can be an acceptable tradeoff to use fewer parallel jobs. If it does fail, you can just restart the build from where it left off.
119+
120+
| RAM Amount | Make Command | Notes |
121+
|------------|--------------|-------|
122+
| 2GB or less | `make -j1` | Single-threaded compilation |
123+
| 4GB or less | `make -j2` | Two parallel jobs |
124+
| 8GB or more | `make -j4` | Four parallel jobs |
141125

142126
```bash
143127
cd ~

0 commit comments

Comments
 (0)