PineNote - Revision history

Mweigand: /* State of the software */ add warning to remove lightdm in batch-2 PineNotes

2024-12-30T07:29:47Z

State of the software: add warning to remove lightdm in batch-2 PineNotes

← Older revision		Revision as of 07:29, 30 December 2024
Line 6:		Line 6:

	=== State of the software ===		=== State of the software ===
	{{Warning\|For Batch-2 (2024) PineNotes: The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}		{{Warning\|'''For Batch-2 (2024) PineNotes''': The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}

	{{Warning\|For Batch-2 (2024) PineNotes: The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}		{{Warning\|'''For Batch-2 (2024) PineNotes''': The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}

			{{Warning\|'''For Batch-2 (2024) PineNotes''': In order to prevent Gnome from starting after updates, it is recommend to uninstall the lightdm package: <code>sudo apt remove lightdm</code>}}

	The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.		The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.

Mweigand: /* State of the software */ Fix warnings

2024-12-30T07:25:08Z

State of the software: Fix warnings

← Older revision		Revision as of 07:25, 30 December 2024
Line 6:		Line 6:

	=== State of the software ===		=== State of the software ===
	{{Warning:\|For Batch-2 (2024) PineNotes: The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}		{{Warning\|For Batch-2 (2024) PineNotes: The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}

	{{Warning:For Batch-2 (2024) PineNotes: The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}		{{Warning\|For Batch-2 (2024) PineNotes: The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}

	The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.		The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.

Mweigand: /* State of the software */ Add note regarding the /lib64 issue

2024-12-30T07:24:22Z

State of the software: Add note regarding the /lib64 issue

← Older revision		Revision as of 07:24, 30 December 2024
Line 6:		Line 6:

	=== State of the software ===		=== State of the software ===
	{{Warning\|The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}		{{Warning:\|For Batch-2 (2024) PineNotes: The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}

			{{Warning:For Batch-2 (2024) PineNotes: The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}

	The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.		The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.

Mweigand: PineNote: Add link to working kernel

2024-11-26T10:52:55Z

PineNote: Add link to working kernel

← Older revision		Revision as of 10:52, 26 November 2024
Line 37:		Line 37:
	==== Linux Kernel ====		==== Linux Kernel ====

			* If you are looking for a working kernel for the PineNote, please see her: [https://github.com/m-weigand/linux/]
	* [[RK3566 EBC Reverse-Engineering]] for the EBC (eInk Panel) driver.		* [[RK3566 EBC Reverse-Engineering]] for the EBC (eInk Panel) driver.
	* [[PineNote Development/Building Kernel]]		* [[PineNote Development/Building Kernel]]

Mweigand: /* Accessories */

2024-11-26T10:44:22Z

Accessories

← Older revision		Revision as of 10:44, 26 November 2024
Line 147:		Line 147:

	=== Accessories ===		=== Accessories ===
	* Optional EMR pen with magnetic attachment (included in the first production batch)		* Optional EMR pen with magnetic attachment (included in the first production batch, the second batch (2024) ships with a purely passive pen)
	* Optional Cover (included in the first production ~~batch~~)		* Optional Cover (included in the first and second production batches)

	== SoC and Memory Specifications ==		== SoC and Memory Specifications ==

Mweigand: /* Android: Add note that we do not have a working android at the moment*/

2024-11-26T10:43:40Z

Android: Add note that we do not have a working android at the moment

← Older revision		Revision as of 10:43, 26 November 2024
Line 55:		Line 55:

	==== Android ====		==== Android ====

			{{Note\|As of November 2024 there is no working Android build available for the PineNote!}}

	Android 11 e-ink SDK for the PineNote and [[Quartz64\|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\|Quartz64 Model A]. This is the Android SDK build for 10.3" eink panels on Quartz64 Model A.

Mweigand: UART adapter: remove link to debian image and add note regarding asymmetric wiring

2024-11-26T10:40:18Z

UART adapter: remove link to debian image and add note regarding asymmetric wiring

← Older revision		Revision as of 10:40, 26 November 2024
Line 98:		Line 98:
	{{Note\|See main article: [[PineNote Development/UART]]}}		{{Note\|See main article: [[PineNote Development/UART]]}}
	{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}		{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}
			{{Note\|The UART adapter is not symmetrically wired, make sure to orient it with the components oriented towards the screen!}}

	The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to its serial console via USB-C Debug Accessory Mode (DAM) without having to disassemble the device. The factory-installed operating system runs the serial console at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.		The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to its serial console via USB-C Debug Accessory Mode (DAM) without having to disassemble the device. The factory-installed operating system runs the serial console at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.
Line 104:		Line 105:

	The UART dongle is not necessary to flash the PineNote, but is essential if something goes wrong to fix it without having to open the case.		The UART dongle is not necessary to flash the PineNote, but is essential if something goes wrong to fix it without having to open the case.

	~~You can flash premade images with the following links:~~
	* https://github.com/m-weigand/pinenote_uboot_patching_dorians_backup (Note: this creates a U-Boot image to flash, do not worry about idblock.bin on the instructions for the next link)
	* https://github.com/m-weigand/pinenote-debian-recipes/releases/

	== Specification ==		== Specification ==

Dsimic: /* UART Dongle */ Ditto

2024-11-26T07:58:28Z

UART Dongle: Ditto

← Older revision		Revision as of 07:58, 26 November 2024
Line 99:		Line 99:
	{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}		{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}

	The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to its serial console via USB-C Debug Accessory Mode (DAM) without having to ~~open up~~ the device. The factory-installed operating system runs the serial console at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.		The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to its serial console via USB-C Debug Accessory Mode (DAM) without having to disassemble the device. The factory-installed operating system runs the serial console at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.

	It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.		It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.

Dsimic: /* UART Dongle */ Ditto

2024-11-26T07:58:00Z

UART Dongle: Ditto

← Older revision		Revision as of 07:58, 26 November 2024
Line 99:		Line 99:
	{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}		{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}

	The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to a serial ~~port~~ via USB-C Debug Accessory Mode (DAM) without having to open up the device. The factory-installed operating system runs at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.		The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to its serial console via USB-C Debug Accessory Mode (DAM) without having to open up the device. The factory-installed operating system runs the serial console at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.

	It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.		It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.

Dsimic: /* UART Dongle */ Small wording cleanups

2024-11-26T07:57:09Z

UART Dongle: Small wording cleanups

← Older revision		Revision as of 07:57, 26 November 2024
Line 99:		Line 99:
	{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}		{{Warning\|The second PineNote batch, which started shipping during the first half of November 2024, is the last batch that has the USB UART dongle included in the box.}}

	The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to a serial port via USB-C Debug Accessory Mode (DAM) without having to open up the device.		The USB [https://en.wikipedia.org/wiki/Universal_asynchronous_receiver-transmitter UART] dongle delivered with the PineNote allows you to have access to a serial port via USB-C Debug Accessory Mode (DAM) without having to open up the device. The factory-installed operating system runs at the 1,500,000 bps speed, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.
	The factory-installed ~~firmware~~ runs at ~~a baud rate of~~ 1,500,000 bps, 8 data bits and 1 stop bit, no parity, and no flow control. The USB-C male end should go into the PineNote and the female end can be connected with a standard USB-C cable to your computer.

	It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.		It is relatively easy to build your own UART interface with a USB-C breakout board (for example https://www.ebay.com/itm/275407037613), two resistors and a 3.3V USB serial adapter. It is basically just two 1K pull up resistors (R3, R4), the data sheet values of 10K isn't whats on the real hardware, see the [https://files.pine64.org/doc/PineNote/PineNote_USB-C_Console_UART_breakout_board_schematic_v1.0_20210903.pdf schematic]. The pull ups enable the serial output on SBU1 and SBU2 you can use with any 3.3V USB serial adapter.

← Older revision		Revision as of 07:29, 30 December 2024
Line 6:		Line 6:

	=== State of the software ===		=== State of the software ===
	{{Warning\|For Batch-2 (2024) PineNotes: The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}		{{Warning\|'''For Batch-2 (2024) PineNotes''': The version of Debian-based Linux distribution shipped with the second PineNote batch contains a U-Boot build that prevents suspend-to-RAM from working correctly and make entering MaskROM mode using a magnet not possible. This was caused by the unfortunate timing, so the factory ended up installing version of the operating system image that contained these issues. The required fixes are already available in the shipped Linux distribution, but they need to be [https://gist.github.com/m-weigand/efb1bef6097611d327533ab67b76903b installed manually] by the users.}}

	{{Warning\|For Batch-2 (2024) PineNotes: The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}		{{Warning\|'''For Batch-2 (2024) PineNotes''': The Batch 2 operating system is based on Debian Trixie, which is still in development flux. An issue with /lib64 symlinks was encountered for the specific built of the image that ships with the PineNotes of 2024. If you encounter update failures, please take a look at: [https://github.com/PNDeb/pinenote-debian-image/issues/99 this Github issues]}}

			{{Warning\|'''For Batch-2 (2024) PineNotes''': In order to prevent Gnome from starting after updates, it is recommend to uninstall the lightdm package: <code>sudo apt remove lightdm</code>}}

	The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.		The PineNote is based on the Rockchip RK3566 SoC, which was released in 2021. The upstreaming status of the SoC functionality can be found on the [[Quartz64 Development#Upstreaming Status\|Quartz64 development]] wiki page of the Quartz64 single-board computer that uses the same SoC. In the [[PineNote_Development#Kernel_modules_/_mainlining_status\|PineNote development]] wiki page you'll find the items specific to the PineNote.