Difference between revisions of "User:RemDogKap/SandBox/First Setup"

From PINE64
Jump to navigation Jump to search
m (combined eMMC and SD card sections)
(Replaced /dev/sdb with sdh in example to avoid inexperienced users to overwrite accidentally their hard-drives.)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Under construction}}
The Star64 is a 64 bit, 4 core Single Board Computer.  
The Star64 is a 64 bit, 4 core Single Board Computer.  


Line 10: Line 13:
*Ability to flash a storage device with a disk image. [https://etcher.balena.io/ Balena Etcher] is recommended, but advanced users can also use dd in a Unix-like OS
*Ability to flash a storage device with a disk image. [https://etcher.balena.io/ Balena Etcher] is recommended, but advanced users can also use dd in a Unix-like OS


==Flashing the image==
==Choosing Your Distribution==
There are currently two working distributions of Linux compatible with the Star64, pinix and Armbian. Both distributions use the same kernel[???].The pinix distribution is a custom distribution built by Fishwaldo using Yocto which is an open source project used to create Linux distributions for embedded devices. The pinix distribution is currently focusing on support for GPU and VGPU acceleration for desktop environments. Both distributions use the deb package manager. The Armbian distribution is based on Debian/Ubuntu with changes to make it lightweight and compatible with ARM/RISC-V development boards.  
There are currently two working distributions of Linux compatible with the Star64, pinix and Armbian. Both distributions use the same kernel[???].The pinix distribution is a custom distribution built by Fishwaldo using Yocto which is an open source project used to create Linux distributions for embedded devices. The pinix distribution is currently focusing on support for GPU and VGPU acceleration for desktop environments. Both distributions use the deb package manager. The Armbian distribution is based on Debian/Ubuntu with changes to make it lightweight and compatible with ARM/RISC-V development boards.  


While there are other RISC-V compatible distributions, none of these have the required device tree entries for the Star64 meaning that none will work fully on the Star64. This includes images for the StarFive2, a sister board which uses the same processor, due to other hardware differences. It may be possible to get other distributions to run on the Star64 by cross compiling the working kernel into another distribution.  
While there are other RISC-V compatible distributions, none of these have the required device tree entries for the Star64 meaning that none will work fully on the Star64. This includes images for the StarFive2, a sister board which uses the same processor, due to other hardware differences. It may be possible to get other distributions to run on the Star64 by cross compiling the working kernel into another distribution.  


More information about support for features can be accessed [[Status_of_Features | here]].
More information about support for features can be accessed [[User:RemDogKap/SandBox/Status of Features | here]].
===pinix Install===
 
==pinix==
There are currently three prebuilt versions of pinix. one command line only and two desktop environments. Choose one to use for this setup.
*star64-image-minimal - A command line only image.
*star64-image-weston - A Weston/Wayland "Demo" image.
*star64-image-plasma- A Plasma Based Image.
 
===Flashing the Image===


====Linux====
====Linux====


First, if not already installed, install bzip2 and wget.
First, if not already installed, install <code>bzip2</code> and <code>wget</code>.
  $ sudo apt update && sudo apt install bzip2 wget
  $ sudo apt update && sudo apt install bzip2 wget


Second, download a compressed disk image (.wic.bz2) from [https://pine64.my-ho.st:8443/ here] (source code available [https://github.com/Fishwaldo/meta-pine64 here]) using wget. There are three types of images, one command line only and two desktop environments.
Second, download a compressed disk image (<code>.wic.bz2</code>) of your chosen version (minimal, weston, or plasma) from [https://pine64.my-ho.st:8443/ here] (source code available [https://github.com/Fishwaldo/meta-pine64 here]) using wget.  
*star64-image-minimal - A command line only image
*star64-image-weston - A Weston/Wayland "Demo" image.
*star64-image-plasma- A Plasma Based Image.
 
$ wget  <nowiki>https://pine64.my-ho.st:8443/${Name of Image File}</nowiki>


Where ${Name of Image File} is the name of your chosen image file.
$ wget  <nowiki>https://pine64.my-ho.st:8443/<Name of Image File></nowiki>
Example:


$ wget <nowiki>https://pine64.my-ho.st:8443/star64-image-minimal-star64-1.2.wic.bz2</nowiki>
Where <code><Name of Image File></code> is the name of your chosen image file. <span class="mw-customtoggle-if-dl-toggle" style="text-decoration:underline;color:#0645ad">Example</span>


Next, decompress the file using bzip2.
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-dl-toggle">
$ wget <nowiki>https://pine64.my-ho.st:8443/star64-image-minimal-star64-1.3.rootfs.wic.bz2</nowiki>
</div>


$ bzip2 -d ${Path to Image File}
Next, flash the image to the SD card or eMMC module.


Where ${Path to Image File} is the path to your image file. Example:
$ bzip2 -cd  <Path to Image File> | sudo dd of=/dev/<Flash device>


$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2
Where <code><Path to Image File></code> is the path to your image file and <code><Flash device></code> is the device name of your card or module. <span class="mw-customtoggle-if-unzip-toggle" style="text-decoration:underline;color:#0645ad">Example</span>


Next, flash the image to the SD card or eMMC module. The open source Balena Etcher with GUI support is recommended but dd will work as well if you are an advanced user.
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-unzip-toggle">
$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 | sudo dd of=/dev/sdh
</div>


====Windows====
====Windows====
Line 49: Line 57:
First, make sure that you have [https://7-zip.org/ 7zip] installed and if not, install it.  
First, make sure that you have [https://7-zip.org/ 7zip] installed and if not, install it.  


Second, download a compressed disk image (.wic.bz2) from [https://pine64.my-ho.st:8443/ here] (source code available [https://github.com/Fishwaldo/meta-pine64 here]) by clicking on the files. There are three types of images, one command line only and two desktop environments.
Second, download a compressed disk image (<code>.wic.bz2</code>) from [https://pine64.my-ho.st:8443/ here] (source code available [https://github.com/Fishwaldo/meta-pine64 here]) by clicking on the files.  
*star64-image-minimal - A command line only image
*star64-image-weston - A Weston/Wayland "Demo" image.
*star64-image-plasma- A Plasma Based Image.


Third, right click on the downloaded file and select 7-zip. Next click extract.  
Third, right click on the downloaded file and select 7-zip. Next click extract.  
Line 58: Line 63:
Finally, use Balena Etcher to write your disk image to the SD Card or eMMC module .  
Finally, use Balena Etcher to write your disk image to the SD Card or eMMC module .  


===Armbian Install===
===Booting the Image===
 
First, make sure that the Star64 is powered off, then set the boot dip switches to SD Card or eMMC, whichever applies to you.
 
<div><ul>
<li style="display: inline-block;"> [[File:Star64_SD_switch_map.png|thumb|left|Dip switch settings to boot from SD Card.]] </li>
<li style="display: inline-block;"> [[File:Star64_EMMC_switch_map.png|thumb|Dip switch settings to boot from eMMC module.]] </li>
</ul></div>
 
After that, insert your flash media of choice and connect your peripherals. These can be a keyboard mouse and monitor or a TTL UART cable connected to the GPIO header. Finally, power on the system.


After boot, you should be met with a login screen. The default credentials here for a root user are root as a username and Star64 as a password. The default credentials for a regular user are Star64 as a username and Star64 as a password. If you do not see the troublshooting section below


==Booting the Image==
==Troubeshooting==
{{:STAR64}}

Latest revision as of 21:44, 6 July 2023

This page or section is under construction

Please help to review and edit this page or section. Information are subject to change.


The Star64 is a 64 bit, 4 core Single Board Computer.

Prerequisites

Choosing Your Distribution

There are currently two working distributions of Linux compatible with the Star64, pinix and Armbian. Both distributions use the same kernel[???].The pinix distribution is a custom distribution built by Fishwaldo using Yocto which is an open source project used to create Linux distributions for embedded devices. The pinix distribution is currently focusing on support for GPU and VGPU acceleration for desktop environments. Both distributions use the deb package manager. The Armbian distribution is based on Debian/Ubuntu with changes to make it lightweight and compatible with ARM/RISC-V development boards.

While there are other RISC-V compatible distributions, none of these have the required device tree entries for the Star64 meaning that none will work fully on the Star64. This includes images for the StarFive2, a sister board which uses the same processor, due to other hardware differences. It may be possible to get other distributions to run on the Star64 by cross compiling the working kernel into another distribution.

More information about support for features can be accessed here.

pinix

There are currently three prebuilt versions of pinix. one command line only and two desktop environments. Choose one to use for this setup.

  • star64-image-minimal - A command line only image.
  • star64-image-weston - A Weston/Wayland "Demo" image.
  • star64-image-plasma- A Plasma Based Image.

Flashing the Image

Linux

First, if not already installed, install bzip2 and wget.

$ sudo apt update && sudo apt install bzip2 wget

Second, download a compressed disk image (.wic.bz2) of your chosen version (minimal, weston, or plasma) from here (source code available here) using wget.

$ wget  https://pine64.my-ho.st:8443/<Name of Image File>

Where <Name of Image File> is the name of your chosen image file. Example

$ wget https://pine64.my-ho.st:8443/star64-image-minimal-star64-1.3.rootfs.wic.bz2

Next, flash the image to the SD card or eMMC module.

$ bzip2 -cd  <Path to Image File> | sudo dd of=/dev/<Flash device>

Where <Path to Image File> is the path to your image file and <Flash device> is the device name of your card or module. Example

$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 | sudo dd of=/dev/sdh

Windows

First, make sure that you have 7zip installed and if not, install it.

Second, download a compressed disk image (.wic.bz2) from here (source code available here) by clicking on the files.

Third, right click on the downloaded file and select 7-zip. Next click extract.

Finally, use Balena Etcher to write your disk image to the SD Card or eMMC module .

Booting the Image

First, make sure that the Star64 is powered off, then set the boot dip switches to SD Card or eMMC, whichever applies to you.

  • Dip switch settings to boot from SD Card.
  • Dip switch settings to boot from eMMC module.

After that, insert your flash media of choice and connect your peripherals. These can be a keyboard mouse and monitor or a TTL UART cable connected to the GPIO header. Finally, power on the system.

After boot, you should be met with a login screen. The default credentials here for a root user are root as a username and Star64 as a password. The default credentials for a regular user are Star64 as a username and Star64 as a password. If you do not see the troublshooting section below

Troubeshooting

If you get the following error in u-boot (or your 8Gb board is only detected as 4Gb) the possible problem is a empty, or corrupt eeprom:

Not a StarFive EEPROM data format - magic error
EEPROM dump: (0x100 bytes)
00: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
10: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
20: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
30: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
40: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
50: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
60: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
70: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
80: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
90: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
A0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
B0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
C0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
D0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
E0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
F0: FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

Then from within u-boot execute the following commands:

mac initialize
mac product_id <PRODUCTID>
mac write_eeprom

Set ProductID to either:

  • For 8Gb Models: STAR64V1-2310-D008E000-01234567
  • for 4Gb Models: STAR64V1-2310-D004E000-01234567

You can replace the last 8 digits with a random number if you wish. If these commands fail, please join the #star64 channel in the Pine64 community for more assistance.