Skip to content

Commit

Permalink
Updated broken links
Browse files Browse the repository at this point in the history
  • Loading branch information
x1y committed Jul 28, 2024
1 parent ec5f596 commit 88e30a3
Show file tree
Hide file tree
Showing 35 changed files with 153 additions and 143 deletions.
6 changes: 3 additions & 3 deletions content/documentation/Introduction/Getting_started.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -36,9 +36,9 @@ The process of flashing PINE64 OS images to micro SD on your Windows, Linux or O

Please refer to the relevant section below for instructions on how to image your microSD card:

* link:#Imaging_microSD_on_Windows_7/8/8.1/10[Imaging microSD on Windows 7/8/8.1/10]
* link:#Imaging_microSD_on_Apple_OSX[Imaging microSD on Apple OSX]
* link:#Imaging_microSD_on_Linux[Imaging microSD on Linux]
* link:#imaging_microsd_on_windows_788_110[Imaging microSD on Windows 7/8/8.1/10]
* link:#imaging_microsd_on_macos[Imaging microSD on macOS]
* link:#imaging_microsd_on_linux[Imaging microSD on Linux]

Having successfully imaged your microSD card, insert it into the microSD slot.

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/PineNote/Development/Apps.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ https://www.youtube.com/watch?v=ZCLyJfbzbrU[Here is a video] showing the perform

==== Getting touch + pen working on sway

If you notice that touching the screen works, but when you use the pen the mouse coordinates are inverted, don't worry! We can fix it! Set `rockchip_ebc.panel_reflection=0` on boot (see link:/documentation/PineNote/Development/Building_kernel#Configuring_the_driver[this page] for more info). Add the following line to your sway config:
If you notice that touching the screen works, but when you use the pen the mouse coordinates are inverted, don't worry! We can fix it! Set `rockchip_ebc.panel_reflection=0` on boot (see link:/documentation/PineNote/Development/Building_kernel#configuring_the_driver[this page] for more info). Add the following line to your sway config:

# This line rotates the mouse input by 180 degrees. See https://wayland.freedesktop.org/libinput/doc/1.11.3/absolute_axes.html
input "type:table_tool" calibration_matrix -1 0 1 0 -1 1
Expand Down
8 changes: 4 additions & 4 deletions content/documentation/PineNote/Development/TODOs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -53,16 +53,16 @@ TODO

=== GNOME Configurations

See link:/documentation/PineNote/Development/Apps#Gnome[here].
See link:/documentation/PineNote/Development/Apps#gnome[here].

=== Sway Configurations

See link:/documentation/PineNote/Development/Apps#Sway[here].
See link:/documentation/PineNote/Development/Apps#sway[here].

== Documentation TODOs

* Pin Mesa Packages so they don't update when we upgrade other packages
** Add the information near step 5 link:/documentation/PineNote/Development/Building_kernel#Steps_to_build[here].
** Add the information near step 5 link:/documentation/PineNote/Development/Building_kernel#steps_to_build[here].
* Control the backlight
* Building alacritty correctly
* Force a screen refresh?
Expand Down Expand Up @@ -112,7 +112,7 @@ This table is a draft for the documentation development page:

| `Bluetooth`
2+| Works, audio stutters
| link:/documentation/PineNote/Development/Building_kernel#Fixing_Bluetooth[Switching the driver] provides stable connections for keyboards, but audio still stutters. Trying to fix this link:/documentation/PineNote/Development/Software_tweaks#Preliminary_fix_for_stuttering_bluetooth_audio[here].
| link:/documentation/PineNote/Development/Building_kernel#fixing_bluetooth[Switching the driver] provides stable connections for keyboards, but audio still stutters. Trying to fix this link:/documentation/PineNote/Development/Software_tweaks#preliminary_fix_for_stuttering_bluetooth_audio[here].

| `Sensors`
2+| Unsure
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/PineNote/Development/_index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ This article seeks to provide general mainline Linux development information for

=== Status

