From 5a00d8ce5a3b4c71916cb1d1def837c88e134ef9 Mon Sep 17 00:00:00 2001 From: alciregi Date: Wed, 20 Mar 2019 22:26:41 +0100 Subject: [PATCH 1/4] Wifi on the Raspberry Pi 3-series devices works out of the box with Fedora 29. --- ..._-installing-fedora-on-a-raspberry-pi.adoc | 25 +------------------ 1 file changed, 1 insertion(+), 24 deletions(-) diff --git a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc index 730216b..7984c89 100644 --- a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc +++ b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc @@ -59,30 +59,7 @@ There are some limitations to the USB bus of the Raspberry Pi hardware as link:h ._Is the onboard Wi-Fi supported on the Raspberry Pi 3?_ -Wi-Fi on the Raspberry Pi 3 and 3+ works in Fedora. - -The drivers required for the onboard WiFi cannot be included in the Fedora ARM image. After Fedora has been installed on a microSD card and Fedora on Raspberry Pi has been booted for the first time, you can install the WiFi drivers using an ethernet internet connection. - -*Raspberry Pi 3* - -. To install support for the onboard WiFi, on a command-line, issue: -+ ----- -$ sudo curl https://fedora.roving-it.com/brcmfmac43430-sdio.txt -o /lib/firmware/brcm/brcmfmac43430-sdio.txt ----- -+ -. Reboot the Raspberry Pi to access the WiFi. - -*Raspberry Pi 3B+* - -. To install support for the onboard WiFi, on a command-line, issue: -+ ----- -$ sudo curl https://fedora.roving-it.com/brcmfmac43455-sdio.txt -o /lib/firmware/brcm/brcmfmac43455-sdio.txt -$ sudo curl https://fedora.roving-it.com/brcmfmac43455-sdio.clm_blob -o /lib/firmware/brcm/brcmfmac43455-sdio.clm_blob ----- -+ -. Reboot the Raspberry Pi to access the WiFi. +Wifi on the Raspberry Pi 3-series devices works out of the box with Fedora 29. *Using Wi-Fi on CLI* From 14273465bc605689b25eb42e6c7b6ebc82ddcc0c Mon Sep 17 00:00:00 2001 From: alciregi Date: Wed, 20 Mar 2019 22:27:34 +0100 Subject: [PATCH 2/4] GPIO is supported with the use of libgpiod and associated bindings and utilities. --- ...asked-questions_-installing-fedora-on-a-raspberry-pi.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc index 7984c89..62d52a1 100644 --- a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc +++ b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc @@ -140,8 +140,9 @@ There's basic support for overlays in u-boot and the Linux kernel but an overlay ._Is GPIO supported?_ -GPIO isn't fully supported due to lack of mapping with the Device Tree overlays. -This is expected be improved in the Fedora 28 cycle and in Fedora 29. +GPIO is supported with the use of libgpiod and associated bindings and utilities. + +RPI.GPIO is not currently supported. ._Is SPI supported?_ From 48add8d369b3df562e16ac5174e85f6222234348 Mon Sep 17 00:00:00 2001 From: alciregi Date: Wed, 20 Mar 2019 22:29:50 +0100 Subject: [PATCH 3/4] FAQ question are now heading 3 instead of italic. This should improve readability. In addition, in raspberry-pi.adoc, I modified [leveloffset=0], because with +1, the FAQ title starts with level heading 3 instad of 2. --- ..._-installing-fedora-on-a-raspberry-pi.adoc | 47 ++++++++++--------- modules/ROOT/pages/raspberry-pi.adoc | 2 +- 2 files changed, 25 insertions(+), 24 deletions(-) diff --git a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc index 62d52a1..8aca770 100644 --- a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc +++ b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc @@ -10,12 +10,13 @@ // The ID is used as an anchor for linking to the module. Avoid changing it after the module has been published to ensure existing links are not broken. [id='reference-material_{context}'] // The `context` attribute enables module reuse. Every module's ID includes {context}, which ensures that the module has a unique ID even if it is reused multiple times in a guide. -= Fedora on Raspberry Pi: Frequently Asked Questions +[[sect-frequently-asked-questions]] +== Fedora on Raspberry Pi: Frequently Asked Questions //In the title of a reference module, include nouns that are used in the body text. For example, "Keyboard shortcuts for ___" or "Command options for ___." This helps readers and search engines find the information quickly. Frequently asked questions regarding what is supported. -._Why do I get a rainbow display when I try and power on my Raspberry Pi?_ +=== Why do I get a rainbow display when I try and power on my Raspberry Pi? Common causes of the rainbow display include: @@ -30,18 +31,18 @@ For instructions about Fedora ARM on Raspberry Pi: * If you try to use Fedora on a Raspberry Pi 1, Raspberry Pi Zero, or a Raspberry Pi model A, you will receive the rainbow display. This occurs because your Raspberry Pi is not supported (ARMv6 SoCs architectures are not supported). -._What desktop environments are supported?_ +=== What desktop environments are supported? All desktops as shipped in Fedora should work and both 2D and 3D graphics work out of the box. There is an open source fully accelerated driver for the Video Core IV GPU. -._Will there be more enhancements to the hardware support?_ +=== Will there be more enhancements to the hardware support? Yes. New enhancements will be delivered by the standard Fedora updates mechanism. New, significant features will be announced by the link:https://fedoramagazine.org/[Fedora Magazine] or the link:http://fedoraplanet.org/[Fedora Planet]. -._What about support for the Raspberry Pi Models A/A+, B/B+ (generation 1), Zero/ZeroW and Compute Module?_ +=== What about support for the Raspberry Pi Models A/A+, B/B+ (generation 1), Zero/ZeroW and Compute Module? These Raspberry Pi models are not supported. @@ -52,12 +53,12 @@ More information can be found at link:https://pignus.computer[the Pignus site]. NOTE: Fedora DOES support the Compute Module 3 based on the same SoC as the Raspberry Pi 3, but *as the previous generation Compute Modules are based on ARMv6 architecture, they are [#.underline]#not supported#*. -._What USB devices are supported on the Raspberry Pi?_ +=== What USB devices are supported on the Raspberry Pi? Most USB-2 compatible devices that are supported in Fedora on other devices. There are some limitations to the USB bus of the Raspberry Pi hardware as link:https://www.raspberrypi.org/documentation/hardware/raspberrypi/usb/README.md[documented here]. -._Is the onboard Wi-Fi supported on the Raspberry Pi 3?_ +=== Is the onboard Wi-Fi supported on the Raspberry Pi 3? Wifi on the Raspberry Pi 3-series devices works out of the box with Fedora 29. @@ -80,43 +81,43 @@ nmcli device wifi connect __$SSID__ --ask + Where: `_$SSID_` is the network identifier (or name). -._Is the onboard Bluetooth supported on the Raspberry Pi 3?_ +=== Is the onboard Bluetooth supported on the Raspberry Pi 3? Bluetooth works and is stable. The device sometimes has a generic bluetooth address but should work without any configuration. -._Does sound work?_ +=== Does sound work? HDMI audio output is included with Fedora, however, the analog port is not yet supported. Audio output using a USB audio interface should work. -._Does the add-on camera work?_ +=== Does the add-on camera work? Not at this time. There is still ongoing work to support this upstream and to add the appropriated media acceleration support. -._Does accelerated media decode work?_ +=== Does accelerated media decode work? No. The upstream kernel does not support the kernel subsystems required for accelerated media decoding. -._Does HDMI-CEC work?_ +=== Does HDMI-CEC work? Yes. Yes. It's supported using the new upstream CEC support. There's a `/dev/cec0` character device, it can be accessed using any application that supports the IR remote using the `rc-cec` keymap in the `v4l-utils` package, there's also a `cec-ctl` utility for use on the command line. -._Is the Raspberry Pi Touch Display supported?_ +=== Is the Raspberry Pi Touch Display supported? Work on the official Raspberry Pi Touch Display is ongoing upstream and initial support is provided in the 4.10 kernel, see: link:https://github.com/anholt/linux/issues/8[GitHub: raspberrypi/linux issues - 7" LCD touchscreen not supported]. Fedora will review any missing pieces for support soon. The touchscreen driver isn't yet released upstream. Support for other displays is not currently planned. -._Is the composite TV out supported?_ +=== Is the composite TV out supported? The composite TV out is not currently supported in a stable Fedora release but the core support is in the 4.10 kernel. There is some missing enabling patches which will be added to the Fedora kernel soon. -._Are the expansion HATs supported?_ +=== Are the expansion HATs supported? The the expansion HATs are not currently supported. @@ -128,35 +129,35 @@ There's also no consensus on the extensions to the dtc (Device Tree Compiler) to The first focus HAT to support will be the official Raspberry Pi Sense HAT. This will be documented using the manual process to build and load the overlay to provide access to the onboard devices as a means of demonstrating how this process works for those wishing to use this manual method in the interim. The link to this documentation will be added here once that is complete. -._The use of config.txt_ +=== The use of config.txt The `config.txt` is only used for basic configuration at the moment. Because of the use of the opensource vc4 GPU driver, most of the video configuration is done by Linux. The configuration of HATs using `config.txt` is unsupported but is being actively developed. -._Are Device Tree Overlays supported?_ +=== Are Device Tree Overlays supported? There's basic support for overlays in u-boot and the Linux kernel but an overlay manager is not supported upstream. -._Is GPIO supported?_ +=== Is GPIO supported? GPIO is supported with the use of libgpiod and associated bindings and utilities. -RPI.GPIO is not currently supported. +RPI.GPIO is not currently supported. -._Is SPI supported?_ +=== Is SPI supported? Yes, basic SPI is supported. -._Is I2C supported?_ +=== Is I2C supported? Yes, basic I2C is supported. -._Is there Raspberry Pi 3 aarch64 support?_ +=== Is there Raspberry Pi 3 aarch64 support? Yes! You can download the aarch64 disk images for the Raspberry Pi 3 link:https://archive.fedoraproject.org/pub/fedora-secondary/releases/[here.] -._How do I use a serial console?_ +=== How do I use a serial console? The serial console is disabled by default on the Raspberry Pi 2 and 3 because it requires the device to run at significantly slower speeds. diff --git a/modules/ROOT/pages/raspberry-pi.adoc b/modules/ROOT/pages/raspberry-pi.adoc index 4cac591..3ae54be 100644 --- a/modules/ROOT/pages/raspberry-pi.adoc +++ b/modules/ROOT/pages/raspberry-pi.adoc @@ -61,7 +61,7 @@ include::{partialsdir}/proc_installing-fedora-on-a-raspberry-pi-for-apple-osx-us include::{partialsdir}/proc_booting-fedora-on-a-raspberry-pi-for-the-first-time.adoc[leveloffset=+1] -include::{partialsdir}/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc[leveloffset=+1] +include::{partialsdir}/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc[leveloffset=0] == Additional Resources From 2966b9d0e4aa021ba7605fa2f3051f6a40df6d9c Mon Sep 17 00:00:00 2001 From: alciregi Date: Mon, 25 Mar 2019 09:18:46 +0100 Subject: [PATCH 4/4] Reverted back headers and leveloffset --- ..._-installing-fedora-on-a-raspberry-pi.adoc | 44 +++++++++---------- modules/ROOT/pages/raspberry-pi.adoc | 2 +- 2 files changed, 23 insertions(+), 23 deletions(-) diff --git a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc index 8aca770..458d6a1 100644 --- a/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc +++ b/modules/ROOT/pages/_partials/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc @@ -11,12 +11,12 @@ [id='reference-material_{context}'] // The `context` attribute enables module reuse. Every module's ID includes {context}, which ensures that the module has a unique ID even if it is reused multiple times in a guide. [[sect-frequently-asked-questions]] -== Fedora on Raspberry Pi: Frequently Asked Questions += Fedora on Raspberry Pi: Frequently Asked Questions //In the title of a reference module, include nouns that are used in the body text. For example, "Keyboard shortcuts for ___" or "Command options for ___." This helps readers and search engines find the information quickly. Frequently asked questions regarding what is supported. -=== Why do I get a rainbow display when I try and power on my Raspberry Pi? +== Why do I get a rainbow display when I try and power on my Raspberry Pi? Common causes of the rainbow display include: @@ -31,18 +31,18 @@ For instructions about Fedora ARM on Raspberry Pi: * If you try to use Fedora on a Raspberry Pi 1, Raspberry Pi Zero, or a Raspberry Pi model A, you will receive the rainbow display. This occurs because your Raspberry Pi is not supported (ARMv6 SoCs architectures are not supported). -=== What desktop environments are supported? +== What desktop environments are supported? All desktops as shipped in Fedora should work and both 2D and 3D graphics work out of the box. There is an open source fully accelerated driver for the Video Core IV GPU. -=== Will there be more enhancements to the hardware support? +== Will there be more enhancements to the hardware support? Yes. New enhancements will be delivered by the standard Fedora updates mechanism. New, significant features will be announced by the link:https://fedoramagazine.org/[Fedora Magazine] or the link:http://fedoraplanet.org/[Fedora Planet]. -=== What about support for the Raspberry Pi Models A/A+, B/B+ (generation 1), Zero/ZeroW and Compute Module? +== What about support for the Raspberry Pi Models A/A+, B/B+ (generation 1), Zero/ZeroW and Compute Module? These Raspberry Pi models are not supported. @@ -53,12 +53,12 @@ More information can be found at link:https://pignus.computer[the Pignus site]. NOTE: Fedora DOES support the Compute Module 3 based on the same SoC as the Raspberry Pi 3, but *as the previous generation Compute Modules are based on ARMv6 architecture, they are [#.underline]#not supported#*. -=== What USB devices are supported on the Raspberry Pi? +== What USB devices are supported on the Raspberry Pi? Most USB-2 compatible devices that are supported in Fedora on other devices. There are some limitations to the USB bus of the Raspberry Pi hardware as link:https://www.raspberrypi.org/documentation/hardware/raspberrypi/usb/README.md[documented here]. -=== Is the onboard Wi-Fi supported on the Raspberry Pi 3? +== Is the onboard Wi-Fi supported on the Raspberry Pi 3? Wifi on the Raspberry Pi 3-series devices works out of the box with Fedora 29. @@ -81,43 +81,43 @@ nmcli device wifi connect __$SSID__ --ask + Where: `_$SSID_` is the network identifier (or name). -=== Is the onboard Bluetooth supported on the Raspberry Pi 3? +== Is the onboard Bluetooth supported on the Raspberry Pi 3? Bluetooth works and is stable. The device sometimes has a generic bluetooth address but should work without any configuration. -=== Does sound work? +== Does sound work? HDMI audio output is included with Fedora, however, the analog port is not yet supported. Audio output using a USB audio interface should work. -=== Does the add-on camera work? +== Does the add-on camera work? Not at this time. There is still ongoing work to support this upstream and to add the appropriated media acceleration support. -=== Does accelerated media decode work? +== Does accelerated media decode work? No. The upstream kernel does not support the kernel subsystems required for accelerated media decoding. -=== Does HDMI-CEC work? +== Does HDMI-CEC work? Yes. Yes. It's supported using the new upstream CEC support. There's a `/dev/cec0` character device, it can be accessed using any application that supports the IR remote using the `rc-cec` keymap in the `v4l-utils` package, there's also a `cec-ctl` utility for use on the command line. -=== Is the Raspberry Pi Touch Display supported? +== Is the Raspberry Pi Touch Display supported? Work on the official Raspberry Pi Touch Display is ongoing upstream and initial support is provided in the 4.10 kernel, see: link:https://github.com/anholt/linux/issues/8[GitHub: raspberrypi/linux issues - 7" LCD touchscreen not supported]. Fedora will review any missing pieces for support soon. The touchscreen driver isn't yet released upstream. Support for other displays is not currently planned. -=== Is the composite TV out supported? +== Is the composite TV out supported? The composite TV out is not currently supported in a stable Fedora release but the core support is in the 4.10 kernel. There is some missing enabling patches which will be added to the Fedora kernel soon. -=== Are the expansion HATs supported? +== Are the expansion HATs supported? The the expansion HATs are not currently supported. @@ -129,35 +129,35 @@ There's also no consensus on the extensions to the dtc (Device Tree Compiler) to The first focus HAT to support will be the official Raspberry Pi Sense HAT. This will be documented using the manual process to build and load the overlay to provide access to the onboard devices as a means of demonstrating how this process works for those wishing to use this manual method in the interim. The link to this documentation will be added here once that is complete. -=== The use of config.txt +== The use of config.txt The `config.txt` is only used for basic configuration at the moment. Because of the use of the opensource vc4 GPU driver, most of the video configuration is done by Linux. The configuration of HATs using `config.txt` is unsupported but is being actively developed. -=== Are Device Tree Overlays supported? +== Are Device Tree Overlays supported? There's basic support for overlays in u-boot and the Linux kernel but an overlay manager is not supported upstream. -=== Is GPIO supported? +== Is GPIO supported? GPIO is supported with the use of libgpiod and associated bindings and utilities. RPI.GPIO is not currently supported. -=== Is SPI supported? +== Is SPI supported? Yes, basic SPI is supported. -=== Is I2C supported? +== Is I2C supported? Yes, basic I2C is supported. -=== Is there Raspberry Pi 3 aarch64 support? +== Is there Raspberry Pi 3 aarch64 support? Yes! You can download the aarch64 disk images for the Raspberry Pi 3 link:https://archive.fedoraproject.org/pub/fedora-secondary/releases/[here.] -=== How do I use a serial console? +== How do I use a serial console? The serial console is disabled by default on the Raspberry Pi 2 and 3 because it requires the device to run at significantly slower speeds. diff --git a/modules/ROOT/pages/raspberry-pi.adoc b/modules/ROOT/pages/raspberry-pi.adoc index 3ae54be..4cac591 100644 --- a/modules/ROOT/pages/raspberry-pi.adoc +++ b/modules/ROOT/pages/raspberry-pi.adoc @@ -61,7 +61,7 @@ include::{partialsdir}/proc_installing-fedora-on-a-raspberry-pi-for-apple-osx-us include::{partialsdir}/proc_booting-fedora-on-a-raspberry-pi-for-the-first-time.adoc[leveloffset=+1] -include::{partialsdir}/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc[leveloffset=0] +include::{partialsdir}/ref_frequently-asked-questions_-installing-fedora-on-a-raspberry-pi.adoc[leveloffset=+1] == Additional Resources