Difference between revisions of "User:RemDogKap/SandBox/First Setup"
m (combined eMMC and SD card sections) |
(Added troubleshooting section, booting section, and restructured the article) |
||
| 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 | ||
== | ==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 [[ | More information about support for features can be accessed [[User:RemDogKap/SandBox/Status of Features | here]]. | ||
===pinix | |||
==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 | Second, download a compressed disk image (.wic.bz2) of your chosen verison (minimal, weston, or plasma) from [https://pine64.my-ho.st:8443/ here] (source code available [https://github.com/Fishwaldo/meta-pine64 here]) using wget. | ||
$ wget <nowiki>https://pine64.my-ho.st:8443/${Name of Image File}</nowiki> | $ 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. | Where <code>${Name of Image File}</code> is the name of your chosen image file. | ||
Example: | Example: | ||
| Line 39: | Line 46: | ||
$ bzip2 -d ${Path to Image File} | $ bzip2 -d ${Path to Image File} | ||
Where ${Path to Image File} is the path to your image file. Example: | Where <code>${Path to Image File}</code> is the path to your image file. Example: | ||
$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2 | $ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2 | ||
| Line 49: | Line 56: | ||
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 | 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. | ||
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 62: | ||
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 . | ||
=== | ===Booting the Image=== | ||
{{warning | This has not been fully tested and verified, use these instructions at your own risk, please remove if these look good}} | |||
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 | |||
== | ==Troubeshooting== | ||
{{:STAR64}} | |||
Revision as of 00:51, 10 June 2023
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
- Star64 SBC
- 12V 3A to 5A Power Supply (Any 12V 3A or 5A type M 5.5mm OD/2.1mm ID barrel type DC Jack Power Supply will work)
- One or more types of removeable flash memory
- SD card of at least ??GB, no greater than 256GB
- eMMC Module with USB adapter
- Ability to flash a storage device with a disk image. Balena Etcher is recommended, but advanced users can also use dd in a Unix-like OS
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 verison (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.2.wic.bz2
Next, decompress the file using bzip2.
$ bzip2 -d ${Path to Image File}
Where ${Path to Image File} is the path to your image file. Example:
$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2
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.
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.
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.