[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
slackwarearm:inst_sa64_cur_rk3399_pinebookpro [2021/12/07 14:04 (UTC)] mozesslackwarearm:inst_sa64_cur_rk3399_pinebookpro [2021/12/09 12:09 (UTC)] mozes
Line 2: Line 2:
  
 <note warning>This document is UNTESTED - it worked, but this author's Pinebook Pro is broken so it's impossible to verify</note> <note warning>This document is UNTESTED - it worked, but this author's Pinebook Pro is broken so it's impossible to verify</note>
 +
 +<note warning>This has some RockPro64 references within the screenshots - these need updating. However, these are cosmetic only.</note>
  
 ====== Installing Slackware on the Pinebook Pro ====== ====== Installing Slackware on the Pinebook Pro ======
Line 8: Line 10:
 | Document name    | inst_sa64_cur_rk3399_pinebookpro | | Document name    | inst_sa64_cur_rk3399_pinebookpro |
 | Document purpose | Document the installation of Slackware Linux onto the Hardware Model: [[https://www.pine64.org/pinebook-pro/|Pinebook Pro]] | | Document purpose | Document the installation of Slackware Linux onto the Hardware Model: [[https://www.pine64.org/pinebook-pro/|Pinebook Pro]] |
 +| Version          | 1.00, Dec 2021 |
 | Author           | Stuart Winter <mozes@slackware> | | Author           | Stuart Winter <mozes@slackware> |
-Date             25-Oct-2021 +Contributors     Brent Earl 
-| Version          | 1.00 |+
  
  
Line 16: Line 19:
 ==== Installation Lifecycle ==== ==== Installation Lifecycle ====
  
-The Installation consists of nine distinct stages:+The Installation consists of a number of stages:
  
   - Acquiring all required hardware   - Acquiring all required hardware
Line 53: Line 56:
 ^ Item ^ Specification ^ Notes ^ ^ Item ^ Specification ^ Notes ^
 | Host Computer: an Internet-connected computer running an existing Linux distribution | Preferably a full installation of Slackware x86/64, but any distribution that can provide the required Python environment and HTTP server module. The Host Computer needs approximately **5GB free storage** to download the required software assets.  **You must be able to obtain //root// access to this Host computer**.  | This will be used to download the Slackware distribution from the Internet, and serve the Pinebook Pro client to install Slackware over the LAN (Local Area Network).  | | Host Computer: an Internet-connected computer running an existing Linux distribution | Preferably a full installation of Slackware x86/64, but any distribution that can provide the required Python environment and HTTP server module. The Host Computer needs approximately **5GB free storage** to download the required software assets.  **You must be able to obtain //root// access to this Host computer**.  | This will be used to download the Slackware distribution from the Internet, and serve the Pinebook Pro client to install Slackware over the LAN (Local Area Network).  |
-| Network DHCP server | Provide an IP address and routing information for the RockPro64 to be able to contact the Linux Host Computer (to download the Slackware tree) and the Internet (to set date via NTP) | This document expects the RockPro64 to be able to obtain an IP address via DHCP over the LAN.  However, you can also manually configure an IP address once the Slackware Installer has booted (note that a lack of DHCP server will stall the Installer by several seconds).  You could also copy the Slackware media to a USB stick and install from there.  This is outside of the scope of this document, however [[https://docs.slackware.com/howtos:network_services:dhcp_server_via_dnsmasq|this document]] describes how to set up a simple DHCP service on Slackware. |+| Network DHCP server | Provide an IP address and routing information for the PinebookPro to be able to contact the Linux Host Computer (to download the Slackware tree) and the Internet (to set date via NTP) | This document expects the PinebookPro to be able to obtain an IP address via DHCP over the LAN.  However, you can also manually configure an IP address once the Slackware Installer has booted (note that a lack of DHCP server will stall the Installer by several seconds).  You could also copy the Slackware media to a USB stick and install from there.  This is outside of the scope of this document, however [[https://docs.slackware.com/howtos:network_services:dhcp_server_via_dnsmasq|this document]] describes how to set up a simple DHCP service on Slackware. |
  
 <note tip>Most home routers equipped with Ethernet ports provide a DHCP server which should suffice for this setup</note> <note tip>Most home routers equipped with Ethernet ports provide a DHCP server which should suffice for this setup</note>
Line 448: Line 451:
   * Assembled the PinebookPro as documented above   * Assembled the PinebookPro as documented above
   * Connected the Docking station   * Connected the Docking station
-  * Connected the Ethernet cable, and have a DHCP server serving the network from which the RockPro64 can obtain an IP address+  * Connected the Ethernet cable, and have a DHCP server serving the network from which the PinebookPro can obtain an IP address
   * Inserted the Micro SD card containing the Slackware Installer into the PinebookPro's MicroSD card slot   * Inserted the Micro SD card containing the Slackware Installer into the PinebookPro's MicroSD card slot
  
Line 455: Line 458:
 <note warning> Disconnect any USB storage devices that aren't required for the OS installation</note>  <note warning> Disconnect any USB storage devices that aren't required for the OS installation</note> 
  
-== Power on the RockPro64 ==+== Power on the PinebookPro ==
  
 Press the Power Button for aproximately two seconds Press the Power Button for aproximately two seconds
Line 463: Line 466:
 {{:slackwarearm:00-u-boot-bootinginstaller.jpg?400|}} {{:slackwarearm:00-u-boot-bootinginstaller.jpg?400|}}
  
-It takes several seconds to load and boot the installer, and it may take several seconds more for any further output to appear on the HDMI monitor.+It takes several seconds to load and boot the installer, and it may take several seconds more for any further output to appear on the screen.
 The process of obtaining an IP address via DHCP can also delay the ability to interact with the Installer. The process of obtaining an IP address via DHCP can also delay the ability to interact with the Installer.
  
Line 482: Line 485:
 == Set the date/time == == Set the date/time ==
  
-Even if you have a battery pack for the RTC (Real Time Clock), the date on your system may be incorrect. +Sync the date from a highly-available NTP server:
-We will sync the date from a highly-available NTP server:+
  
 <code> <code>
Line 500: Line 502:
 Partition  Partition 
  
-^ Partition number ^ Device name ^ Size ^ Purpose ^ +^ Partition number ^ Device name    ^ Size ^ Purpose ^ 
-| 1                | /dev/sda1   | 4GB   | Swap | +| 1                | /dev/nvme0n1p1 | 4GB   | Swap | 
-| 2                | /dev/sda2   | Rest of storage | OS root ('/') partition |+| 2                | /dev/nvme0n2p2 | Rest of storage | OS root ('/') partition |
  
 <note tip>/boot will reside on the Micro SD card and is automatically configured by the Slackware Installer</note> <note tip>/boot will reside on the Micro SD card and is automatically configured by the Slackware Installer</note>
  
-Open fdisk against the /dev/sda partition (which will be your primary storage, and in these instructions is the SDD connected to the USB adapter).+Open fdisk against the /dev/nvme0n1 block device (which will be your primary storage, and in these instructions is the NVME you screwed inside the laptop in the previous section).
  
 <code> <code>
-fdisk /dev/sda+fdisk /dev/nvme0n1
 </code> </code>
  
-{{:slackwarearm:07_-_fdisk-rpro64.jpg?400|}}+
  
 Create the Swap partition: Create the Swap partition:
 +
 +{{:slackwarearm:pinebookpro-fdisk-dev-nvme0n1.jpg?400|}}
  
 Type 'n' for new partition: Type 'n' for new partition:
- 
-{{:slackwarearm:08_-_fdisk-rpro64.jpg?400|}} 
  
 Type 'p' for primary partition type: Type 'p' for primary partition type:
Line 533: Line 535:
  
 Create the partition for the root filesystem ('/'): Create the partition for the root filesystem ('/'):
 +
 +{{:slackwarearm:pinebookpro-fdisk-partition2-create.jpg?400|}}
  
 Type 'n' for new partition. Type 'n' for new partition.
 Press ENTER to accept the defaults - this will create partition 2 as the maximum size available. Press ENTER to accept the defaults - this will create partition 2 as the maximum size available.
- 
-{{:slackwarearm:10 - fdisk-rpro64.jpg?400|}} 
  
  
Line 547: Line 549:
 Type 'p' to print to view the partition table. Type 'p' to print to view the partition table.
  
-{{:slackwarearm:12- fdisk-rpro64.jpg?400|}}+{{:slackwarearm:pinebookpro-fdisk-printout.jpg?400|}}
  
 Type 'w' to write the partition table: Type 'w' to write the partition table:
Line 563: Line 565:
 {{:slackwarearm:15-SlackSetup-screen.jpg?400|}} {{:slackwarearm:15-SlackSetup-screen.jpg?400|}}
  
-{{:slackwarearm:16-SwapSpaceDetected-rpro64.jpg?400|}}+{{:slackwarearm:pinebookpro-swapspace-detected.jpg?400|}}
  
 {{:slackwarearm:17-SwapSpace-DefectCheck-rpro64.jpg?400|}} {{:slackwarearm:17-SwapSpace-DefectCheck-rpro64.jpg?400|}}
  
-{{:slackwarearm:18-SwapSpace-configured-rpro64.jpg?400|}}+{{:slackwarearm:pinebookpro-swapspace-configured.jpg?400|}}
  
 == Select and format the partition for the OS' root file system == == Select and format the partition for the OS' root file system ==
  
-{{:slackwarearm:19-SelectRootPartition-rpro64.jpg?400|}}+{{:slackwarearm:pinebookpro-selectroot-storagedevice.jpg?400|}}
  
-{{:slackwarearm:20-QuickFormatRootPartition.jpg?400|}}+{{:slackwarearm:pinebookpro-formatrootpartition.jpg?400|}}
  
-{{:slackwarearm:21-SelectFSforRootPartition.jpg?400|}}+{{:slackwarearm:pinebookpro-selectfs-for-rootfs.jpg?400|}}
  
-{{:slackwarearm:22-FormattingRootPartition-inProgress-rpro64.jpg?400|}}+{{:slackwarearm:pinebookpro-formattingrootpartition.jpg?400|}}
  
 == Resize /boot partition to full extent == == Resize /boot partition to full extent ==
Line 600: Line 602:
  
 {{:slackwarearm:27-AddedLinuxpartitions-rpro64.jpg?400|}} {{:slackwarearm:27-AddedLinuxpartitions-rpro64.jpg?400|}}
 +
 +Note: the screenshot shows /dev/sda2. This is from the RockPro64 and needs replacing - it will be the NVME block device name.
 +
  
 == Select Source Media == == Select Source Media ==
Line 667: Line 672:
 The Micro SD card is transformed from being the Slackware Installer into the Slackware OS's /boot partition. The Micro SD card is transformed from being the Slackware Installer into the Slackware OS's /boot partition.
 At this stage, if the installation has worked for you (at certain points in the Slackware installer you are past the point of no return) you can delete the Installer. At this stage, if the installation has worked for you (at certain points in the Slackware installer you are past the point of no return) you can delete the Installer.
-However, if something has gone wrong you can reset the RockPro64 and reboot the installer without having to re-deploy the Slackware Installer image from your Linux Host Computer.+However, if something has gone wrong you can reset the PinebookPro and reboot the installer without having to re-deploy the Slackware Installer image from your Linux Host Computer.
  
 Generally you should say 'Yes' here. Generally you should say 'Yes' here.
Line 774: Line 779:
  
 This is documented [[https://www.slackbook.org/html/essential-sysadmin.html|here]]. This is documented [[https://www.slackbook.org/html/essential-sysadmin.html|here]].
 +
 +=== LCD brightness ===
 +
 +The Slackware Installer automatically configures the maximum brightness, but this doesn't carry over to the OS.
 +
 +You may want to add this to /etc/rc.d/rc.local:
 +<code>
 +echo 4000 > /sys/class/backlight/edp-backlight/brightness
 +</code>
 +
 +This may be included within the OS as standard at some point.
 +
  
 ===== Known bugs ===== ===== Known bugs =====
 slackwarearm:inst_sa64_cur_rk3399_pinebookpro ()