diff --git a/Gemfile.lock b/Gemfile.lock index cf036ed3a9..b0ee687d5a 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -57,7 +57,7 @@ GEM jekyll (>= 3.5, < 5.0) jekyll-feed (~> 0.9) jekyll-seo-tag (~> 2.1) - nokogiri (1.16.2) + nokogiri (1.16.3) mini_portile2 (~> 2.8.2) racc (~> 1.4) pathutil (0.16.2) diff --git a/documentation/asciidoc/computers/camera/rpicam_apps_building.adoc b/documentation/asciidoc/computers/camera/rpicam_apps_building.adoc index 87dff3b2bc..bd8ef286ee 100644 --- a/documentation/asciidoc/computers/camera/rpicam_apps_building.adoc +++ b/documentation/asciidoc/computers/camera/rpicam_apps_building.adoc @@ -1,172 +1,256 @@ === Building `libcamera` and `rpicam-apps` -Building `libcamera` and `rpicam-apps` for yourself can bring the following benefits. +Build `libcamera` and `rpicam-apps` for yourself for the following benefits: -* You can pick up the latest enhancements and features +* You can pick up the latest enhancements and features. -* `rpicam-apps` can be compiled with extra optimisation for Raspberry Pi 3 and Raspberry Pi 4 devices running a 32-bit OS +* `rpicam-apps` can be compiled with extra optimisation for Raspberry Pi 3 and Raspberry Pi 4 devices running a 32-bit OS. -* You can include the various optional OpenCV and/or TFLite post-processing stages (or add your own) +* You can include optional OpenCV and/or TFLite post-processing stages, or add your own. * You can customise or add your own applications derived from `rpicam-apps` -NOTE: When building on a Raspberry Pi with 1GB RAM or less, there is a risk that the device may run out of swap and fail. We recommend either increasing the amount of swap, or building with fewer threads (the `-j` option to `ninja` and to `make`). +==== Building `rpicam-apps` without building `libcamera` -==== Building `rpicam-apps` without rebuilding `libcamera` - -You can rebuild `rpicam-apps` _without_ first rebuilding the whole of `libcamera` and `libepoxy`. If you do not need support for the GLES/EGL preview window then `libepoxy` can be omitted entirely. Raspberry Pi OS Lite users must be sure to use `-Denable_egl=false` when running `meson setup` later: +To build `rpicam-apps` without first rebuilding `libcamera` and `libepoxy`, install `libcamera`, `libepoxy` and their dependencies with `apt`: +[source,console] ---- -sudo apt install -y libcamera-dev libjpeg-dev libtiff5-dev libpng-dev +$ sudo apt install -y libcamera-dev libepoxy-dev libjpeg-dev libtiff5-dev libpng-dev ---- -All other users should execute: +TIP: If you do not need support for the GLES/EGL preview window, omit `libepoxy-dev`. + +To use the Qt preview window, install the following additional dependencies: +[source,console] ---- -sudo apt install -y libcamera-dev libepoxy-dev libjpeg-dev libtiff5-dev libpng-dev +$ sudo apt install -y qtbase5-dev libqt5core5a libqt5gui5 libqt5widgets5 ---- -If you want to use the Qt preview window: +For xref:camera_software.adoc#libav-integration-with-rpicam-vid[`libav`] support in `rpicam-vid`, install the following additional dependencies: +[source,console] ---- -sudo apt install -y qtbase5-dev libqt5core5a libqt5gui5 libqt5widgets5 +$ sudo apt install libavcodec-dev libavdevice-dev libavformat-dev libswresample-dev ---- -If you want xref:camera_software.adoc#libav-integration-with-rpicam-vid[`libav`] support in `rpicam-vid`, additional libraries must be installed: +If you run Raspberry Pi OS Lite, install `git`: +[source,console] ---- -sudo apt install libavcodec-dev libavdevice-dev libavformat-dev libswresample-dev +$ sudo apt install -y git ---- -Now proceed directly to the instructions for xref:camera_software.adoc#building-rpicam-apps[building `rpicam-apps`]. Raspberry Pi OS Lite users should check that git is installed first (`sudo apt install -y git`). +Next, xref:camera_software.adoc#building-rpicam-apps[build `rpicam-apps`]. ==== Building `libcamera` -Rebuilding `libcamera` from scratch should be necessary only if you need the latest features that may not yet have reached the `apt` repositories, or if you need to customise its behaviour in some way. +NOTE: Only build `libcamera` from scratch if you need custom behaviour or the latest features that have not yet reached `apt` repositories. -First install all the necessary dependencies for `libcamera`. Raspberry Pi OS Lite users will first need to install the following additional packages if they have not done so previously: +[NOTE] +====== +If you run Raspberry Pi OS Lite, begin by installing the following packages: +[source,console] ---- -sudo apt install -y python3-pip git python3-jinja2 +$ sudo apt install -y python3-pip git python3-jinja2 ---- +====== -All users should then install the following: +First, install the following `libcamera` dependencies: +[source,console] ---- -sudo apt install -y libboost-dev -sudo apt install -y libgnutls28-dev openssl libtiff5-dev pybind11-dev -sudo apt install -y qtbase5-dev libqt5core5a libqt5gui5 libqt5widgets5 -sudo apt install -y meson cmake -sudo apt install -y python3-yaml python3-ply +$ sudo apt install -y libboost-dev +$ sudo apt install -y libgnutls28-dev openssl libtiff5-dev pybind11-dev +$ sudo apt install -y qtbase5-dev libqt5core5a libqt5gui5 libqt5widgets5 +$ sudo apt install -y meson cmake +$ sudo apt install -y python3-yaml python3-ply +$ sudo apt install -y libglib2.0-dev libgstreamer-plugins-base1.0-dev ---- -In the `meson` commands below we have enabled the gstreamer plugin. If you do not need this, you can set `-Dgstreamer=disabled` instead and the next pair of dependencies will not be required. But if you do leave _gstreamer_ enabled, then you will need the following: +Now we're ready to build `libcamera` itself. +Download a local copy of Raspberry Pi's fork of `libcamera` from GitHub: + +[source,console] ---- -sudo apt install -y libglib2.0-dev libgstreamer-plugins-base1.0-dev +$ git clone https://github.com/raspberrypi/libcamera.git ---- -Now we can check out and build `libcamera` itself. We check out Raspberry Pi's fork of `libcamera`, which tracks the official repository but lets us control exactly when we pick up new features. +Navigate into the root directory of the repository: +[source,console] ---- -cd -git clone https://github.com/raspberrypi/libcamera.git -cd libcamera +$ cd libcamera ---- -Now run: +Next, run `meson` to configure the build environment: +[source,console] ---- -meson setup build --buildtype=release -Dpipelines=rpi/vc4,rpi/pisp -Dipas=rpi/vc4,rpi/pisp -Dv4l2=true -Dgstreamer=enabled -Dtest=false -Dlc-compliance=disabled -Dcam=disabled -Dqcam=disabled -Ddocumentation=disabled -Dpycamera=enabled +$ meson setup build --buildtype=release -Dpipelines=rpi/vc4,rpi/pisp -Dipas=rpi/vc4,rpi/pisp -Dv4l2=true -Dgstreamer=enabled -Dtest=false -Dlc-compliance=disabled -Dcam=disabled -Dqcam=disabled -Ddocumentation=disabled -Dpycamera=enabled ---- -To complete the `libcamera` build, use: +NOTE: You can disable the `gstreamer` plugin by replacing `-Dgstreamer=enabled` with `-Dgstreamer=disabled` during the `meson` build configuration. If you disable `gstreamer`, there is no need to install the `libglib2.0-dev` and `libgstreamer-plugins-base1.0-dev` dependencies. + +Now, you can build `libcamera` with `ninja`: +[source,console] ---- -ninja -C build # use -j 2 on Raspberry Pi 3 or earlier devices -sudo ninja -C build install +$ ninja -C build ---- -NOTE: At the time of writing, `libcamera` does not yet have a stable binary interface. Therefore, if you have rebuilt `libcamera`, we recommend continuing and rebuilding `rpicam-apps` from scratch too. +Finally, run the following command to install your freshly-built `libcamera` binary: -==== Building `libepoxy` +[source,console] +---- +$ sudo ninja -C build install +---- -Rebuilding `libepoxy` should not normally be necessary as this library changes only very rarely. If you do want to build it from scratch, however, please follow the instructions below. +TIP: On devices with 1GB of memory or less, the build may exceed available memory. Append the `-j 1` flag to `ninja` commands to limit the build to a single process. This should prevent the build from exceeding available memory on devices like the Raspberry Pi Zero and the Raspberry Pi 3. -Start by installing the necessary dependencies. +`libcamera` does not yet have a stable binary interface. Always build `rpicam-apps` after you build `libcamera`. + +==== Building `rpicam-apps` +First fetch the necessary dependencies for `rpicam-apps`. + +[source,console] ---- -sudo apt install -y libegl1-mesa-dev +$ sudo apt install -y cmake libboost-program-options-dev libdrm-dev libexif-dev +$ sudo apt install -y meson ninja-build ---- -Next, check out and build `libepoxy`. +Download a local copy of Raspberry Pi's `rpicam-apps` GitHub repository: +[source,console] ---- -cd -git clone https://github.com/anholt/libepoxy.git -cd libepoxy -mkdir _build -cd _build -meson -ninja -sudo ninja install +$ git clone https://github.com/raspberrypi/rpicam-apps.git ---- -==== Building `rpicam-apps` +Navigate into the root directory of the repository: -First fetch the necessary dependencies for `rpicam-apps`. +[source,console] +---- +$ cd rpicam-apps +---- + +For desktop-based operating systems like Raspberry Pi OS, configure the `rpicam-apps` build with the following `meson` command: +[source,console] ---- -sudo apt install -y cmake libboost-program-options-dev libdrm-dev libexif-dev -sudo apt install -y meson ninja-build +$ meson setup build -Denable_libav=true -Denable_drm=true -Denable_egl=true -Denable_qt=true -Denable_opencv=false -Denable_tflite=false ---- -The `rpicam-apps` build process begins with the following: +For headless operating systems like Raspberry Pi OS Lite, configure the `rpicam-apps` build with the following `meson` command: +[source,console] ---- -cd -git clone https://github.com/raspberrypi/rpicam-apps.git -cd rpicam-apps +$ meson setup build -Denable_libav=false -Denable_drm=true -Denable_egl=false -Denable_qt=false -Denable_opencv=false -Denable_tflite=false ---- -At this point you will need to run `meson setup` after deciding what extra flags to pass it. The valid flags are: +[TIP] +====== -* `-Dneon_flags=armv8-neon` - you may supply this when building for Raspberry Pi 3 or Raspberry Pi 4 devices running a 32-bit OS. Some post-processing features may run more quickly. +* Use `-Dneon_flags=armv8-neon` to enable optimisations for 32-bit OSes on Raspberry Pi 3 or Raspberry Pi 4. +* Use `-Denable_opencv=true` if you have installed OpenCV and wish to use OpenCV-based post-processing stages. +* Use `-Denable_tflite=true` if you have installed TensorFlow Lite and wish to use it in post-processing stages. -* `-Denable_libav=true` or `-Denable_libav=false` - this enables or disables the libav encoder integration. +====== + +You can now build `rpicam-apps` with the following command: + +[source,console] +---- +$ meson compile -C build +---- + +TIP: On devices with 1GB of memory or less, the build may exceed available memory. Append the `-j 1` flag to `meson` commands to limit the build to a single process. This should prevent the build from exceeding available memory on devices like the Raspberry Pi Zero and the Raspberry Pi 3. + +Finally, run the following command to install your freshly-built `rpicam-apps` binary: + +[source,console] +---- +$ sudo meson install -C build +---- -* `-Denable_drm=true` or `-Denable_drm=false` - this enables or disables the DRM/KMS preview rendering. This is what implements the preview window when a desktop environment is not running. +Open a new terminal window after installation to ensure that you use the new binary. -* `-Denable_egl=true` or `-Denable_egl=false` - this enables or disables the desktop environment-based preview. You should disable this if your system does not have a desktop environment installed. +Finally, follow the `dtoverlay` and display driver instructions in the xref:camera_software.adoc#getting-started[Getting Started section]. -* `-Denable_qt=true` or `-Denable_qt=false` - this enables or disables support for the Qt-based implementation of the preview window. You should disable it if you do not have a desktop environment installed, or if you have no intention of using the Qt-based preview window. The Qt-based preview is normally not recommended because it is computationally very expensive, however it does work with X display forwarding. +==== `rpicam-apps` meson flag reference -* `-Denable_opencv=true` or `-Denable_opencv=false` - you may choose one of these to force OpenCV-based post-processing stages to be linked (or not). If you enable them, then OpenCV must be installed on your system. Normally they will be built by default if OpenCV is available. +The `meson` build configuration for `rpicam-apps` supports the following flags: -* `-Denable_tflite=true` or `-Denable_tflite=false` - choose one of these to enable TensorFlow Lite post-processing stages (or not). By default they will not be enabled. If you enable them then TensorFlow Lite must be available on your system. Depending on how you have built and/or installed TFLite, you may need to tweak the `meson.build` file in the `post_processing_stages` directory. +`-Dneon_flags=armv8-neon`:: Speeds up certain post-processing features on Raspberry Pi 3 or Raspberry Pi 4 devices running a 32-bit OS. -For Raspberry Pi OS users we recommend the following `meson setup` command: +`-Denable_libav=true`:: Enables or disables `libav` encoder integration. +`-Denable_drm=true`:: Enables or disables **DRM/KMS preview rendering**, a preview window used in the absence of a desktop environment. + +`-Denable_egl=true`:: Enables or disables the non-Qt desktop environment-based preview. Disable if your system lacks a desktop environment. + +`-Denable_qt=true`:: Enables or disables support for the Qt-based implementation of the preview window. Disable if you do not have a desktop environment installed or if you have no intention of using the Qt-based preview window. The Qt-based preview is normally not recommended because it is computationally very expensive, however it does work with X display forwarding. + +`-Denable_opencv=true`:: Forces OpenCV-based post-processing stages to link or not link. Requires OpenCV to enable. Defaults to `true` when OpenCV is installed, `false` otherwise. + +`-Denable_tflite=true`:: Enables or disables TensorFlow Lite post-processing stages. Disabled by default. Requires Tensorflow Lite to enable. Depending on how you have built and/or installed TFLite, you may need to tweak the `meson.build` file in the `post_processing_stages` directory. + +NOTE: To disable any of the flags shown above with `true` as a value, replace `true` with `false`. + + +==== Building `libepoxy` + +Rebuilding `libepoxy` should not normally be necessary as this library changes only very rarely. If you do want to build it from scratch, however, please follow the instructions below. + +Start by installing the necessary dependencies. + +[source,console] ---- -meson setup build -Denable_libav=true -Denable_drm=true -Denable_egl=true -Denable_qt=true -Denable_opencv=false -Denable_tflite=false +$ sudo apt install -y libegl1-mesa-dev ---- -and for Raspberry Pi OS Lite users: +Next, download a local copy of the `libepoxy` repository from GitHub: +[source,console] ---- -meson setup build -Denable_libav=false -Denable_drm=true -Denable_egl=false -Denable_qt=false -Denable_opencv=false -Denable_tflite=false +$ git clone https://github.com/anholt/libepoxy.git ---- -In both cases, consider `-Dneon_flags=armv8-neon` if you are using a 32-bit OS on a Raspberry Pi 3 or Raspberry Pi 4. Consider `-Denable_opencv=true` if you have installed OpenCV and wish to use OpenCV-based post-processing stages. Finally also consider `-Denable_tflite=true` if you have installed TensorFlow Lite and wish to use it in post-processing stages. +Navigate into the root directory of the repository: -After executing the `meson setup` command of your choice, the whole process concludes with the following: +[source,console] +---- +$ cd libepoxy +---- + +Create a build directory at the root level of the repository, then navigate into that directory: + +[source,console] +---- +$ mkdir _build +$ cd _build +---- + +Next, run `meson` to configure the build environment: +[source,console] ---- -meson compile -C build # use -j1 on Raspberry Pi 3 or earlier devices -sudo meson install -C build -sudo ldconfig # this is only necessary on the first build +$ meson ---- -NOTE: If you are using an image where `rpicam-apps` have been previously installed as an `apt` package, and you want to run the new `rpicam-apps` executables from the same terminal window where you have just built and installed them, you may need to run `hash -r` to be sure to pick up the new executables over the system supplied ones. +Now, you can build `libexpoxy` with `ninja`: -Finally, if you have not already done so, please be sure to follow the `dtoverlay` and display driver instructions in the xref:camera_software.adoc#getting-started[Getting Started section] (and rebooting if you changed anything there). +[source,console] +---- +$ ninja +---- + +Finally, run the following command to install your freshly-built `libepoxy` binary: + +[source,console] +---- +$ sudo ninja install +---- diff --git a/documentation/asciidoc/computers/camera/rpicam_apps_packages.adoc b/documentation/asciidoc/computers/camera/rpicam_apps_packages.adoc index 3229ed554d..2652445a47 100644 --- a/documentation/asciidoc/computers/camera/rpicam_apps_packages.adoc +++ b/documentation/asciidoc/computers/camera/rpicam_apps_packages.adoc @@ -1,12 +1,12 @@ === `libcamera` and `rpicam-apps` packages -A number of `apt` packages are provided for convenience. In order to access them, we recommend keeping your OS up to date xref:../computers/os.adoc#using-apt[in the usual way]. +Raspberry Pi OS provides a number of `apt` packages for convenience. In order to access them, we recommend xref:../computers/os.adoc#using-apt[keeping your OS up to date]. ==== Binary packages There are two `rpicam-apps` packages available, containing the necessary executables: -* `rpicam-apps` contains the full applications with support for previews using a desktop environment. This package is pre-installed in Raspberry Pi OS. +* `rpicam-apps` contains full applications with support for previews using a desktop environment. This package is pre-installed in Raspberry Pi OS. * `rpicam-apps-lite` omits desktop environment support, and only makes the DRM preview available. This package is pre-installed in Raspberry Pi OS Lite. @@ -22,10 +22,4 @@ These will be installed automatically when needed. ==== Dev packages -`rpicam-apps` can be rebuilt on their own without installing and building `libcamera` and `libepoxy` from scratch. To enable this, the following packages should be installed: - -* `libcamera-dev` contains the necessary `libcamera` header files and resources. - -* `libepoxy-dev` contains the necessary `libepoxy` header files and resources. You will only need this if you want support for the GLES/EGL preview window. - -Subsequently `rpicam-apps` can be xref:camera_software.adoc#building-rpicam-apps-without-rebuilding-libcamera[checked out from GitHub and rebuilt]. +You can rebuild `rpicam-apps` without building `libcamera` and `libepoxy` from scratch. For more information, see xref:camera_software.adoc#building-rpicam-apps-without-building-libcamera[Building `rpicam-apps` without rebuilding `libcamera`]. diff --git a/documentation/asciidoc/computers/config_txt/codeclicence.adoc b/documentation/asciidoc/computers/config_txt/codeclicence.adoc index 597553c07a..688591a12f 100644 --- a/documentation/asciidoc/computers/config_txt/codeclicence.adoc +++ b/documentation/asciidoc/computers/config_txt/codeclicence.adoc @@ -2,7 +2,9 @@ Hardware decoding of additional codecs on the Raspberry Pi 3 and earlier models can be enabled by https://codecs.raspberrypi.com/license-keys/[purchasing a licence] that is locked to the CPU serial number of your Raspberry Pi. -On the Raspberry Pi 4, the hardware codecs for MPEG2 or VC1 are permanently disabled and cannot be enabled even with a licence key; on the Raspberry Pi 4, thanks to its increased processing power compared to earlier models, MPEG2 and VC1 can be decoded in software via applications such as VLC. Therefore, a hardware codec licence key is not needed if you're using a Raspberry Pi 4. +The Raspberry Pi 4 has permanently disabled hardware decoders for MPEG2 and VC1. These codecs cannot be enabled, so a hardware codec licence key is not needed. Software decoding of MPEG2 and VC1 files performs well enough for typical use cases. + +The Raspberry Pi 5 has H.265 (HEVC) hardware decoding. This decoding is enabled by default, so a hardware codec licence key is not needed. === `decode_MPG2` diff --git a/documentation/asciidoc/computers/configuration/external-storage.adoc b/documentation/asciidoc/computers/configuration/external-storage.adoc index b030ca2115..a61fd90ddb 100644 --- a/documentation/asciidoc/computers/configuration/external-storage.adoc +++ b/documentation/asciidoc/computers/configuration/external-storage.adoc @@ -13,53 +13,60 @@ To set up your storage device so that it always mounts to a specific location of You can mount your storage device at a specific folder location. It is conventional to do this within the `/mnt` folder, for example `/mnt/mydisk`. Note that the folder must be empty. Plug the storage device into a USB port on the Raspberry Pi, and list all the disk partitions on the Raspberry Pi using the following command: -+ + +[source,console] ---- - sudo lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL,MODEL +$ sudo lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL,MODEL ---- -+ + The Raspberry Pi uses mount points `/` and `/boot/firmware/`. Your storage device will show up in this list, along with any other connected storage. Use the SIZE, LABEL, and MODEL columns to identify the name of the disk partition that points to your storage device. For example, `sda1`. The FSTYPE column contains the filesystem type. If your storage device uses an exFAT file system, install the exFAT driver: -+ + +[source,console] ---- - sudo apt update - sudo apt install exfat-fuse +$ sudo apt update +$ sudo apt install exfat-fuse ---- If your storage device uses an NTFS file system, you will have read-only access to it. If you want to write to the device, you can install the ntfs-3g driver: -+ + +[source,console] ---- - sudo apt update - sudo apt install ntfs-3g +$ sudo apt update +$ sudo apt install ntfs-3g ---- Run the following command to get the location of the disk partition: -+ + +[source,console] ---- - sudo blkid +$ sudo blkid ---- -+ + For example, `/dev/sda1`. Create a target folder to be the mount point of the storage device. The mount point name used in this case is `mydisk`. You can specify a name of your choice: -+ + +[source,console] ---- - sudo mkdir /mnt/mydisk +$ sudo mkdir /mnt/mydisk ---- Mount the storage device at the mount point you created: -+ + +[source,console] ---- - sudo mount /dev/sda1 /mnt/mydisk +$ sudo mount /dev/sda1 /mnt/mydisk ---- Verify that the storage device is mounted successfully by listing the contents: -+ + +[source,console] ---- - ls /mnt/mydisk +$ ls /mnt/mydisk ---- === Setting up automatic mounting @@ -67,23 +74,26 @@ Verify that the storage device is mounted successfully by listing the contents: You can modify the `fstab` file to define the location where the storage device will be automatically mounted when the Raspberry Pi starts up. In the `fstab` file, the disk partition is identified by the universally unique identifier (UUID). Get the UUID of the disk partition: -+ + +[source,console] ---- - sudo blkid +$ sudo blkid ---- Find the disk partition from the list and note the UUID. (For example, `5C24-1453`.) Open the fstab file using a command line editor such as nano: -+ + +[source,console] ---- - sudo nano /etc/fstab +$ sudo nano /etc/fstab ---- Add the following line in the `fstab` file: -+ + +[source,console] ---- - UUID=5C24-1453 /mnt/mydisk fstype defaults,auto,users,rw,nofail 0 0 +$ UID=5C24-1453 /mnt/mydisk fstype defaults,auto,users,rw,nofail 0 0 ---- -+ + Replace `fstype` with the type of your file system, which you found when you went through the steps above, for example: `ntfs`. If the filesystem type is FAT or NTFS, add `,umask=000` immediately after `nofail` - this will allow all users full read/write access to every file on the storage device. @@ -98,8 +108,9 @@ For more information on each Linux command, refer to the specific manual page us When the Raspberry Pi shuts down, the system takes care of unmounting the storage device so that it is safe to unplug it. If you want to manually unmount a device, you can use the following command: +[source,console] ---- -sudo umount /mnt/mydisk +$ sudo umount /mnt/mydisk ---- If you receive an error that the 'target is busy', this means that the storage device was not unmounted. If no error was displayed, you can now safely unplug the device. @@ -111,14 +122,16 @@ The 'target is busy' message means there are files on the storage device that ar Close any program which has open files on the storage device. If you have a terminal open, make sure that you are not in the folder where the storage device is mounted, or in a sub-folder of it. If you are still unable to unmount the storage device, you can use the `lsof` tool to check which program has files open on the device. You need to first install `lsof` using `apt`: -+ + +[source,console] ---- - sudo apt update - sudo apt install lsof +$ sudo apt update +$ sudo apt install lsof ---- -+ + To use lsof: -+ + +[source,console] ---- - lsof /mnt/mydisk +$ lsof /mnt/mydisk ---- diff --git a/documentation/asciidoc/computers/getting-started/setting-up.adoc b/documentation/asciidoc/computers/getting-started/setting-up.adoc index d917017e43..eeb2c9476d 100644 --- a/documentation/asciidoc/computers/getting-started/setting-up.adoc +++ b/documentation/asciidoc/computers/getting-started/setting-up.adoc @@ -123,6 +123,8 @@ Raspberry Pi models have the following display connectivity: |mini HDMI |=== +NOTE: No Raspberry Pi models support video over USB-C (DisplayPort alt mode). + Most displays don't have micro or mini HDMI ports. However, you can use a https://www.raspberrypi.com/products/micro-hdmi-to-standard-hdmi-a-cable/[micro-HDMI-to-HDMI cable] or https://www.raspberrypi.com/products/standard-hdmi-a-male-to-mini-hdmi-c-male-cable/[mini-HDMI-to-HDMI cable] to connect those ports on your Raspberry Pi to any HDMI display. For displays that don't support HDMI, consider an adapter that translates display output from HDMI to a port supported by your display. image::images/peripherals/cable-hdmi.png[alt="Plugging a micro HDMI cable into a Raspberry Pi."] diff --git a/documentation/asciidoc/computers/raspberry-pi/frequency-management.adoc b/documentation/asciidoc/computers/raspberry-pi/frequency-management.adoc index 83fad12b5f..58972b2b2f 100644 --- a/documentation/asciidoc/computers/raspberry-pi/frequency-management.adoc +++ b/documentation/asciidoc/computers/raspberry-pi/frequency-management.adoc @@ -77,8 +77,6 @@ Temperature decreases use the same mapping with a 5°C **hysteresis**; fan speed At boot the fan is turned on, and the tachometer input is checked to see if the fan is spinning. If it is, then the `cooling_fan` device tree overlay is enabled. This overlay is in `bcm2712-rpi-5-b.dtb` by default, but with `status=disabled`. -INFO: Both fan options use the Coolcox https://www.coolcox.com/products/pdf/CC3007.pdf[CC3007H05S] part. - ==== Fan connector pinout The fan connector is a 1mm pitch JST-SH socket containing the following four pins: diff --git a/documentation/asciidoc/computers/remote-access/vnc.adoc b/documentation/asciidoc/computers/remote-access/vnc.adoc index dbef6aa615..3d89f430e5 100644 --- a/documentation/asciidoc/computers/remote-access/vnc.adoc +++ b/documentation/asciidoc/computers/remote-access/vnc.adoc @@ -12,13 +12,11 @@ Raspberry Pi OS includes https://github.com/any1/wayvnc[wayvnc]. This provides a Before you can use VNC on your Raspberry Pi, you must enable the VNC server. -NOTE: Previous versions of Raspberry Pi OS supported client connections from RealVNC. In Raspberry Pi OS _Bookworm_ or later, RealVNC is no longer supported. Instead, you can connect using TigerVNC. - === Enable the VNC server Raspberry Pi OS supports enabling the VNC server both graphically and at the command line. -TIP: Once enabled, you can access your WayVNC configuration at `~/.config/wayvnc/`. +TIP: Once enabled, you can access your WayVNC configuration at `/etc/wayvnc/`. ==== Enable VNC Server Graphically @@ -58,8 +56,8 @@ sudo raspi-config To connect to your Raspberry Pi, you'll need the following: -* your Raspberry Pi and the device running the VNC client must be connected to the same network (e.g. a home wireless network) -* the IP address of your Raspberry Pi +* your Raspberry Pi and the device running the VNC client, connected to the same network (e.g. a home wireless network or VPN) +* the hostname or IP address of your Raspberry Pi * a valid username and password combination for an account on your Raspberry Pi If you don't know the IP address of your device, see xref:remote-access.adoc#ip-address[our instructions on finding your IP address].