User:RemDogKap/SandBox/First Setup - Revision history

Nuess0r: Replaced /dev/sdb with sdh in example to avoid inexperienced users to overwrite accidentally their hard-drives.

2023-07-06T21:44:09Z

Replaced /dev/sdb with sdh in example to avoid inexperienced users to overwrite accidentally their hard-drives.

← Older revision		Revision as of 21:44, 6 July 2023
Line 50:		Line 50:

	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-unzip-toggle">		<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/~~sdb~~		$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 \| sudo dd of=/dev/sdh
	</div>		</div>

Nuess0r: Replaced Linux unzip and flash instructions with a combined step. The manual anyhow assumes using a terminal so I assume it's not increasing needed user knowledge.

2023-07-06T21:42:04Z

Replaced Linux unzip and flash instructions with a combined step. The manual anyhow assumes using a terminal so I assume it's not increasing needed user knowledge.

← Older revision		Revision as of 21:42, 6 July 2023
Line 40:		Line 40:

	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-dl-toggle">		<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.2.wic.bz2</nowiki>		$ wget <nowiki>https://pine64.my-ho.st:8443/star64-image-minimal-star64-1.3.rootfs.wic.bz2</nowiki>
	</div>		</div>

	Next, ~~decompress~~ the ~~file using bzip2~~.		Next, flash the image to the SD card or eMMC module.

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

	Where <code><Path to Image File></code> is the path to your image file. <span class="mw-customtoggle-if-unzip-toggle" style="text-decoration:underline;color:#0645ad">Example</span>		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>

	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-unzip-toggle">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-unzip-toggle">
	$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2		$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 \| sudo dd of=/dev/sdb
	</div>		</div>

	~~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====		====Windows====

RemDogKap: changed example sections to be collapsible, fixed typos, changed to be filled in things from ${} to <>

2023-06-17T01:29:33Z

changed example sections to be collapsible, fixed typos, changed to be filled in things from ${} to <>

