From fcdad57f079c9792f1332354f43c3346320b99ac Mon Sep 17 00:00:00 2001 From: Maximilian Weigand Date: Sat, 25 Jan 2025 13:05:31 +0100 Subject: [PATCH 1/5] PineNote: Getting Started: Minor text rework --- .../documentation/PineNote/Getting_started.md | 39 ++++++++++++------- 1 file changed, 26 insertions(+), 13 deletions(-) diff --git a/content/documentation/PineNote/Getting_started.md b/content/documentation/PineNote/Getting_started.md index ae3a4e28..5b84e49b 100644 --- a/content/documentation/PineNote/Getting_started.md +++ b/content/documentation/PineNote/Getting_started.md @@ -12,21 +12,30 @@ menu: ## Important note for buyers after October 2024 {{< admonition type="note" >}} -Dear new PineNote users, you may have noticed that suspend/resume is not working on your new PineNote! You may also noticed that using rkdeveloptool is not possible because you cannot trigger maskrom mode using the magnet method. +Dear new PineNote users, you may have noticed that suspend/resume is not +working on your new PineNote! You may also noticed that using rkdeveloptool is +not possible because you cannot trigger maskrom mode using the magnet method. -These issues are caused by differences in testing procedures of the shipped Debian-based image, and factory flashing procedures. Namely, the factory used a Windows-based flashing system, and it turned out that this system does overwrite crucial parts of the u-boot bootloader with same only-partially working data. The effect is that the PineNote will boot, but not suspend. +These issues are caused by differences in testing procedures of the shipped +Debian-based image, and factory flashing procedures. Namely, the factory used a +Windows-based flashing system, and it turned out that this system does +overwrite crucial parts of the u-boot bootloader with same only-partially +working data. The effect is that the PineNote will boot, but not suspend. ### Fixing the issue -Fortunately the PineNote ships with a complete set of bootloader files and fixing the issue is a matter of a few shell commands:, which are flashing a working U-Boot to get MASKROM with magnet working on PineNote: +Fortunately the PineNote ships with a complete set of bootloader files and +fixing the issue is a matter of a few shell commands:, which are flashing a +working U-Boot to get MASKROM with magnet working on PineNote: -1. Login via UART-adapter or ssh, or use the Gnome-Terminal (found in the quick slots of the dashboard - - switch to BW+Dithering mode for faster screen responses): +1. Login via UART-adapter or ssh, or use the Gnome-Terminal (found in the quick + slots of the dashboard - switch to BW+Dithering mode for faster screen + responses): * username: `user` * password: `1234` - + 2. Gain root access by executing `sudo su - root` (the password is: `1234`). - + 3. Execute the following (two) commands (as root): ```console @@ -34,10 +43,11 @@ cd /root/uboot bash install_stable_1056mhz_uboot.sh ``` - + 4. Turn off the PineNote by executing `init 0` - -5. Done. The pinenote should now have a proper U-Boot installed, with rkdeveloptool-support and suspend. + +5. Done. The pinenote should now have a proper U-Boot installed, with + rkdeveloptool-support and suspend. --- @@ -64,11 +74,12 @@ Included in the box are: * **PineNote** * **Stylus** * **USB-C to USB-A cable** -* **USB-C to Micro-USB cable** - specifically for the stylus +* (only pre 2024 PineNotes) **USB-C to Micro-USB cable** - specifically for the + stylus * **UART Dongle** - for [UART](/documentation/PineNote/Development/UART/) connectivity * **Foldable cover** -## Applying the foldable cover +## Installing the foldable cover The foldable cover can be applied to the PineNote in these simple steps: @@ -80,6 +91,8 @@ The foldable cover can be applied to the PineNote in these simple steps: ![Step 2: The black adhesive strip should now be exposed](/documentation/PineNote/images/step2.png) -**Step 3:** Carefully place the PineNote on top of the side with the adhesive strip, ensuring that the corners and edges are properly aligned with the device. +**Step 3:** Carefully place the PineNote on top of the side with the adhesive +strip, ensuring that the corners and edges are properly aligned with the +device. ![Step 3: Align the PineNote and then place it on top of the stip.](/documentation/PineNote/images/step3.png) \ No newline at end of file From fd2eacb80a1f317c65aebd7569c17ce455c8f265 Mon Sep 17 00:00:00 2001 From: Maximilian Weigand Date: Sat, 25 Jan 2025 13:08:01 +0100 Subject: [PATCH 2/5] PineNote: Releases: Minor text reformatting --- content/documentation/PineNote/Releases.md | 38 +++++++++++++++++----- 1 file changed, 29 insertions(+), 9 deletions(-) diff --git a/content/documentation/PineNote/Releases.md b/content/documentation/PineNote/Releases.md index a686fa34..a000db00 100644 --- a/content/documentation/PineNote/Releases.md +++ b/content/documentation/PineNote/Releases.md @@ -13,13 +13,19 @@ The following releases are available for the [PineNote](/documentation/PineNote) ## Debian -* A full GNOME-enabled rootfs/disc image is provided under [m-weigand/pinenote-debian-recipes/releases](https://github.com/m-weigand/pinenote-debian-recipes/releases). This image can be flashed using rkdeveloptool. +* A full GNOME-enabled rootfs/disc image is provided under + [m-weigand/pinenote-debian-recipes/releases](https://github.com/m-weigand/pinenote-debian-recipes/releases). + This image can be flashed using rkdeveloptool. {{< admonition type="note" >}} - Check the [dev](https://github.com/m-weigand/pinenote-debian-recipes/tree/dev) branch and github actions artifacts (possibly requires github login) for builds newer than the latest release. + Check the [trixie](https://github.com/m-weigand/pinenote-debian-recipes/tree/trixie) + branch and github actions artifacts (possibly requires github login) for + builds newer than the latest release. {{< /admonition >}} -* A Debian-based minimalistic rootfs/disc image can be built using `debos` using the work from [Eugen Răhăian](https://salsa.debian.org/eugenrh). The GNOME image above is building on this work. +* A Debian-based minimalistic rootfs/disc image can be built using `debos` + using the work from [Eugen Răhăian](https://salsa.debian.org/eugenrh). The + GNOME image above is building on this work. ## Alpine @@ -45,21 +51,35 @@ The following releases are targeted towards experienced developers. * [RK3566 EBC Reverse-Engineering](/documentation/General/RK3566_EBC_reverse-engineering) for the EBC (eInk Panel) driver. * [PineNote Development/Building Kernel](/documentation/PineNote/Development/Building_kernel) * BSP Linux SDK version 4.19 for the PineNote and [Quartz64 Model A](/documentation/Quartz64): - * [Direct download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz) from _pine64.org_ (32.67GB, MD5 of the TAR-GZip file _24554419aec29700add97167a3a4c9ed_) + * [Direct + download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz) + from _pine64.org_ (32.67GB, MD5 of the TAR-GZip file + _24554419aec29700add97167a3a4c9ed_) * [Mirror by mwfc](https://tmp.mwfc.info/pinenote/QUARTZ64-model-A_BSP%20Linux.tar.gz) - * An unofficial torrent download provided by a community member of the BSP Linux and Android SDKs can be found [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) (100GB). + * An unofficial torrent download provided by a community member of the BSP + Linux and Android SDKs can be found + [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) + (100GB). ### Android -Android 11 e-ink SDK for the PineNote and Quartz64 Model A. This is the Android SDK build for 10.3" eink panels on Quartz64 Model A. +Android 11 e-ink SDK for the PineNote and Quartz64 Model A. This is the Android +SDK build for 10.3" eink panels on Quartz64 Model A. Download: -* [Direct download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz) from _pine64.org_ (72.88GB, MD5 of the TAR-GZip file _293a550584298de4fb95ceae18103672_) +* [Direct + download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz) + from _pine64.org_ (72.88GB, MD5 of the TAR-GZip file + _293a550584298de4fb95ceae18103672_) * [Mirror by mwfc](https://tmp.mwfc.info/pinenote/QUARTZ64-model-A_eink.android11_SDK.tar.gz) -* An unofficial torrent download provided by a community member of the BSP Linux and Android SDKs can be found [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) (100GB). +* An unofficial torrent download provided by a community member of the BSP + Linux and Android SDKs can be found + [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) + (100GB). * Just the boot blobs (<1MB): https://wiki.pine64.org/wiki/File:Rk35-blobs.tar.gz Notes: -* View [Android SDK for RK3566](/documentation/General/Android_SDK_for_RK3566) for more information how to compile an image for the PineNote using this SDK \ No newline at end of file +* View [Android SDK for RK3566](/documentation/General/Android_SDK_for_RK3566) + for more information how to compile an image for the PineNote using this SDK \ No newline at end of file From 16bb445d1a1c38d1dc5fdc89bbe9604805b6ce8b Mon Sep 17 00:00:00 2001 From: Maximilian Weigand Date: Tue, 28 Jan 2025 08:43:48 +0100 Subject: [PATCH 3/5] PineNote: Releases: Add some summarising information on factory linux images for batch-2 PineNotes, as well as shipped the kernel --- content/documentation/PineNote/Releases.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/documentation/PineNote/Releases.md b/content/documentation/PineNote/Releases.md index a000db00..d83bb603 100644 --- a/content/documentation/PineNote/Releases.md +++ b/content/documentation/PineNote/Releases.md @@ -11,6 +11,24 @@ menu: The following releases are available for the [PineNote](/documentation/PineNote). +## Factory-installed Images + +### Summary + +* Pre-2024 PineNotes were not shipped with a working linux installation. +* Batch-2 PineNotes that started selling in October 2024 were shipped with the + community-maintained, Debian-based, Linux image found here: + [https://github.com/PNDeb/pinenote-debian-image](https://github.com/PNDeb/pinenote-debian-image). + + While the factory-flashed image cannot be freely distributed due to unclear + distribution rights of the waveform, OS files without the shipped waveforms + can be found in this release and a basically equivalent to the shipped + images: + https://github.com/PNDeb/pinenote-debian-image/releases/tag/batch-2-factory-image-wo-waveform +* Parts of the batch-2 PineNotes will be flashed with an updated OS version. + Notes regarding differentiating between factory OS versions will be made + available here in time. + ## Debian * A full GNOME-enabled rootfs/disc image is provided under @@ -48,6 +66,8 @@ The following releases are targeted towards experienced developers. ### Linux Kernel +* Batch-2 PineNotes ares shipped with kernels maintained here + [https://github.com/m-weigand/linux](https://github.com/m-weigand/linux). * [RK3566 EBC Reverse-Engineering](/documentation/General/RK3566_EBC_reverse-engineering) for the EBC (eInk Panel) driver. * [PineNote Development/Building Kernel](/documentation/PineNote/Development/Building_kernel) * BSP Linux SDK version 4.19 for the PineNote and [Quartz64 Model A](/documentation/Quartz64): From 8169f8ede2c0946066297c6531a312e2d7cd8ee6 Mon Sep 17 00:00:00 2001 From: x1y <23239177+x1y@users.noreply.github.com> Date: Tue, 28 Jan 2025 18:39:15 +0000 Subject: [PATCH 4/5] Removed line breaks from Getting_started.md --- .../documentation/PineNote/Getting_started.md | 30 +++++-------------- 1 file changed, 8 insertions(+), 22 deletions(-) diff --git a/content/documentation/PineNote/Getting_started.md b/content/documentation/PineNote/Getting_started.md index 5b84e49b..aabaf2f9 100644 --- a/content/documentation/PineNote/Getting_started.md +++ b/content/documentation/PineNote/Getting_started.md @@ -12,25 +12,15 @@ menu: ## Important note for buyers after October 2024 {{< admonition type="note" >}} -Dear new PineNote users, you may have noticed that suspend/resume is not -working on your new PineNote! You may also noticed that using rkdeveloptool is -not possible because you cannot trigger maskrom mode using the magnet method. +Dear new PineNote users, you may have noticed that suspend/resume is not working on your new PineNote! You may also noticed that using rkdeveloptool is not possible because you cannot trigger maskrom mode using the magnet method. -These issues are caused by differences in testing procedures of the shipped -Debian-based image, and factory flashing procedures. Namely, the factory used a -Windows-based flashing system, and it turned out that this system does -overwrite crucial parts of the u-boot bootloader with same only-partially -working data. The effect is that the PineNote will boot, but not suspend. +These issues are caused by differences in testing procedures of the shipped Debian-based image, and factory flashing procedures. Namely, the factory used a Windows-based flashing system, and it turned out that this system does overwrite crucial parts of the u-boot bootloader with same only-partially working data. The effect is that the PineNote will boot, but not suspend. ### Fixing the issue -Fortunately the PineNote ships with a complete set of bootloader files and -fixing the issue is a matter of a few shell commands:, which are flashing a -working U-Boot to get MASKROM with magnet working on PineNote: +Fortunately the PineNote ships with a complete set of bootloader files and fixing the issue is a matter of a few shell commands:, which are flashing a working U-Boot to get MASKROM with magnet working on PineNote: -1. Login via UART-adapter or ssh, or use the Gnome-Terminal (found in the quick - slots of the dashboard - switch to BW+Dithering mode for faster screen - responses): +1. Login via UART-adapter or ssh, or use the Gnome-Terminal (found in the quick slots of the dashboard - switch to BW+Dithering mode for faster screen responses): * username: `user` * password: `1234` @@ -46,8 +36,7 @@ bash install_stable_1056mhz_uboot.sh 4. Turn off the PineNote by executing `init 0` -5. Done. The pinenote should now have a proper U-Boot installed, with - rkdeveloptool-support and suspend. +5. Done. The pinenote should now have a proper U-Boot installed, with rkdeveloptool-support and suspend. --- @@ -74,8 +63,7 @@ Included in the box are: * **PineNote** * **Stylus** * **USB-C to USB-A cable** -* (only pre 2024 PineNotes) **USB-C to Micro-USB cable** - specifically for the - stylus +* (only pre 2024 PineNotes) **USB-C to Micro-USB cable** - specifically for the stylus * **UART Dongle** - for [UART](/documentation/PineNote/Development/UART/) connectivity * **Foldable cover** @@ -91,8 +79,6 @@ The foldable cover can be applied to the PineNote in these simple steps: ![Step 2: The black adhesive strip should now be exposed](/documentation/PineNote/images/step2.png) -**Step 3:** Carefully place the PineNote on top of the side with the adhesive -strip, ensuring that the corners and edges are properly aligned with the -device. +**Step 3:** Carefully place the PineNote on top of the side with the adhesive strip, ensuring that the corners and edges are properly aligned with the device. -![Step 3: Align the PineNote and then place it on top of the stip.](/documentation/PineNote/images/step3.png) \ No newline at end of file +![Step 3: Align the PineNote and then place it on top of the stip.](/documentation/PineNote/images/step3.png) From dabac736f5dbceceefa27e3018b63329aca2f400 Mon Sep 17 00:00:00 2001 From: x1y <23239177+x1y@users.noreply.github.com> Date: Tue, 28 Jan 2025 18:42:49 +0000 Subject: [PATCH 5/5] Removed line breaks from Releases.md --- content/documentation/PineNote/Releases.md | 57 +++++----------------- 1 file changed, 13 insertions(+), 44 deletions(-) diff --git a/content/documentation/PineNote/Releases.md b/content/documentation/PineNote/Releases.md index d83bb603..6148af07 100644 --- a/content/documentation/PineNote/Releases.md +++ b/content/documentation/PineNote/Releases.md @@ -16,34 +16,19 @@ The following releases are available for the [PineNote](/documentation/PineNote) ### Summary * Pre-2024 PineNotes were not shipped with a working linux installation. -* Batch-2 PineNotes that started selling in October 2024 were shipped with the - community-maintained, Debian-based, Linux image found here: - [https://github.com/PNDeb/pinenote-debian-image](https://github.com/PNDeb/pinenote-debian-image). - - While the factory-flashed image cannot be freely distributed due to unclear - distribution rights of the waveform, OS files without the shipped waveforms - can be found in this release and a basically equivalent to the shipped - images: - https://github.com/PNDeb/pinenote-debian-image/releases/tag/batch-2-factory-image-wo-waveform -* Parts of the batch-2 PineNotes will be flashed with an updated OS version. - Notes regarding differentiating between factory OS versions will be made - available here in time. +* Batch-2 PineNotes that started selling in October 2024 were shipped with the community-maintained, Debian-based, Linux image found here: [https://github.com/PNDeb/pinenote-debian-image](https://github.com/PNDeb/pinenote-debian-image). +* While the factory-flashed image cannot be freely distributed due to unclear distribution rights of the waveform, OS files without the shipped waveforms can be found in this release and a basically equivalent to the shipped images: https://github.com/PNDeb/pinenote-debian-image/releases/tag/batch-2-factory-image-wo-waveform +* Parts of the batch-2 PineNotes will be flashed with an updated OS version. Notes regarding differentiating between factory OS versions will be made available here in time. ## Debian -* A full GNOME-enabled rootfs/disc image is provided under - [m-weigand/pinenote-debian-recipes/releases](https://github.com/m-weigand/pinenote-debian-recipes/releases). - This image can be flashed using rkdeveloptool. +* A full GNOME-enabled rootfs/disc image is provided under [m-weigand/pinenote-debian-recipes/releases](https://github.com/m-weigand/pinenote-debian-recipes/releases). This image can be flashed using rkdeveloptool. {{< admonition type="note" >}} - Check the [trixie](https://github.com/m-weigand/pinenote-debian-recipes/tree/trixie) - branch and github actions artifacts (possibly requires github login) for - builds newer than the latest release. +Check the [trixie](https://github.com/m-weigand/pinenote-debian-recipes/tree/trixie) branch and github actions artifacts (possibly requires github login) for builds newer than the latest release. {{< /admonition >}} -* A Debian-based minimalistic rootfs/disc image can be built using `debos` - using the work from [Eugen Răhăian](https://salsa.debian.org/eugenrh). The - GNOME image above is building on this work. +* A Debian-based minimalistic rootfs/disc image can be built using `debos` using the work from [Eugen Răhăian](https://salsa.debian.org/eugenrh). The GNOME image above is building on this work. ## Alpine @@ -57,7 +42,6 @@ See https://github.com/DorianRudolph/pinenotes#arch-linux See https://wiki.postmarketos.org/wiki/PINE64_PineNote_(pine64-pinenote) - ## Development {{< admonition type="warning" >}} @@ -66,40 +50,25 @@ The following releases are targeted towards experienced developers. ### Linux Kernel -* Batch-2 PineNotes ares shipped with kernels maintained here - [https://github.com/m-weigand/linux](https://github.com/m-weigand/linux). +* Batch-2 PineNotes ares shipped with kernels maintained here [https://github.com/m-weigand/linux](https://github.com/m-weigand/linux). * [RK3566 EBC Reverse-Engineering](/documentation/General/RK3566_EBC_reverse-engineering) for the EBC (eInk Panel) driver. * [PineNote Development/Building Kernel](/documentation/PineNote/Development/Building_kernel) * BSP Linux SDK version 4.19 for the PineNote and [Quartz64 Model A](/documentation/Quartz64): - * [Direct - download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz) - from _pine64.org_ (32.67GB, MD5 of the TAR-GZip file - _24554419aec29700add97167a3a4c9ed_) + * [Direct download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_BSP%20Linux.tar.gz) from _pine64.org_ (32.67GB, MD5 of the TAR-GZip file _24554419aec29700add97167a3a4c9ed_) * [Mirror by mwfc](https://tmp.mwfc.info/pinenote/QUARTZ64-model-A_BSP%20Linux.tar.gz) - * An unofficial torrent download provided by a community member of the BSP - Linux and Android SDKs can be found - [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) - (100GB). + * An unofficial torrent download provided by a community member of the BSP Linux and Android SDKs can be found [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) (100GB). ### Android -Android 11 e-ink SDK for the PineNote and Quartz64 Model A. This is the Android -SDK build for 10.3" eink panels on Quartz64 Model A. +Android 11 e-ink SDK for the PineNote and Quartz64 Model A. This is the Android SDK build for 10.3" eink panels on Quartz64 Model A. Download: -* [Direct - download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz) - from _pine64.org_ (72.88GB, MD5 of the TAR-GZip file - _293a550584298de4fb95ceae18103672_) +* [Direct download](https://files.pine64.org/SDK/Quartz64/QUARTZ64-model-A_eink.android11_SDK.tar.gz) from _pine64.org_ (72.88GB, MD5 of the TAR-GZip file _293a550584298de4fb95ceae18103672_) * [Mirror by mwfc](https://tmp.mwfc.info/pinenote/QUARTZ64-model-A_eink.android11_SDK.tar.gz) -* An unofficial torrent download provided by a community member of the BSP - Linux and Android SDKs can be found - [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) - (100GB). +* An unofficial torrent download provided by a community member of the BSP Linux and Android SDKs can be found [here](https://cdn.discordapp.com/attachments/870707390998282292/907726420204208148/pinenote.torrent) (100GB). * Just the boot blobs (<1MB): https://wiki.pine64.org/wiki/File:Rk35-blobs.tar.gz Notes: -* View [Android SDK for RK3566](/documentation/General/Android_SDK_for_RK3566) - for more information how to compile an image for the PineNote using this SDK \ No newline at end of file +* View [Android SDK for RK3566](/documentation/General/Android_SDK_for_RK3566) for more information how to compile an image for the PineNote using this SDK