The following table aims to provide a list of kernel modules required for running the PineNote. It also aims at listing repositories of work in progress. While some overlap with the Quartz64 module list (link:/documentation/Quartz64/Development#Upstreaming_Status[Development]) is expected, only modules relevant to the PineNote hardware should be listed here.
The following table aims to provide a list of kernel modules required for running the PineNote. It also aims at listing repositories of work in progress. While some overlap with the Quartz64 module list (link:/documentation/Quartz64/Development#upstreaming_status[Development]) is expected, only modules relevant to the PineNote hardware should be listed here.

[cols="2,1,1,2,6"]
|===
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ menu:
weight: 6
---

For some relevant takeaways from this discussion, see link:/documentation/PineNote/Further_information/Closed_Case_UART#August_15,_2021[PineNote/Hardware Changes/Closed Case UART]

Times are in UTC-5

Logs collected from #pinedev on irc.pine64.org
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/PineNote/Introduction.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ menu:

== State of the software

The PineNote is based on the in 2021 released Rockchip RK3566 SoC. The upstreaming status of the SoC functionality can be found on the link:/documentation/Quartz64/Development#upstreaming_status[Quartz64 development] documentation page of the Quartz64 single-board computer using the same SoC. In the link:/documentation/PineNote/Development#Kernel_modules_/_mainlining_status[PineNote development] documentation page you'll find the items specific for the PineNote.
The PineNote is based on the in 2021 released Rockchip RK3566 SoC. The upstreaming status of the SoC functionality can be found on the link:/documentation/Quartz64/Development#upstreaming_status[Quartz64 development] documentation page of the Quartz64 single-board computer using the same SoC. In the link:/documentation/PineNote/Development/#mainline_development[PineNote development] documentation page you'll find the items specific for the PineNote.

The early adopter's batch of the PineNote is aimed solely at early adopters - more specifically, the units are solely intended to find their way into the hands of users with extensive Linux experience. If you’re looking to buy a PineNote in the first batch, you must expect to write software for it, not to write notes on it. The software shipping from the factory for the first batch will not be suitable for taking notes, reading e-books, or writing your dissertation. It may not even boot to a graphical environment.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,11 +52,11 @@ and executing as root ("sudo su") on the phone:

==== Method 2

Booting a factory test image will automatically flash the ANX7688 chip. See link:/documentation/PinePhone/Software/Releases#Factory_Test_OS[Factory Test OS] for such an image.
Booting a factory test image will automatically flash the ANX7688 chip. See link:/documentation/PinePhone/Software/Releases/#hardware_test_build[Factory Test OS] for such an image.

== Replacing the screen

Before attempting to replace the screen be sure to review the section on link:#Swapping_in_a_new_mainboard_revision[replacing the mainboard] since that will get you most of the way there. Be aware that the replacement screen is actually the entire front frame of the phone and there are components that will need to be swapped from your old screen.
Before attempting to replace the screen be sure to review the section on link:/documentation/PinePhone/Hardware_fixes_and_mods/Modifications_and_repairs/#replacing_the_mainboard[replacing the mainboard] since that will get you most of the way there. Be aware that the replacement screen is actually the entire front frame of the phone and there are components that will need to be swapped from your old screen.

* Make sure you have a precision screwdriver set that has the correct size Philips tip. The screws are very small and the heads can easily be stripped if the screwdriver is not correct - if you feel your screwdriver slipping, stop what you are doing and try one that is a better fit. A magnetized screwdriver will help in not losing screws, as will a magnetic parts holder to keep them in while working.
* There are a number of components and cables as well as the insulator sheet under the battery that are glued in place. A hair dryer will loosen the glue and make them much easier to remove. You may want to order extra cables along with the screen just in case.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,5 +24,5 @@ This page contains resources which are exclusive to the 1.0 revision of the Pine

== Known issues

See link:/documentation/PinePhone/Revisions/PinePhone_v1.1_-_Braveheart#Known_issues[the known issues with v1.1 (Braveheart)], which are all carried forward from v1.0.
See link:/documentation/PinePhone/Revisions/PinePhone_v1.1_-_Braveheart/#known_issues[the known issues with v1.1 (Braveheart)], which are all carried forward from v1.0.

Original file line number Diff line number Diff line change
Expand Up @@ -29,5 +29,5 @@ This page contains information and resources which are specific to the v1.2b rev
== Known issues

* HDMI hotplug detection is not reliable due to a HW bug in level shifting circuitry for the hot plug detect (HPD) signal between HDMI bridge and A64 SoC, see https://xnux.eu/log/#045[megi's blog post].
* It is not known if three issues of previous revisions are still present and if yes to which degree, or if they have been fixed by removing resistor R1318, see link:/documentation/PinePhone/Revisions/PinePhone_v1.2#Backlight[PinePhone v1.2] for some details. Please edit this page once this has been confirmed. Mind that there is currently a likely software-related bug present, which also causes the screen to flicker. The bug usually happens after abruptly shutting down the phone previously (for example by forcing it off), in contrast to powering it off.
* It is not known if three issues of previous revisions are still present and if yes to which degree, or if they have been fixed by removing resistor R1318, see link:/documentation/PinePhone/Revisions/PinePhone_v1.2#backlight[PinePhone v1.2] for some details. Please edit this page once this has been confirmed. Mind that there is currently a likely software-related bug present, which also causes the screen to flicker. The bug usually happens after abruptly shutting down the phone previously (for example by forcing it off), in contrast to powering it off.

Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ The eMMC can be overwritten by booting an image from the microSD card and overwr

This installation method is *recommended*.

. Boot an operating system link:/documentation/PinePhone_Pro/Software/Installation/Installation_to_the_microSD_card/[from the microSD card]. If there is already a bootloader on the eMMC installed see the section link:/documentation/PinePhone_Pro/Software/Boot_order/[Boot order] to bypass it.
. Boot an operating system link:/documentation/PinePhone_Pro/Installation/Installation_to_the_microSD_card/[from the microSD card]. If there is already a bootloader on the eMMC installed see the section link:/documentation/PinePhone_Pro/Software/Boot_order/[Boot order] to bypass it.
. Download or copy the desired image to the microSD card as file
. Check if the eMMC appears under `lsblk`. If it doesn't appear in the output of the command, the eMMC wasn't initialized due to applying the above explained bypass method for a too long time during the boot
. *Important:* Typically the image will be compressed in an archive file to reduce the download size (such as _.gz_ or _.xz_). Extract the image from its archive file to get the file with the file extension _.img_.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -300,7 +300,7 @@ Here are some current consumption statistics (current consumed in addition to th

|BUTTON_OUT left high
|0.04mA
|See link:#Button[Button] for how to avoid this.
|See link:#button[Button] for how to avoid this.

|SPI flash sleep mode
|0.014mA
Expand Down
2 changes: 1 addition & 1 deletion content/documentation/PineTime/Software/InfiniTime.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Link: https://github.com/JF002/InfiniTime/releases/tag/0.8.2[Version 0.8.2]

Bootloader: https://github.com/lupyuen/pinetime-rust-mynewt/releases/tag/v5.0.4.

This new version of the bootloader fixes link:#Black_screen_after_a_reset_in_sleep_mode[Black screen after a reset in sleep mode] and enables the watchdog before launching the firmware.
This new version of the bootloader fixes link:#black_screen_after_a_reset_in_sleep_mode[Black screen after a reset in sleep mode] and enables the watchdog before launching the firmware.

=== Version 0.8.3

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/Pinebook/Software.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Notes:
* Installer offers automatic partitioning and full-disk encryption (LUKS), but only manual partitioning with a single ext4 partition has been confirmed to work.
* Bootloader must be installed separately after installation, before rebooting.
* WiFi driver kernel module must be provided during installation, or a USB network adapter used. (Android USB tethering works, with network driver `rndis_host`).
* See also: Debian Netboot installer on the 1080P Pinebook under link:/documentation/Pinebook_Pro/Software/Releases#Debian[Software releases]
* See also: Debian Netboot installer on the 1080P Pinebook under link:/documentation/Pinebook_Pro/Software/Releases#debian[Software releases]

=== DietPi

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,9 @@ Additionally, it's recommended to use an M.2 SSD that supports four PCI Express

Only PCI Express M.2 drives can work, due to the available connectivity of the Pinebook Pro. Consequently, SATA or USB M.2 cards will not work.

You need to buy and install the M.2 adapter in order to fit one, please see link:/documentation/Pinebook_Pro#Using_the_optional_NVMe_adapter[Pinebook Pro]
You need to buy and install the M.2 adapter in order to fit one, please see link:/documentation/Pinebook_Pro/Guides/Using-the-optional-NVMe-adapter/[Pinebook Pro]

Please see link:/documentation/Pinebook_Pro/Troubleshooting#NVMe_SSD_issues[a separate section] that describes reported issues with the NVMe drives in PineBook Pro.
Please see link:/documentation/Pinebook_Pro/Troubleshooting#nvme_ssd_issues[a separate section] that describes reported issues with the NVMe drives in PineBook Pro.

|===
|Type | Make/Model | Size | Hardware IDs | Result | Notes | Power options (active only) | Save power setting?
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ menu:
weight:
---

Here are a list of the external ports. See link:/documentation/Pinebook_Pro#Expansion_Ports[Technical Reference - Expansion Ports] for port specifications.
Here are a list of the external ports. See link:/documentation/Pinebook_Pro/Further_information/Specifications/#expansion_ports[Technical Reference - Expansion Ports] for port specifications.

* Left side
** Barrel jack for power, (with LED)
Expand Down
6 changes: 3 additions & 3 deletions content/documentation/Pinebook_Pro/Features/Touchpad.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ menu:
weight:
---

Documentation for the touchpad can be found in link:#Datasheets_for_Components_and_Peripherals[Datasheets for Components and Peripherals]. It is the only component of the Pinebook Pro held in place with strong adhesive tape. Here are some of its features:
Documentation for the touchpad can be found in link:/documentation/Pinebook_Pro/Further_information/Datasheets/[Datasheets for Components and Peripherals]. It is the only component of the Pinebook Pro held in place with strong adhesive tape. Here are some of its features:

* 2 actuating buttons.
* multi-touch functionality.
Expand All @@ -26,7 +26,7 @@ If you are having trouble using 2 fingers to scroll or emulate the click of a mo
*. For smooth scrolling and gestures under X-Windows, _Firefox_ should be launched with with the following environment variable assignment:
+
`MOZ_USE_XINPUT2=1`
* Experiment with other settings, via link:#X-Windows_Configuration[X-Windows Configuration] or some other system preferences. For example, you could disable double-finger scrolling, and instead enable scrolling by sliding one finger along the edge of the touchpad.
* Experiment with other settings, via X-Windows Configuration or some other system preferences. For example, you could disable double-finger scrolling, and instead enable scrolling by sliding one finger along the edge of the touchpad.

== Firmware

Expand All @@ -42,7 +42,7 @@ Naturally, forks have begun to appear:

*All Pinebook Pros shipped from the factory have the old buggy version installed so consider updating the keyboard and touchpad firmware with the latest fixes from Dragan.*

WARNING: DO NOT update the touchpad firmware before checking which keyboard IC your Pinebook Pro has. Some Pinebook Pro were delivered with a _SH61F83_ instead of a _SH68F83_. The SH61F83 can only be written 8 times, this will render the keyboard and touchpad unusable if this limit is reached when step 1 (see below) is flashed. See https://reddit.com/r/PINE64official/comments/loq4db/very_disappointed/[Reddit SH61F83 thread]. The keyboard IC corresponds to _U23_ on the link:#Pinebook_Pro_Schematics_and_Certifications[top layer silkscreen of the main board]. It is located under the keyboard flat flexible cable. All the PBPs from the post-pandemic batches have _SH61F83_ but TL Lim claimed they can be flashed just the same. No updated datasheet or a statement from the MCU vendor was provided though, so proceed at your own risk. Experience shows flashing those works for at least one time.
WARNING: DO NOT update the touchpad firmware before checking which keyboard IC your Pinebook Pro has. Some Pinebook Pro were delivered with a _SH61F83_ instead of a _SH68F83_. The SH61F83 can only be written 8 times, this will render the keyboard and touchpad unusable if this limit is reached when step 1 (see below) is flashed. See https://reddit.com/r/PINE64official/comments/loq4db/very_disappointed/[Reddit SH61F83 thread]. The keyboard IC corresponds to _U23_ on the link:/documentation/Pinebook_Pro/Further_information/Schematics_and_certifications/[top layer silkscreen of the main board]. It is located under the keyboard flat flexible cable. All the PBPs from the post-pandemic batches have _SH61F83_ but TL Lim claimed they can be flashed just the same. No updated datasheet or a statement from the MCU vendor was provided though, so proceed at your own risk. Experience shows flashing those works for at least one time.

Before updating _any_ firmware, your Pinebook Pro should be either fully charged or, preferably, running from mains. This utility will be writing data to chips on the keyboard and touchpad, so a loss of power during any stage of the update can result in irrecoverable damage to your touchpad or keyboard.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Many units come with the hinges too stiff from the factory. You can tell if it a

== Display disassembly

It is not recommended to adjust the position of the lid when the bottom cover is removed, because the bottom cover provides structural strength, so the lid should be open fully as the first step, before starting any disassembly of the laptop. After opening the lid, remove the bottom cover by following the instruction found in the section above. Alternatively, you can keep the lid closed and remove the screws that hold the hinges to the main laptop body, as described in link:#Caring_for_the_PineBook_Pro[Pinebook Service Step by Step Guides].
It is not recommended to adjust the position of the lid when the bottom cover is removed, because the bottom cover provides structural strength, so the lid should be open fully as the first step, before starting any disassembly of the laptop. After opening the lid, remove the bottom cover by following the instruction found in the section above. Alternatively, you can keep the lid closed and remove the screws that hold the hinges to the main laptop body, as described in link:/documentation/Pinebook_Pro/Guides/Caring/[Pinebook Service Step by Step Guides].

Parts of the hinge mechanism, as well as the screws that hold the hinges to the lid, are hidden behind an elongated plastic U-shaped cover that snaps in place using latches. Use a dedicated plastic prying tool or a guitar pick to gently pry the cover and remove it, starting from the outer edge. Once you pry the cover to a certain extent, it should be possible to remove it fully using only your hands. The U-shaped cover is rather sturdy, but still be careful not to break or bend it.

Expand Down
Loading

0 comments on commit 88e30a3

Please sign in to comment.