← Older revision		Revision as of 01:29, 17 June 2023
Line 33:		Line 33:
	$ sudo apt update && sudo apt install bzip2 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 [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 (<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.

	$ 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 <code>${Name of Image File}</code> is the name of your chosen image file.		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>
	Example:

			<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.2.wic.bz2</nowiki>		$ wget <nowiki>https://pine64.my-ho.st:8443/star64-image-minimal-star64-1.2.wic.bz2</nowiki>
			</div>

	Next, decompress the file using bzip2.		Next, decompress the file using bzip2.

	$ bzip2 -d ${Path to Image File}		$ bzip2 -d <Path to Image File>

	Where <code>${Path to Image File}</code> is the path to your image file. Example:		Where <code><Path to Image File></code> is the path to your image file. <span class="mw-customtoggle-if-unzip-toggle" style="text-decoration:underline;color:#0645ad">Example</span>

			<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-if-unzip-toggle">
	$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2		$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2
			</div>

	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.		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.
Line 56:		Line 59:
	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 (<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.

	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 63:		Line 66:

	===Booting the Image===		===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.		First, make sure that the Star64 is powered off, then set the boot dip switches to SD Card or eMMC, whichever applies to you.

RemDogKap: Added troubleshooting section, booting section, and restructured the article

2023-06-10T00:51:23Z

Added troubleshooting section, booting section, and restructured the article

← Older revision		Revision as of 00:51, 10 June 2023
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 (.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.
	*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>		$ 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~~. There are three types of images, one command line only and two desktop environments.~~		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.
	*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 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 .

	===~~Armbian Install~~===		===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

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

RemDogKap: combined eMMC and SD card sections

2023-06-09T23:18:37Z

combined eMMC and SD card sections

← Older revision		Revision as of 23:18, 9 June 2023
Line 11:		Line 11:

	==Flashing the image==		==Flashing the image==
	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 built 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.
Line 43:		Line 43:
	$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2		$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2

	Next, flash the image to the SD card. The open source Balena Etcher with GUI support is recommended but dd will work as well if you are an advanced user.		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====		====Windows====
Line 56:		Line 56:
	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.

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

	===Armbian Install===		===Armbian Install===

	~~===SD Card===~~

	~~===eMMC Flash===~~
	~~[Not sure if eMMC flash is any different, I (Rem) do not have experience using it]~~
	~~====Using SD Card====~~
	[As mbuggle said in Discord #Star64 on 2023-06-05 1:10 AM CDT (Message ID: 1115160713439223859) it seems like it may be possible to use an SD Card to first boot, use the SSD to transfer the disk image to the eMMC, remove the SD Card and boot from eMMC]
	~~====Using eMMC to USB Adapter====~~

	==Booting the Image==		==Booting the Image==

RemDogKap: minor edits and how to flash sd card on windows

2023-06-08T20:16:31Z

minor edits and how to flash sd card on windows

← Older revision		Revision as of 20:16, 8 June 2023
Line 11:		Line 11:

	==Flashing the image==		==Flashing the image==
	There are currently two working distributions of Linux compatible with the Star64, ~~Pocky~~ and Armbian. Both distributions use the same kernel[???].The ~~Pocky~~ distribution is built using Yocto which is an open source project used to create Linux distributions for embedded devices. The ~~Pocky~~ distribution currently ~~has some~~ GPU ~~support~~ and ~~is further developed than Armbian~~. 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 built 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 [[Status_of_Features \| here]].		More information about support for features can be accessed [[Status_of_Features \| here]].
	===~~Pocky~~ Install===		===pinix Install===

	====Linux====		====Linux====
Line 40:		Line 42:

	$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2		$ bzip2 -d star64-image-minimal-star64-1.2.wic.bz2

			Next, flash the image to the SD card. The open source Balena Etcher with GUI support is recommended but dd will work as well if you are an advanced user.

	====Windows====		====Windows====

			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.
			*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.

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

	===Armbian Install===		===Armbian Install===
Line 52:		Line 67:
	[As mbuggle said in Discord #Star64 on 2023-06-05 1:10 AM CDT (Message ID: 1115160713439223859) it seems like it may be possible to use an SD Card to first boot, use the SSD to transfer the disk image to the eMMC, remove the SD Card and boot from eMMC]		[As mbuggle said in Discord #Star64 on 2023-06-05 1:10 AM CDT (Message ID: 1115160713439223859) it seems like it may be possible to use an SD Card to first boot, use the SSD to transfer the disk image to the eMMC, remove the SD Card and boot from eMMC]
	====Using eMMC to USB Adapter====		====Using eMMC to USB Adapter====

			==Booting the Image==

RemDogKap: minor formatting

2023-06-08T16:03:18Z

minor formatting

← Older revision		Revision as of 16:03, 8 June 2023
Line 4:		Line 4:

	*[https://pine64.com/product-category/star64/ Star64 SBC]		*[https://pine64.com/product-category/star64/ Star64 SBC]
	*[https://pine64.com/product-category/star64-accessories/ 12V 3 to ~~5 A~~ Power Supply] (Any 12V 3A or 5A type M 5.5mm OD/2.1mm ID barrel type DC Jack Power Supply will work)		*[https://pine64.com/product-category/star64-accessories/ 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		*One or more types of removeable flash memory
	**[https://pine64.com/product/64gb-class10-microsd-card/ SD card] of at least ??GB, no greater than 256GB		**[https://pine64.com/product/64gb-class10-microsd-card/ SD card] of at least ??GB, no greater than 256GB
Line 13:		Line 13:
	There are currently two working distributions of Linux compatible with the Star64, Pocky and Armbian. Both distributions use the same kernel[???].The Pocky distribution is built using Yocto which is an open source project used to create Linux distributions for embedded devices. The Pocky distribution currently has some GPU support and is further developed than Armbian. 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, Pocky and Armbian. Both distributions use the same kernel[???].The Pocky distribution is built using Yocto which is an open source project used to create Linux distributions for embedded devices. The Pocky distribution currently has some GPU support and is further developed than Armbian. 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.

	More information about support for features can be accessed [[Status_of_Features \| here]]		More information about support for features can be accessed [[Status_of_Features \| here]].
	===Pocky Install===		===Pocky Install===

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

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

RemDogKap: began section on flashing the image

2023-06-08T04:46:15Z

began section on flashing the image

@@ Line 8: / Line 8: @@
 **[https://pine64.com/product/64gb-class10-microsd-card/ SD card] of at least ??GB, no greater than 256GB
 **[https://pine64.com/product-category/star64-accessories/ eMMC Module] with [https://pine64.com/product/usb-adapter-for-emmc-module/ USB adapter]
-*Ability to flash a storage device. [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

RemDogKap: Prereqs rough out

2023-06-08T02:43:09Z

Prereqs rough out

New page

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

==Prerequisites==

*[https://pine64.com/product-category/star64/ Star64 SBC]
*[https://pine64.com/product-category/star64-accessories/ 12V 3 to 5 A 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
**[https://pine64.com/product/64gb-class10-microsd-card/ SD card] of at least ??GB, no greater than 256GB
**[https://pine64.com/product-category/star64-accessories/ eMMC Module] with [https://pine64.com/product/usb-adapter-for-emmc-module/ USB adapter]
*Ability to flash a storage device. [https://etcher.balena.io/ Balena Etcher] is recommended, but advanced users can also use dd in a Unix-like OS