PINE64 - User contributions [en]

User:Nuess0r/SandBox/Install Debian

2024-11-17T21:31:05Z

Nuess0r: Update installer download link

=Install Debian on Star64=
{{Under construction}}
{{Warning | Attempting these instructions may permanently brick (make nonfunctional) your device. Do not attempt unless you know what you are doing.}}
{{Warning | These instructions have not been tested or verified. Use at your own risk.}}

This how-to guides you through the process to install Debian SID (unstable) on your Star64.

==Prerequisites==
Required:
*Star64 SBC
*Micro SDcard or Pine64 eMMC module
*USB serial converter with TTL output (No RS232 converter)
*Ability to network the Star64 to a computer over ethernet (Switch, Ethernet cables,...)
*Ability to write Micro SDcards or if you have only the eMMC module you also need the Pine64 eMMC USB programmer
*Computer running Linux

==Update U-Boot and SPL==
The Star64 ships with an integrated 128 megabit (16 megabyte) SPI NOR flash. Loaded on this flash from the factory is firmware called U-Boot and SPL but an old version designed for the StarFive VisionFive 2 SBC which is incompatible with the Star64 mainline Linux kernel (>= 6.11). The SPL (Secondary Program Loader) is the software that loads U-Boot, which in turn loads the Linux kernel. It performs similar functions to the BIOS on x86 platforms.

There are two main ways to update the SPI flash. The first uses the <code>flashcp</code> command which requires the Star64 to first boot into an OS. This method requires an OS able to boot from the old u-boot like Pinix from fishwaldo but unfortunately it doesn't ship with flashcp. The other method requires only the ability to load U-Boot and uses TFTP and the U-Boot <code>tftpboot</code> command.

===Preparing The TFTP Server and UART Connection===
====Linux====
First, on your computer (not the Star64) install a TFTP server and <code>wget</code> if you do not already have it.
$ sudo apt update && sudo apt install tftpd-hpa wget
Next, check that the TFPT server is running using <code>systemctl</code>.
$ sudo systemctl status tftpd-hpa
This should output somethng like

<span style="color:#16c60c">●</span> tftpd-hpa.service - LSB: HPA's tftp server
Loaded: loaded (/etc/init.d/tftpd-hpa; generated)
Active: <span style="color:#16c60c">active (running)</span> since Sat 2023-06-10 20:51:28 CDT; 17min ago
Docs: man:systemd-sysv-generator(8)
Process: 1016 ExecStart=/etc/init.d/tftpd-hpa start (code=exited, status=0/SUCCESS)
Tasks: 1 (limit: 2306)
Memory: 588.0K
CPU: 23ms
CGroup: /system.slice/tftpd-hpa.service
└─1023 /usr/sbin/in.tftpd --listen --user tftp --address :69 --secure /srv/tftp

Jun 10 20:51:28 debian-bookworm systemd[1]: Starting tftpd-hpa.service - LSB: HPA's tftp server...
Jun 10 20:51:28 debian-bookworm tftpd-hpa[1016]: Starting HPA's tftpd: in.tftpd.
Jun 10 20:51:28 debian-bookworm systemd[1]: Started tftpd-hpa.service - LSB: HPA's tftp server.

If the service is not running, try
$ sudo systemctl start tftpd-hpa
and check the status again. If it is still not running please join the #star64 channel in the Pine64 IRC, Discord, or Matrix.

Next in your home directory (<code>/home/user</code>) create a folder called <code>tftp_share</code>
$ mkdir /home/user/tftp_share
In this folder, download the <code>u-boot-spl.bin.normal.out</code> SPL file and the <code>u-boot.itb</code> U-Boot image using <code>wget</code>.
$ cd /srv/tftp
$ sudo wget <nowiki>https://freeshell.de/e/riscv64/u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>
$ sudo unzip <nowiki>u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>

Before connecting to the Star64 and updating the firmware install screen, virtual console software, so it will be possible to communicate with the Star64.
$ sudo apt update && sudo apt install screen
Next connect your USB to TTL UART adapter to the computer and list the connected serial devices.

Find the address of the TTL UART to USB adapter in the list (example: <code>ttyUSB0</code>) and connect to the serial device with a baud rate of 115200.
$ screen /dev/<Device Address> 115200
Where <code><Device Address></code> is the address found in the step above. <span class="mw-customtoggle-device-address-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-device-address-toggle">
$ screen /dev/ttyUSB0 115200
</div>

====Windows====

First, install two pieces of software, [https://pjo2.github.io/tftpd64/ tftpd64], a TFTP server for windows, and [http://ttssh2.osdn.jp/index.html.en Tera Term], a virtual console for interacting with the Star64 in U-Boot.
Next on your desktop, create a folder called <code>tftp_share</code>
In this folder, place the the <code>u-boot-spl.bin.normal.out</code> SPL file and the <code>u-boot.itb</code> U-Boot image from [u-boot-20241028-428921_429908_429906_ocloaderase.zip this Zip file].

Next, load tftpd64 and configure the settings to have the "Current Directory" as the <code>tftp_share</code> folder on the desktop and "Server interfaces" is set to <code>127.0.0.1 Software Loopback Interface 1</code>. The path should look something like <code>C:\Users\${Username}\Desktop\tftp_share</code> where <code>${Username}</code> is your username on Windows.
[[File:Star64 tftpd64 settings.png|none|500px|thumb|left]]

TODO: Short intro how to use Putty.

===Updating the SPI Flash===

[[File:STAR64-serial-pins.jpg|400px|thumb|right|Serial pins on the STAR64 I/O connector]]

Next, connect a TTL UART to USB cable to to the Star64 with the GND cable on pin 6 of the GPIO header, TXD on pin 8, and RXD on pin 10 as well as Ethernet. Note that depending on your UART adapter you may have to switch TXD and RXD. Now power on the Star64 and enter U-Boot. You will need to press a key to prevent it from autobooting and instead enter the U-Boot command prompt.
Once you are in the U-Boot shell set some environment variables.
First, set the IP address of the Star64 and connect it to the network using the <code>dhcp</code> command.
# dhcp

Set an environment variable of the TFTP server to make future command easier. If you don't what the IP address of your TFTP server is you can see connected devices in your router's configuration which can usually be accessed by typing in the IP address found on the router itself.
# setenv serverip <server IP>
Where <code>server IP</code> is the IP address of the TFTP server. <span class="mw-customtoggle-set-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-set-ip-addr-toggle">
# setenv serverip 192.168.1.199
</div>
Ping the TFTP server from the Star64 to make sure the connection works where <code><Server IP></code> refers to the IP address of your TFTP server. Note that if you are hosting the TFTP server on Windows, you may need to configure Windows firewall to allow <code>‘File and Printer Sharing (Echo Request – ICMPv4 – In)’</code>. This is only needed to test the network connection with <code>ping</code> and not for the actual <code>tftpboot</code> command so if <code>ping</code> fails <code>tftpboot</code> may still succeed.
# ping <server IP>
<span class="mw-customtoggle-ping-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ping-ip-addr-toggle">
# ping 192.168.1.199
</div>
The result should look something like this:
<pre>
Star64 # ping 192.168.1.199
Using ethernet@16030000 device
host 192.168.1.199 is alive
</pre>
If ping fails, please try again or please join the #star64 channel in the Pine64 IRC, Discord, or Matrix for help.

Finally, it is time to update the xSPI flash.

First, initialize the flash with the <code>sf probe</code> command.
# sf probe

The output should be something like:
<pre>
Star64 # sf probe
SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
</pre>

Next copy the SPL <code>.bin.normal.out</code> file to memory address 0xa0000000 from our TFTP server.
# tftpboot 0xa0000000 ${serverip}:u-boot-spl.bin.normal.out

Where ${serverip} is the environment variable we set earlier, no need to change it.
Then use <code>sf update</code> to erase and update the SPI flash from memory. In this case we are copying from memory address 0xa0000000 which we wrote to earlier with an offset of 0x0.

# sf update 0xa0000000 0x0 $filesize

Next, copy the U-Boot <code>.img</code> binary to memory address 0xa0000000 from the TFTP server.
# tftpboot 0xa0000000 ${serverip}:u-boot.itb
Where ${serverip} is the environment variable we set earlier, no need to change it.

Finally, write the new U-Boot binary using <code>sf update</code> from memory address 0xa0000000 with an offset of 0x100000.
# sf update 0xa0000000 0x100000 $filesize

Reboot the Star64 and the changes should have taken effect.

On your Linux host, disable the TFTP server again, when you don't need it anymore:
$ sudo systemctl disable tftpd-hpa

==Install Debian==

===Prepare Debian Installation Media===

Download the latest Debian installer for Risc-V targets:

https://d-i.debian.org/daily-images/riscv64/daily/netboot/mini.iso

====Linux====

Use [https://github.com/balena-io/etcher Balena Etcha] or <code>dd</code> to write the installer image to your SD card or eMMC drive.

$ sudo dd if=mini.iso of=/dev/sdX

Where <code>/dev/sdX</code> is the path of your SD card or eMMC drive. Warning: Double check the device name! Otherwise you could accidentally overwrite your system drive!

====Windows====

Use [https://github.com/balena-io/etcher Balena Etcha] to write the installer image to your SD card or eMMC drive.

===Boot into Debian Installer===
[[File:Debian-Grub 20241117 144136.png|300px|thumb|right|Debian installer GRUB menu]]

Insert your SD card or eMMC drive into the Star64 and switch it on. After u-boot is finished you should see a GRUB menu where you can select ''install'' and other entries for more options.

Follow installation

In the tasks selection, enable SSH server

TODO: Notes on partitioning, how to use eMMC when installer is on eMMC.

===Final Steps===

Finish the installation" step of installer to ^a^n change 'screen' window over to command prompt in debian-installer and
$ cp -rT /target/lib/linux-image-*-riscv64 /target/boot/efi/dtb

[[Category:STAR64]]

File:Debian-Grub 20241117 144136.png

2024-11-17T13:47:12Z

Nuess0r: Debian Testing GRUB menu Category:STAR64

== Summary ==
Debian Testing GRUB menu

[[Category:STAR64]]

== Licensing ==
{{CC0}}

User:Nuess0r/SandBox/Install Debian

2024-11-08T07:50:04Z

Nuess0r: minor clean up

=Install Debian on Star64=
{{Under construction}}
{{Warning | Attempting these instructions may permanently brick (make nonfunctional) your device. Do not attempt unless you know what you are doing.}}
{{Warning | These instructions have not been tested or verified. Use at your own risk.}}

This how-to guides you through the process to install Debian SID (unstable) on your Star64.

==Prerequisites==
Required:
*Star64 SBC
*Micro SDcard or Pine64 eMMC module
*USB serial converter with TTL output (No RS232 converter)
*Ability to network the Star64 to a computer over ethernet (Switch, Ethernet cables,...)
*Ability to write Micro SDcards or if you have only the eMMC module you also need the Pine64 eMMC USB programmer
*Computer running Linux

==Update U-Boot and SPL==
The Star64 ships with an integrated 128 megabit (16 megabyte) SPI NOR flash. Loaded on this flash from the factory is firmware called U-Boot and SPL but an old version designed for the StarFive VisionFive 2 SBC which is incompatible with the Star64 mainline Linux kernel (>= 6.11). The SPL (Secondary Program Loader) is the software that loads U-Boot, which in turn loads the Linux kernel. It performs similar functions to the BIOS on x86 platforms.

There are two main ways to update the SPI flash. The first uses the <code>flashcp</code> command which requires the Star64 to first boot into an OS. This method requires an OS able to boot from the old u-boot like Pinix from fishwaldo but unfortunately it doesn't ship with flashcp. The other method requires only the ability to load U-Boot and uses TFTP and the U-Boot <code>tftpboot</code> command.

===Preparing The TFTP Server and UART Connection===
====Linux====
First, on your computer (not the Star64) install a TFTP server and <code>wget</code> if you do not already have it.
$ sudo apt update && sudo apt install tftpd-hpa wget
Next, check that the TFPT server is running using <code>systemctl</code>.
$ sudo systemctl status tftpd-hpa
This should output somethng like

<span style="color:#16c60c">●</span> tftpd-hpa.service - LSB: HPA's tftp server
Loaded: loaded (/etc/init.d/tftpd-hpa; generated)
Active: <span style="color:#16c60c">active (running)</span> since Sat 2023-06-10 20:51:28 CDT; 17min ago
Docs: man:systemd-sysv-generator(8)
Process: 1016 ExecStart=/etc/init.d/tftpd-hpa start (code=exited, status=0/SUCCESS)
Tasks: 1 (limit: 2306)
Memory: 588.0K
CPU: 23ms
CGroup: /system.slice/tftpd-hpa.service
└─1023 /usr/sbin/in.tftpd --listen --user tftp --address :69 --secure /srv/tftp

Jun 10 20:51:28 debian-bookworm systemd[1]: Starting tftpd-hpa.service - LSB: HPA's tftp server...
Jun 10 20:51:28 debian-bookworm tftpd-hpa[1016]: Starting HPA's tftpd: in.tftpd.
Jun 10 20:51:28 debian-bookworm systemd[1]: Started tftpd-hpa.service - LSB: HPA's tftp server.

If the service is not running, try
$ sudo systemctl start tftpd-hpa
and check the status again. If it is still not running please join the #star64 channel in the Pine64 IRC, Discord, or Matrix.

Next in your home directory (<code>/home/user</code>) create a folder called <code>tftp_share</code>
$ mkdir /home/user/tftp_share
In this folder, download the <code>u-boot-spl.bin.normal.out</code> SPL file and the <code>u-boot.itb</code> U-Boot image using <code>wget</code>.
$ cd /srv/tftp
$ sudo wget <nowiki>https://freeshell.de/e/riscv64/u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>
$ sudo unzip <nowiki>u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>

Before connecting to the Star64 and updating the firmware install screen, virtual console software, so it will be possible to communicate with the Star64.
$ sudo apt update && sudo apt install screen
Next connect your USB to TTL UART adapter to the computer and list the connected serial devices.

Find the address of the TTL UART to USB adapter in the list (example: <code>ttyUSB0</code>) and connect to the serial device with a baud rate of 115200.
$ screen /dev/<Device Address> 115200
Where <code><Device Address></code> is the address found in the step above. <span class="mw-customtoggle-device-address-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-device-address-toggle">
$ screen /dev/ttyUSB0 115200
</div>

====Windows====

First, install two pieces of software, [https://pjo2.github.io/tftpd64/ tftpd64], a TFTP server for windows, and [http://ttssh2.osdn.jp/index.html.en Tera Term], a virtual console for interacting with the Star64 in U-Boot.
Next on your desktop, create a folder called <code>tftp_share</code>
In this folder, place the the <code>u-boot-spl.bin.normal.out</code> SPL file and the <code>u-boot.itb</code> U-Boot image from [u-boot-20241028-428921_429908_429906_ocloaderase.zip this Zip file].

Next, load tftpd64 and configure the settings to have the "Current Directory" as the <code>tftp_share</code> folder on the desktop and "Server interfaces" is set to <code>127.0.0.1 Software Loopback Interface 1</code>. The path should look something like <code>C:\Users\${Username}\Desktop\tftp_share</code> where <code>${Username}</code> is your username on Windows.
[[File:Star64 tftpd64 settings.png|none|500px|thumb|left]]

TODO: Short intro how to use Putty.

===Updating the SPI Flash===

[[File:STAR64-serial-pins.jpg|400px|thumb|right|Serial pins on the STAR64 I/O connector]]

Next, connect a TTL UART to USB cable to to the Star64 with the GND cable on pin 6 of the GPIO header, TXD on pin 8, and RXD on pin 10 as well as Ethernet. Note that depending on your UART adapter you may have to switch TXD and RXD. Now power on the Star64 and enter U-Boot. You will need to press a key to prevent it from autobooting and instead enter the U-Boot command prompt.
Once you are in the U-Boot shell set some environment variables.
First, set the IP address of the Star64 and connect it to the network using the <code>dhcp</code> command.
# dhcp

Set an environment variable of the TFTP server to make future command easier. If you don't what the IP address of your TFTP server is you can see connected devices in your router's configuration which can usually be accessed by typing in the IP address found on the router itself.
# setenv serverip <server IP>
Where <code>server IP</code> is the IP address of the TFTP server. <span class="mw-customtoggle-set-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-set-ip-addr-toggle">
# setenv serverip 192.168.1.199
</div>
Ping the TFTP server from the Star64 to make sure the connection works where <code><Server IP></code> refers to the IP address of your TFTP server. Note that if you are hosting the TFTP server on Windows, you may need to configure Windows firewall to allow <code>‘File and Printer Sharing (Echo Request – ICMPv4 – In)’</code>. This is only needed to test the network connection with <code>ping</code> and not for the actual <code>tftpboot</code> command so if <code>ping</code> fails <code>tftpboot</code> may still succeed.
# ping <server IP>
<span class="mw-customtoggle-ping-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ping-ip-addr-toggle">
# ping 192.168.1.199
</div>
The result should look something like this:
<pre>
Star64 # ping 192.168.1.199
Using ethernet@16030000 device
host 192.168.1.199 is alive
</pre>
If ping fails, please try again or please join the #star64 channel in the Pine64 IRC, Discord, or Matrix for help.

Finally, it is time to update the xSPI flash.

First, initialize the flash with the <code>sf probe</code> command.
# sf probe

The output should be something like:
<pre>
Star64 # sf probe
SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
</pre>

Next copy the SPL <code>.bin.normal.out</code> file to memory address 0xa0000000 from our TFTP server.
# tftpboot 0xa0000000 ${serverip}:u-boot-spl.bin.normal.out

Where ${serverip} is the environment variable we set earlier, no need to change it.
Then use <code>sf update</code> to erase and update the SPI flash from memory. In this case we are copying from memory address 0xa0000000 which we wrote to earlier with an offset of 0x0.

# sf update 0xa0000000 0x0 $filesize

Next, copy the U-Boot <code>.img</code> binary to memory address 0xa0000000 from the TFTP server.
# tftpboot 0xa0000000 ${serverip}:u-boot.itb
Where ${serverip} is the environment variable we set earlier, no need to change it.

Finally, write the new U-Boot binary using <code>sf update</code> from memory address 0xa0000000 with an offset of 0x100000.
# sf update 0xa0000000 0x100000 $filesize

Reboot the Star64 and the changes should have taken effect.

On your Linux host, disable the TFTP server again, when you don't need it anymore:
$ sudo systemctl disable tftpd-hpa

==Install Debian==

===Prepare Debian Installation Media===

Download the latest Debian installer for Risc-V targets:

https://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/riscv64/iso-cd/

====Linux====

Use [https://github.com/balena-io/etcher Balena Etcha] or dd to write the installer image to your SD card or eMMC drive.

$ sudo dd if=debian-testing-riscv64-netinst.iso of=/dev/sdX

Where /dev/sdX is the path of your SD card or eMMC drive. Warning: Double check the device name! Otherwise you could accidentally overwrite your system drive!

====Windows====

Use [https://github.com/balena-io/etcher Balena Etcha] to write the installer image to your SD card or eMMC drive.

===Boot into Debian Installer===

Insert your SD card or eMMC drive into the Star64 and switch it on.

Follow installation

In the tasks selection, enable SSH server

TODO: Notes on partitioning, how to use eMMC when installer is on eMMC.

===Final Steps===

Finish the installation" step of installer to ^a^n change 'screen' window over to command prompt in debian-installer and
$ cp -rT /target/lib/linux-image-*-riscv64 /target/boot/efi/dtb

[[Category:STAR64]]

User:Nuess0r/SandBox/Install Debian

2024-11-03T15:24:03Z

Nuess0r: Initial stub

=Install Debian on Star64=
{{Under construction}}
{{Warning | Attempting these instructions may permanently brick (make nonfunctional) your device. Do not attempt unless you know what you are doing.}}
{{Warning | These instructions have not been tested or verified. Use at your own risk.}}

This how-to guides you through the process to install Debian SID (unstable) on your Star64.

==Prerequisites==
Required:
*Star64 SBC
*Micro SDcard or Pine64 eMMC module
*USB serial converter with TTL output (No RS232 converter)
*Ability to network the Star64 to a computer over ethernet (Switch, Ethernet cables,...)
*Ability to write Micro SDcards or if you have only the eMMC module you also need the Pine64 eMMC USB programmer
*Computer running Linux

==Update U-Boot and SPL==
The Star64 ships with an integrated 128 megabit (16 megabyte) SPI NOR flash. Loaded on this flash from the factory is firmware called U-Boot and SPL but an old version designed for the StarFive VisionFive 2 SBC which is incompatible with the Star64 mainline Linux kernel (>= 6.11). The SPL (Secondary Program Loader) is the software that loads U-Boot, which in turn loads the Linux kernel. It performs similar functions to the BIOS on x86 platforms.

There are two main ways to update the SPI flash. The first uses the <code>flashcp</code> command which requires the Star64 to first boot into an OS. This method requires an OS able to boot from the old u-boot like Pinix from fishwaldo but unfortunately it doesn't ship with flashcp. The other method requires only the ability to load U-Boot and uses TFTP and the U-Boot <code>tftpboot</code> command.

===Preparing The TFTP Server and UART Connection===
====Linux====
First, on your computer (not the Star64) install a TFTP server and <code>wget</code> if you do not already have it.
$ sudo apt update && sudo apt install tftpd-hpa wget
Next, check that the TFPT server is running using <code>systemctl</code>.
$ sudo systemctl status tftpd-hpa
This should output somethng like

<span style="color:#16c60c">●</span> tftpd-hpa.service - LSB: HPA's tftp server
Loaded: loaded (/etc/init.d/tftpd-hpa; generated)
Active: <span style="color:#16c60c">active (running)</span> since Sat 2023-06-10 20:51:28 CDT; 17min ago
Docs: man:systemd-sysv-generator(8)
Process: 1016 ExecStart=/etc/init.d/tftpd-hpa start (code=exited, status=0/SUCCESS)
Tasks: 1 (limit: 2306)
Memory: 588.0K
CPU: 23ms
CGroup: /system.slice/tftpd-hpa.service
└─1023 /usr/sbin/in.tftpd --listen --user tftp --address :69 --secure /srv/tftp

Jun 10 20:51:28 debian-bookworm systemd[1]: Starting tftpd-hpa.service - LSB: HPA's tftp server...
Jun 10 20:51:28 debian-bookworm tftpd-hpa[1016]: Starting HPA's tftpd: in.tftpd.
Jun 10 20:51:28 debian-bookworm systemd[1]: Started tftpd-hpa.service - LSB: HPA's tftp server.

If the service is not running, try
$ sudo systemctl start tftpd-hpa
and check the status again. If it is still not running please join the #star64 channel in the Pine64 IRC, Discord, or Matrix.

Next in your home directory (<code>/home/user</code>) create a folder called <code>tftp_share</code>
$ mkdir /home/user/tftp_share
In this folder, download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image using <code>wget</code>.
$ cd /srv/tftp
$ sudo wget <nowiki>https://freeshell.de/e/riscv64/u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>
$ sudo unzip <nowiki>u-boot-20241028-428921_429908_429906_ocloaderase.zip</nowiki>

Before connecting to the Star64 and updating the firmware install minicom, virtual console software, so it will be possible to communicate with the Star64.
$ sudo apt update && sudo apt install minicom
Next connect your USB to TTL UART adapter to the computer and list the connected serial devices.

Find the address of the TTL UART to USB adapter in the list (example: <code>ttyUSB0</code>) and connect to the serial device with a baud rate of 115200.
$ sudo minicom -D /dev/<Device Address> -b 115200
Where <code><Device Address></code> is the address found in the step above. <span class="mw-customtoggle-device-address-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-device-address-toggle">
$ sudo minicom -D /dev/ttyUSB0 -b 115200
</div>

====Windows====

First, install two pieces of software, [https://pjo2.github.io/tftpd64/ tftpd64], a TFTP server for windows, and [http://ttssh2.osdn.jp/index.html.en Tera Term], a virtual console for interacting with the Star64 in U-Boot.
Next on your desktop, create a folder called <code>tftp_share</code>
In this folder, place the the <code>u-boot-spl.bin.normal.out</code> SPL file and the <code>u-boot.itb</code> U-Boot image from [u-boot-20241028-428921_429908_429906_ocloaderase.zip this Zip file].

Next, load tftpd64 and configure the settings to have the "Current Directory" as the <code>tftp_share</code> folder on the desktop and "Server interfaces" is set to <code>127.0.0.1 Software Loopback Interface 1</code>. The path should look something like <code>C:\Users\${Username}\Desktop\tftp_share</code> where <code>${Username}</code> is your username on Windows.
[[File:Star64 tftpd64 settings.png|none|500px|thumb|left]]

TODO: Short intro how to use Putty.

===Updating the SPI Flash===

[[File:STAR64-serial-pins.jpg|400px|thumb|right|Serial pins on the STAR64 I/O connector]]

Next, connect a TTL UART to USB cable to to the Star64 with the GND cable on pin 6 of the GPIO header, TXD on pin 8, and RXD on pin 10 as well as Ethernet. Note that depending on your UART adapter you may have to switch TXD and RXD. Now power on the Star64 and enter U-Boot. You will need to press a key to prevent it from autobooting and instead enter the U-Boot command prompt.
Once you are in the U-Boot shell set some environment variables.
First, set the IP address of the Star64 and connect it to the network using the <code>dhcp</code> command.
# dhcp

Set an environment variable of the TFTP server to make future command easier. If you don't what the IP address of your TFTP server is you can see connected devices in your router's configuration which can usually be accessed by typing in the IP address found on the router itself.
# setenv serverip <server IP>
Where <code>server IP</code> is the IP address of the TFTP server. <span class="mw-customtoggle-set-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-set-ip-addr-toggle">
# setenv serverip 192.168.1.199
</div>
Ping the TFTP server from the Star64 to make sure the connection works where <code><Server IP></code> refers to the IP address of your TFTP server. Note that if you are hosting the TFTP server on Windows, you may need to configure Windows firewall to allow <code>‘File and Printer Sharing (Echo Request – ICMPv4 – In)’</code>. This is only needed to test the network connection with <code>ping</code> and not for the actual <code>tftpboot</code> command so if <code>ping</code> fails <code>tftpboot</code> may still succeed.
# ping <server IP>
<span class="mw-customtoggle-ping-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ping-ip-addr-toggle">
# ping 192.168.1.199
</div>
The result should look something like this:
<pre>
Star64 # ping 192.168.1.199
Using ethernet@16030000 device
host 192.168.1.199 is alive
</pre>
If ping fails, please try again or please join the #star64 channel in the Pine64 IRC, Discord, or Matrix for help.

Finally, it is time to update the xSPI flash.

First, initialize the flash with the <code>sf probe</code> command.
# sf probe
The output should be something like:
<pre>
Star64 # sf probe
SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
</pre>
Next copy the SPL <code>.bin.normal.out</code> file to memory address 0xa0000000 from our TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo spl file]
Where ${serverip} is the environment variable we set earlier, no need to change it.
Then use <code>sf update</code> to erase and update the SPI flash from memory. In this case we are copying from memory address 0xa0000000 which we wrote to earlier with an offset of 0x0.

# sf update 0xa0000000 0x0 $filesize

Next, copy the U-Boot <code>.img</code> binary to memory address 0xa0000000 from the TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo uboot image]
Where ${serverip} is the environment variable we set earlier, no need to change it.

Finally, write the new U-Boot binary using <code>sf update</code> from memory address 0xa0000000 with an offset of 0x100000.
# sf update 0xa0000000 0x100000 $filesize

Reboot the Star64 and the changes should have taken effect.

On your Linux host, disable the TFTP server again, when you don't need it anymore:
$ sudo systemctl disable tftpd-hpa

==Install Debian==

===Prepare Debian Installation Media===

https://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/riscv64/iso-cd/

====Linux====
dd if=debian-testing-riscv64-netinst.iso of=/dev/sdX

====Windows====
Use etcher

===Boot into Debian Installer===

Follow installation

In the tasks selection, enable SSH server

TODO: Notes on partitioning, how to use eMMC when installer is on eMMC.

===Final Steps===

Finish the installation" step of installer to ^a^n change 'screen' window over to command prompt in debian-installer and
$ cp -rT /target/lib/linux-image-*-riscv64 /target/boot/efi/dtb

[[Category:STAR64]]

User:RemDogKap/SandBox/Update XSPI Flash SPL and U-Boot

2024-11-03T00:24:06Z

Nuess0r: Fix u-boot setenv command

{{Under construction}}
{{Warning | Attempting these instructions may permanently brick (make nonfunctional) your device. Do not attempt unless you know what you are doing.}}
{{Warning | These instructions have not been tested or verified. Use at your own risk.}}

The Star64 ships with an integrated 128 megabit (16 megabyte) xSPI NOR flash. Loaded on this flash from the factory is firmware called U-Boot and SPL but an old version designed for the StarFive VisionFive 2 SBC which may have incompatibilities with the Star64. The SPL or Secondary Program Loader is the software that loads U-Boot, which in turn loads the Linux kernel. The firmware on this flash is known as Das U-Boot, commonly just U-Boot which is an open-source primary boot loader. It performs similar functions to the BIOS on x86 platforms.

There are two main ways to update the xSPI flash. The first uses the <code>flashcp</code> command which requires the Star64 to first boot into an OS. This method may not work on older versions of [firmware, OS, something else????]. The other method requires only the ability to load U-Boot and uses TFTP and the U-Boot <code>tftpboot</code> command.

==Prerequisites==
Required:
*Star64 SBC
*Computer running Linux, MacOS, or Windows
Possibly required:
*Ability to communicate over TTL (transistor to transistor logic) UART
*Ability to network the Star64 to a computer over ethernet

==flashcp==
First, connect to your Star64 over UART or with a mouse, keyboard, and monitor.
Next, install the <code>mtd-utils</code> package onto the Star64 if not already installed. This package is a set of tools that allow access to raw flash storage devices such as the xSPI flash. Also install <code>wget</code> if not already installed. These instructions assume that you are using the <code>deb</code> package manager.
$ sudo apt update && sudo apt install mtb-utils wget

Next, using <code>wget</code> download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image onto the.
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo SPL file goes here]</nowiki>
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo U-Boot image goes here]</nowiki>

Next, print out the list of MTD (Memory Technology Device) raw flash devices using <code>cat</code>.
$ cat /proc/mtd

The output should look something like this:
<pre>
dev: size erasesize name
mtd0: 00020000 00001000 "spl"
mtd1: 00300000 00001000 "uboot"
mtd2: 00100000 00001000 "data"
</pre>

Finally, write the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image. to the respective partitions using <code>flashcp</code>, a command which writes to raw flash devices with more protections than <code>dd</code>.
$ flashcp -v [fishwaldo spl file name here].bin.normal.out /dev/<SPL Partition>
$ flashcp -v [fishwaldo uboot img file name here].img /dev/<U-Boot Partition>
Where <code><SPL Partition></code> is the partition name found under the "dev" column for the row "spl" from the cat printout, in this case <code>mtd0</code> and <code><U-Boot Partition></code> is the partition name found under the "dev" column for the row "uboot" in the cat printout, in this case <code>mtd1</code>.

At this point your xSPI flash has been rewritten and only a system restart is needed for the changes to take effect.

==tftpboot==
The <code>tftpboot</code> method uses a TFTP (Trivial File Transfer Protocol, a protocol which allows for basic file transfer functionality without authentication) server to transfer the SPL file and U-Boot image from a host computer to the Star64 running U-Boot and using the <code>tftpboot</code> command and then written to flash using the <code>sf</code> command which is a U-Boot command used to access SPI flash.

===Preparing The TFTP Server===
====Linux====
First, on your computer (not the Star64) install a TFTP server and <code>wget</code> if you do not already have it.
$ sudo apt update && sudo apt install tftpd-hpa wget
Next, check that the TFPT server is running using <code>systemctl</code>.
$ sudo systemctl status tftpd-hpa
This should output somethng like

<span style="color:#16c60c">●</span> tftpd-hpa.service - LSB: HPA's tftp server
Loaded: loaded (/etc/init.d/tftpd-hpa; generated)
Active: <span style="color:#16c60c">active (running)</span> since Sat 2023-06-10 20:51:28 CDT; 17min ago
Docs: man:systemd-sysv-generator(8)
Process: 1016 ExecStart=/etc/init.d/tftpd-hpa start (code=exited, status=0/SUCCESS)
Tasks: 1 (limit: 2306)
Memory: 588.0K
CPU: 23ms
CGroup: /system.slice/tftpd-hpa.service
└─1023 /usr/sbin/in.tftpd --listen --user tftp --address :69 --secure /srv/tftp

Jun 10 20:51:28 debian-bookworm systemd[1]: Starting tftpd-hpa.service - LSB: HPA's tftp server...
Jun 10 20:51:28 debian-bookworm tftpd-hpa[1016]: Starting HPA's tftpd: in.tftpd.
Jun 10 20:51:28 debian-bookworm systemd[1]: Started tftpd-hpa.service - LSB: HPA's tftp server.

If the service is not running, try
$ sudo systemctl start tftpd-hpa
and check the status again. If it is still not running please join the #star64 channel in the Pine64 IRC, Discord, or Matrix.

Next, edit the configuration file for <code>tftpd-hpa</code>.
$ sudo nano /etc/default/tftpd-hpa
by default it should look like:
<pre>
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/srv/tftp"
TFTP_ADDRESS=":69"
TFTP_OPTIONS="--secure"
</pre>
Change <code>TFTP_DIRECTORY="/srv/tftp"</code> to <code>TFTP_DIRECTORY="/home/user/tftp_share"</code>. The final file should look like:
<pre>
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/home/<user>/tftp_share"
TFTP_ADDRESS=":69"
TFTP_OPTIONS="--secure"
</pre>
Where <code>user</code> is your username.
After that, save and close the file then restart the TFTP server.
$ sudo systemctl restart tftpd-hpa

Next in your home directory (<code>/home/user</code>) create a folder called <code>tftp_share</code>
$ mkdir /home/user/tftp_share
In this folder, download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image using <code>wget</code>.
$ cd /home/user/tftp_share
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo SPL file goes here]</nowiki>
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo U-Boot image goes here]</nowiki>

Before connecting to the Star64 and updating the firmware install minicom, virtual console software, so it will be possible to communicate with the Star64.
$ sudo apt update && sudo apt install minicom
Next connect the your USB to TTL UART adapter to the computer and list the connected serial devices.
$ dmesg | grep tty
Example output:
<pre>
to be
filled in
later
</pre>
Find the address of the TTL UART to USB adapter in the list (example: <code>ttyUSB0</code>) and connect to the serial device with a baud rate of 115200.
$ sudo minicom -D /dev/<Device Address> -b 115200
Where <code><Device Address></code> is the address found in the step above. <span class="mw-customtoggle-device-address-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-device-address-toggle">
$ sudo minicom -D /dev/ttyUSB0 -b 115200
</div>

====Windows====

First, install two pieces of software, [https://pjo2.github.io/tftpd64/ tftpd64], a TFTP server for windows, and [http://ttssh2.osdn.jp/index.html.en Tera Term], a virtual console for interacting with the Star64 in U-Boot.
Next on your desktop, create a folder called <code>tftp_share</code>
In this folder, download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image from [https://pine64.my-ho.st:8443/ here].

Next, load tftpd64 and configure the settings to have the "Current Directory" as the <code>tftp_share</code> folder on the desktop and "Server interfaces" is set to <code>127.0.0.1 Software Loopback Interface 1</code>. The path should look something like <code>C:\Users\${Username}\Desktop\tftp_share</code> where <code>${Username}</code> is your username on Windows.
[[File:Star64 tftpd64 settings.png|none|500px|thumb|left]]

===Updating the SPI Flash===

Next, connect a TTL UART to USB cable to to the Star64 with the GND cable on pin 6 of the GPIO header, TXD on pin 8, and RXD on pin 10 as well as ethernet. Note that depending on your UART adapter you may have to switch TXD and RXD. Now power on the Star64 and enter U-Boot. You will need to press a key to prevent it from autobooting and instead enter the U-Boot command prompt.
Once you are in the U-Boot shell set some environment variables.
First, set the IP address of the Star64 and connect it to the network using the <code>dhcp</code> command.
# dhcp

Set an environment variable of the TFTP server to make future command easier. If you don't what the IP address of your TFTP server is you can see connected devices in your router's configuration which can usually be accessed by typing in the IP address found on the router itself.
# setenv serverip <server IP>
Where <code>server IP</code> is the IP address of the TFTP server. <span class="mw-customtoggle-set-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-set-ip-addr-toggle">
# setenv serverip 192.168.1.199
</div>
Ping the TFTP server from the Star64 to make sure the connection works where <code><Server IP></code> refers to the IP address of your TFTP server. Note that if you are hosting the TFTP server on Windows, you may need to configure Windows firewall to allow <code>‘File and Printer Sharing (Echo Request – ICMPv4 – In)’</code>. This is only needed to test the network connection with <code>ping</code> and not for the actual <code>tftpboot</code> command so if <code>ping</code> fails <code>tftpboot</code> may still succeed.
# ping <server IP>
<span class="mw-customtoggle-ping-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ping-ip-addr-toggle">
# ping 192.168.1.199
</div>
The result should look something like this:
<pre>
Star64 # ping 192.168.1.199
Using ethernet@16030000 device
host 192.168.1.199 is alive
</pre>
If ping fails, please try again or please join the #star64 channel in the Pine64 IRC, Discord, or Matrix for help.

Finally, it is time to update the xSPI flash.

First, initialize the flash with the <code>sf probe</code> command.
# sf probe
The output should be something like:
<pre>
Star64 # sf probe
SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
</pre>
Next copy the SPL <code>.bin.normal.out</code> file to memory address 0xa0000000 from our TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo spl file]
Where ${serverip} is the environment variable we set earlier, no need to change it.
Then use <code>sf update</code> to erase and update the SPI flash from memory. In this case we are copying from memory address 0xa0000000 which we wrote to earlier with an offset of 0x0.

# sf update 0xa0000000 0x0 $filesize

This should produce an output like:
<pre>
To be
filled
in later
</pre>

Next, copy the U-Boot <code>.img</code> binary to memory address 0xa0000000 from the TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo uboot image]
Where ${serverip} is the environment variable we set earlier, no need to change it.

Finally, write the new U-Boot binary using <code>sf update</code> from memory address 0xa0000000 with an offset of 0x100000.
# sf update 0xa0000000 0x100000 $filesize

This should produce an output like:
<pre>
To be
filled
in later
</pre>

Reboot the Star64 and the changes should have taken effect.

[[Category:STAR64]]

NASCase-STAR64

2024-11-02T21:23:43Z

Nuess0r: Adding PC fan adapter cable as alternative for fan connector modification

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*Medium heatsink (N.B. Any of the three available heatsinks will fit in the NAS Case but the medium one suites best for the NAS Case airflow)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch or a [https://www.tindie.com/products/brain4free/star64-fan-adapter-cable/ PC fan adapter cable] (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector (U26) on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and if you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again in the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and is not reachable without partial disassembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Install the STAR64 by placing it with the USB connectors and power button first with a slight angle into the case.]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.]]

Make sure nothing is plugged into your STAR64 - including antennas and micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable to socket U25]]
[[File:Star64-fan-adapter-cable.jpg|200px|thumb|right|Alternatively use an adapter cable for 3 or 4 pin PC fans]]
The eMMC is fitted into its respective placement on the STAR64 board - please consult the diagram for their correct installation.

When you don't bought the PC fan adapter cable or using another 12 V fan then you have to mount the 3 pin, 2 mm pitch JST connector before mounting the fan into the NAS case.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for positive pressure, blowing air into the case rather than taking air out. A positive pressure configuration both allows a filter to be placed over the intake to prevent dust ingress and the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades. For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation (Socket U25) and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:Star64-map-connectors.svg|200px|thumb|left|U26 is the DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

File:Star64-fan-adapter-cable.jpg

2024-11-02T21:08:41Z

Nuess0r: Add source link and category

== Summary ==
Adapter cable to connect normal computer fans (3 or 4 pin connector) to a Star64

Available from [https://www.tindie.com/products/brain4free/star64-fan-adapter-cable/ tindie.com]

[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:Star64-fan-adapter-cable.jpg

2024-11-02T21:06:26Z

Nuess0r: Adapter cable to connect normal computer fans (3 or 4 pin connector) to a Star64

== Summary ==
Adapter cable to connect normal computer fans (3 or 4 pin connector) to a Star64
== Licensing ==
{{CC0}}

File:Star64 tftpd64 settings.png

2024-09-23T20:50:14Z

Nuess0r: Added to STAR64 category

== Summary ==
screenshot of settings for tftpd64 server on windows to flash U-Boot to Star64
== Licensing ==
{{PD|PD}}

[[Category:STAR64]]

File:Star64-map-connectors.svg

2024-09-23T20:48:14Z

Nuess0r: Added to STAR64 category

== Summary ==
A map of the STAR64 connectors

[[Category:STAR64]]

STAR64

2023-09-06T18:19:27Z

Nuess0r: Add NAS case compatibility

[[File:Star64.jpg|400px|thumb|right|The STAR64]]

The '''Star64''' is a RISC-V based Single Board Computer powered by StarFive JH7110 Quad-Core SiFive U74 64-Bit CPU, Imagination Technology BX-4-32 GPU and supports up to 8GB 1866MHz LPDDR4 memory. It provides an eMMC module socket, MicroSD Card slot, PCI-e, Pi-2 Bus, USB 3.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software releases ==

The releases are still in '''alpha''' state and are only fit for testing purposes.

* [https://github.com/Fishwaldo/meta-pine64 A Set of Images built with Yocto for commandline, weston and plasma - Where possible, GPU/VPU acceleration is enabled.]
* [https://forum.pine64.org/showthread.php?tid=18276 Armbian]
* [https://sr.ht/~fgaz/nixos-star64/ NixOS], based on the [https://github.com/NixOS/nixos-hardware/tree/master/pine64/star64 the nixos-hardware configuration]
* [https://www.hackster.io/lupyuen/rtos-on-a-risc-v-sbc-star64-jh7110-apache-nuttx-2a7429 Apache NuttX RTOS]

== SoC and Memory Specification ==
* Based on [https://www.starfivetech.com/en/site/soc StarFive JH7110]

[[File:StarFive.jpg|right]]
[[File:JH7110_Block_Diagram.png|800px]]

=== CPU Architecture ===
* [https://www.sifive.com/cores/u74 Quad-core U74 up to 1.5GHz CPU]
[[File:SiFive.jpg|right|200px]]
* Fully compliant with the RISC-V ISA specification
* 64-bit RISC-V Application Core
* 32KB L1 I-cache with ECC
* 32KB L1 D-cache with ECC
* 8 Region Physical Memory Protection
* Virtual Memory support with up to 47 Physical Address bits
* Integrated up to 2MB L2 Cache with ECC
* includes RV64IMAC S7 monitor core, 16 KB L1 I-Cache with ECC, 8 KB DTIM with ECC
* 32-bit RISC-V CPU core (E24) for real time control, support RV32IMFC RISC-V ISA

=== GPU Architecture ===
* [https://www.imaginationtech.com/product/img-bxe-4-32-mc4/ Imagination Technology BXE-4-32 up to 600Mhz GPU]
[[File:imgtech.png|right|200px]]
* Support OpenCL 3.0
* Support OpenGL ES 3.2
* Support Vulkan 1.2
* Tile-based deferred rendering architecture for 3D graphics workloads, with concurrent processing of multiple tiles
* Support for GPU visualization, up to 8 virtual GPUs
* On fly frame buffer compression and decompression (TFBC) algorithm
* Performance: 128 FP32 FLOPs/Clock, 256 FP16 FLOPs/Clock

=== System Memory ===
* LPDDR4 RAM Memory Variants: 2GB, 4GB and 8GB.

== Board Features ==

=== Video ===
* Digital Video output up to 4K@30Hz
* 4K HDR @ 60fps
* H.264/AVC Base/Main/High/High10 profile @ level 5.1; up to 4K×2K @ 60fps
* H.265/HEVC Main/Main10 profile @ level 5.1 High-tier; up to 4K×2K @ 60fps

=== Audio ===
* 3.5mm audio Jack

=== Network ===
* Single or Dual 10/100/1000Mbps Ethernet
* 2.4GHz/5Ghz MIMO WiFi 802.11 b/g/n/ac with Bluetooth 5.2

=== Storage ===
* on-board 128Mbit (16MByte) XSPI NOR flash memory - bootable
* microSD - bootable, supports SDHC and SDXC and storage up to 256GB
* eMMC - bootable (optional eMMC Module)
* 1× USB3.0 Dedicated Host port
* 3× USB2.0 Host port

=== Expansion Ports ===
* PCIe 2.0 ×1 lane
* 2×20 pins "Pi2" GPIO Header
** The JH7110 SoC supports full multiplexing of its GPIO pins. This means any non-power/ground pin can be configured to any function outlined in Table 4-2 of the SoC datasheet.
* 4 lane MiPi DSI port for LCD panel
* 4 lane MiPi CSI port for camera module

== Board Information, Schematics and Certifications ==
Model "A" Baseboard Dimensions: 133mm×80mm×19mm

Input Power: DC 12V @ 3A 5.5mmOD/2.1mmID center-positive Barrel DC Jack connector

Schematic:
* [https://files.pine64.org/doc/star64/Star64_Schematic_V1.1_20230504.pdf STAR64 Schematic 20230504 v1.1 (Production Released version)]
* [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf STAR64 Schematic 20220721 v1.0 (Prototype Board)]

Certifications:
* Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submits the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
* Not yet available

== Datasheets for Components and Peripherals ==

Star64 JH7110 SoC information:
* [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Product_Brief.pdf StarFive JH7110 SoC Product Brief]
* [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Datasheet.pdf StarFive JH7110 SoC Datasheet]
* [https://doc-en.rvspace.org/JH7110/TRM/ StarFive JH7110 SoC Technical Reference Manual]

X-Power PMU information:
* [https://files.pine64.org/doc/datasheet/star64/AXP15060%20datasheet%20V0.1.pdf X-Power AXP15060 Datasheet V0.1]

LPDDR4 (200 Balls) SDRAM:
* [https://files.pine64.org/doc/datasheet/rockpro64/SM512M32Z01MD2BNP(200BALL).pdf Micron LPDDR4 Mobile LPDDR4 Datasheet]

eMMC information:
* [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
* [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
* [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
* [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
* [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]

SPI NOR Flash information:
* [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]

Ethernet related info:
* TBA

WiFi/BT module info:
* [https://files.pine64.org/doc/datasheet/star64/Fn-Link_6252B-UUB_datasheet_V1.1_20220329.pdf Fn-Link 6252B 11AC Dual Band 2T2R WiFi + Bluetooth5.2 Datasheet]

== Bringup Notes ==

# The USB over-current protection is not wired up correctly to the USB ports on Star64. The default Starfive Kernel will disable USB on boot as it belives the ports are overcurrent. This ugly hack works around it: https://github.com/Fishwaldo/Star64_linux/commit/2634a13ecfa1fa5c232ec2b9f6a6b6b0d9d66898
# The Wifi Chip (RTL8852BU) is not supported in the kernel. There is a Vendor Driver that is imported in the kernel at https://github.com/Fishwaldo/Star64_linux/tree/Star64_devel/drivers/staging/rtl8852bu but it really needs a cleanup. It does BUG_ON at boot, but wifi is confirmed working.
# HDMI can be finicky. 4K Monitors are known to have a issue. This is also relevant for VisionFive2
# Some kernels/distributions do not detect the total memory correctly. This is due to the way u-boot is configured. Currently, u-boot reads the memory from the eeprom on the Star64, and updates the dtb file before booting the kernel. Distributions that boot differently may not get the updated dtb file with the correct memory entry. You can work around this by recompiling the DTB with the correct memory for your board
# VisionFive2 Kernels will only offer limited functionality on the Star64 - Mainly USB, Wifi and PCI will not work.
# The 4-pin 12 volt JST-XH-4A connector found on the Star64 is incompatible with the dual SATA power adapter intended for the ROCKPro64. The connector on the Star64 is rotated 180 degrees to the one on the ROCKPro64, resulting in the cable receiving +12V where GND is expected and vice versa. The cable's internal circuitry ends up shorting in this configuration.
# Booting from uSD: Component S1804 is adjacent to the 40pin GPIO Bus; ignore the printed text on S1804 that says "ON" or "ONKE". Do pay attention to the '1' and '2' printed on S1804. Also pay attention to the 'L' and 'H' text on the board next to S1804. The 'L' stand for '0' and the 'H' stands for '1'. You will need to flip switch '1' (GPIO_1) on S1804 to the 'L' position and switch '2' (GPIO_0) on S1804 to the 'H' position. S1804 maps to the table next to S1804 that has text [ [GPIO_1 | GPIO_0], [0|0] Flash, [0|1] SD, [1|0] EMMC, [1|1] UART ]; Helpful links: https://mrrcode979.github.io/blog/post/star64-guide/, https://www.bortzmeyer.org/star64-first-boot.html
# TTL use notes: Ground is on pin 6, RXD is on pin 8, and TXD is on pin 10.

== LEDs ==

The LEDs can be configured to stop blinking. Under Linux this can be done using the following command (as root):

echo "default-on" > /sys/devices/platform/leds/leds/blue-led/trigger

To list possible other triggers for the blue LED:

cat /sys/devices/platform/leds/leds/blue-led/trigger

An example for a trigger is ''activity'', where the the blue LED reflects the CPU activity.

== Potential Issues ==

<onlyinclude>
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 initilize
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.
</onlyinclude>

== Casing/Enclosure Compatibility ==

The table below collect known information about casing and enclosure compatibility for the Star64 sbc.

{| class="wikitable" style="margin:auto"
|+ Casing and enclosure compatibility for Star64
|-
! Casing/Enclosure !! Compatible !! Notes
|-
| [[ROCK64_Premium_Aluminum_Casing|ROCKPro64 PREMIUM ALUMINUM CASING]] || No || Star64 has two stacked ethernet ports, making it too tall. Also, audio jack is too large and there is a USB type A instead of a USB type C port.
|-
| [[NASCase-STAR64|NAS Case]] || Yes || Micro SD slot and Second Gigabit Ethernet port are not accessible without modification
|}

== Prototype Bringup Notes ==

Note: This section is relevant to the original prototype (v1.0) that a few developers received.

# The [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf schematic] has several discrepancies with actual board labels.
# The serial console can be found with TXD on pin 8 and RXD on pin 10; a convention common to Pi-style boards. Use the 40pin header pinouts in color on page one and not the schematic prose.
# If you have only a single core running and no PCI card present, it appears to power up via the +5V/GND lines from the USB serial adapter pins.
# It will not boot from a VisionFive R1 uSD card.
# The boot device switch labels and the silk screen are inverted. "0" means "On".
# 2021.10-00001-gdbdaad919b will attempt to boot from SPI, but it appears blank. If you let it for many minutes, the device will eventually time out and boot OpenSBI v1.0 from (SPI?). This will fail, but only after self-identifying as a VisionFive R2, complete with five cores and 4 GB of RAM, before failing. A "press any key" timeout is offered, but I've been unable to make it stop. It will eventually crash with:

Loading Environment from SPIFlash... SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
*** Warning - bad CRC, using default environment

Not a StarFive EEPROM data format - magic error

[[Category:STAR64]] [[Category:StarFive JH7110]]

NASCase-STAR64

2023-08-01T19:57:01Z

Nuess0r:

{{Under construction}}

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*Medium heatsink (N.B. Any of the three available heatsinks will fit in the NAS Case but the medium one suites best for the NAS Case airflow)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and it you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again in the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and is not reachable without partial disassembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Install the STAR64 by placing it with the USB connectors and power button first with a slight angle into the case.]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.]]

Make sure nothing is plugged into your STAR64 - including antennas and micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

NASCase-STAR64

2023-07-22T20:19:41Z

Nuess0r: typo

{{Under construction}}

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and it you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again in the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and is not reachable without partial disassembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Install the STAR64 by placing it with the USB connectors and power button first with a slight angle into the case.]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.]]

Make sure nothing is plugged into your STAR64 - including antennas and micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

NASCase-STAR64

2023-07-22T20:17:37Z

Nuess0r:

{{Under construction}}

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and it you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again the the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and is not reachable without partial disassembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Install the STAR64 by placing it with the USB connectors and power button first with a slight angle into the case.]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.]]

Make sure nothing is plugged into your STAR64 - including antennas and micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

NASCase-STAR64

2023-07-22T20:15:13Z

Nuess0r: small clean-up

{{Under construction}}

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and it you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again the the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and is not reachable without partial disassembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]

Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

User:RemDogKap/SandBox/Update XSPI Flash SPL and U-Boot

2023-07-17T19:53:14Z

Nuess0r: Change order of SPL and U-Boot description to follow their execution order.

{{Under construction}}
{{Warning | Attempting these instructions may permanently brick (make nonfunctional) your device. Do not attempt unless you know what you are doing.}}
{{Warning | These instructions have not been tested or verified. Use at your own risk.}}

The Star64 ships with an integrated 128 megabit (16 megabyte) xSPI NOR flash. Loaded on this flash from the factory is firmware called U-Boot and SPL but an old version designed for the StarFive VisionFive 2 SBC which may have incompatibilities with the Star64. The SPL or Secondary Program Loader is the software that loads U-Boot, which in turn loads the Linux kernel. The firmware on this flash is known as Das U-Boot, commonly just U-Boot which is an open-source primary boot loader. It performs similar functions to the BIOS on x86 platforms.

There are two main ways to update the xSPI flash. The first uses the <code>flashcp</code> command which requires the Star64 to first boot into an OS. This method may not work on older versions of [firmware, OS, something else????]. The other method requires only the ability to load U-Boot and uses TFTP and the U-Boot <code>tftpboot</code> command.

==Prerequisites==
Required:
*Star64 SBC
*Computer running Linux, MacOS, or Windows
Possibly required:
*Ability to communicate over TTL (transistor to transistor logic) UART
*Ability to network the Star64 to a computer over ethernet

==flashcp==
First, connect to your Star64 over UART or with a mouse, keyboard, and monitor.
Next, install the <code>mtd-utils</code> package onto the Star64 if not already installed. This package is a set of tools that allow access to raw flash storage devices such as the xSPI flash. Also install <code>wget</code> if not already installed. These instructions assume that you are using the <code>deb</code> package manager.
$ sudo apt update && sudo apt install mtb-utils wget

Next, using <code>wget</code> download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image onto the.
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo SPL file goes here]</nowiki>
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo U-Boot image goes here]</nowiki>

Next, print out the list of MTD (Memory Technology Device) raw flash devices using <code>cat</code>.
$ cat /proc/mtd

The output should look something like this:
<pre>
dev: size erasesize name
mtd0: 00020000 00001000 "spl"
mtd1: 00300000 00001000 "uboot"
mtd2: 00100000 00001000 "data"
</pre>

Finally, write the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image. to the respective partitions using <code>flashcp</code>, a command which writes to raw flash devices with more protections than <code>dd</code>.
$ flashcp -v [fishwaldo spl file name here].bin.normal.out /dev/<SPL Partition>
$ flashcp -v [fishwaldo uboot img file name here].img /dev/<U-Boot Partition>
Where <code><SPL Partition></code> is the partition name found under the "dev" column for the row "spl" from the cat printout, in this case <code>mtd0</code> and <code><U-Boot Partition></code> is the partition name found under the "dev" column for the row "uboot" in the cat printout, in this case <code>mtd1</code>.

At this point your xSPI flash has been rewritten and only a system restart is needed for the changes to take effect.

==tftpboot==
The <code>tftpboot</code> method uses a TFTP (Trivial File Transfer Protocol, a protocol which allows for basic file transfer functionality without authentication) server to transfer the SPL file and U-Boot image from a host computer to the Star64 running U-Boot and using the <code>tftpboot</code> command and then written to flash using the <code>sf</code> command which is a U-Boot command used to access SPI flash.

===Preparing The TFTP Server===
====Linux====
First, on your computer (not the Star64) install a TFTP server and <code>wget</code> if you do not already have it.
$ sudo apt update && sudo apt install tftpd-hpa wget
Next, check that the TFPT server is running using <code>systemctl</code>.
$ sudo systemctl status tftpd-hpa
This should output somethng like

<span style="color:#16c60c">●</span> tftpd-hpa.service - LSB: HPA's tftp server
Loaded: loaded (/etc/init.d/tftpd-hpa; generated)
Active: <span style="color:#16c60c">active (running)</span> since Sat 2023-06-10 20:51:28 CDT; 17min ago
Docs: man:systemd-sysv-generator(8)
Process: 1016 ExecStart=/etc/init.d/tftpd-hpa start (code=exited, status=0/SUCCESS)
Tasks: 1 (limit: 2306)
Memory: 588.0K
CPU: 23ms
CGroup: /system.slice/tftpd-hpa.service
└─1023 /usr/sbin/in.tftpd --listen --user tftp --address :69 --secure /srv/tftp

Jun 10 20:51:28 debian-bookworm systemd[1]: Starting tftpd-hpa.service - LSB: HPA's tftp server...
Jun 10 20:51:28 debian-bookworm tftpd-hpa[1016]: Starting HPA's tftpd: in.tftpd.
Jun 10 20:51:28 debian-bookworm systemd[1]: Started tftpd-hpa.service - LSB: HPA's tftp server.

If the service is not running, try
$ sudo systemctl start tftpd-hpa
and check the status again. If it is still not running please join the #star64 channel in the Pine64 IRC, Discord, or Matrix.

Next, edit the configuration file for <code>tftpd-hpa</code>.
$ sudo nano /etc/default/tftpd-hpa
by default it should look like:
<pre>
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/srv/tftp"
TFTP_ADDRESS=":69"
TFTP_OPTIONS="--secure"
</pre>
Change <code>TFTP_DIRECTORY="/srv/tftp"</code> to <code>TFTP_DIRECTORY="/home/user/tftp_share"</code>. The final file should look like:
<pre>
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/home/<user>/tftp_share"
TFTP_ADDRESS=":69"
TFTP_OPTIONS="--secure"
</pre>
Where <code>user</code> is your username.
After that, save and close the file then restart the TFTP server.
$ sudo systemctl restart tftpd-hpa

Next in your home directory (<code>/home/user</code>) create a folder called <code>tftp_share</code>
$ mkdir /home/user/tftp_share
In this folder, download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image using <code>wget</code>.
$ cd /home/user/tftp_share
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo SPL file goes here]</nowiki>
$ wget <nowiki>https://pine64.my-ho.st:8443/[fishwaldo U-Boot image goes here]</nowiki>

Before connecting to the Star64 and updating the firmware install minicom, virtual console software, so it will be possible to communicate with the Star64.
$ sudo apt update && sudo apt install minicom
Next connect the your USB to TTL UART adapter to the computer and list the connected serial devices.
$ dmesg | grep tty
Example output:
<pre>
to be
filled in
later
</pre>
Find the address of the TTL UART to USB adapter in the list (example: <code>ttyUSB0</code>) and connect to the serial device with a baud rate of 115200.
$ sudo minicom -D /dev/<Device Address> -b 115200
Where <code><Device Address></code> is the address found in the step above. <span class="mw-customtoggle-device-address-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-device-address-toggle">
$ sudo minicom -D /dev/ttyUSB0 -b 115200
</div>

====Windows====

First, install two pieces of software, [https://pjo2.github.io/tftpd64/ tftpd64], a TFTP server for windows, and [http://ttssh2.osdn.jp/index.html.en Tera Term], a virtual console for interacting with the Star64 in U-Boot.
Next on your desktop, create a folder called <code>tftp_share</code>
In this folder, download the <code>.bin.normal.out</code> SPL file and the <code>.img</code> U-Boot image from [https://pine64.my-ho.st:8443/ here].

Next, load tftpd64 and configure the settings to have the "Current Directory" as the <code>tftp_share</code> folder on the desktop and "Server interfaces" is set to <code>127.0.0.1 Software Loopback Interface 1</code>. The path should look something like <code>C:\Users\${Username}\Desktop\tftp_share</code> where <code>${Username}</code> is your username on Windows.
[[File:Star64 tftpd64 settings.png|none|500px|thumb|left]]

===Updating the SPI Flash===

Next, connect a TTL UART to USB cable to to the Star64 with the GND cable on pin 6 of the GPIO header, TXD on pin 8, and RXD on pin 10 as well as ethernet. Note that depending on your UART adapter you may have to switch TXD and RXD. Now power on the Star64 and enter U-Boot. You will need to press a key to prevent it from autobooting and instead enter the U-Boot command prompt.
Once you are in the U-Boot shell set some environment variables.
First, set the IP address of the Star64 and connect it to the network using the <code>dhcp</code> command.
# dhcp

Set an environment variable of the TFTP server to make future command easier. If you don't what the IP address of your TFTP server is you can see connected devices in your router's configuration which can usually be accessed by typing in the IP address found on the router itself.
# setenv <server IP>
Where <code>server IP</code> is the IP address of the TFTP server. <span class="mw-customtoggle-set-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-set-ip-addr-toggle">
# setenv 192.168.1.199
</div>
Ping the TFTP server from the Star64 to make sure the connection works where <code><Server IP></code> refers to the IP address of your TFTP server. Note that if you are hosting the TFTP server on Windows, you may need to configure Windows firewall to allow <code>‘File and Printer Sharing (Echo Request – ICMPv4 – In)’</code>. This is only needed to test the network connection with <code>ping</code> and not for the actual <code>tftpboot</code> command so if <code>ping</code> fails <code>tftpboot</code> may still succeed.
# ping <Server IP>
<span class="mw-customtoggle-ping-ip-addr-toggle" style="text-decoration:underline;color:#0645ad">Example</span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ping-ip-addr-toggle">
# ping 192.168.1.228
</div>
The result should look something like this:
<pre>
Star64 # ping 192.168.1.199
Using ethernet@16030000 device
host 192.168.1.199 is alive
</pre>
If ping fails, please try again or please join the #star64 channel in the Pine64 IRC, Discord, or Matrix for help.

Finally, it is time to update the xSPI flash.

First, initialize the flash with the <code>sf probe</code> command.
# sf probe
The output should be something like:
<pre>
Star64 # sf probe
SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
</pre>
Next copy the SPL <code>.bin.normal.out</code> file to memory address 0xa0000000 from our TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo spl file]
Where ${serverip} is the environment variable we set earlier, no need to change it.
Then use <code>sf update</code> to erase and update the SPI flash from memory. In this case we are copying from memory address 0xa0000000 which we wrote to earlier with an offset of 0x0.

# sf update 0xa0000000 0x0 $filesize

This should produce an output like:
<pre>
To be
filled
in later
</pre>

Next, copy the U-Boot <code>.img</code> binary to memory address 0xa0000000 from the TFTP server.
# tftpboot 0xa0000000 ${serverip}:[name of fishwaldo uboot image]
Where ${serverip} is the environment variable we set earlier, no need to change it.

Finally, write the new U-Boot binary using <code>sf update</code> from memory address 0xa0000000 with an offset of 0x100000.
# sf update 0xa0000000 0x100000 $filesize

This should produce an output like:
<pre>
To be
filled
in later
</pre>

Reboot the Star64 and the changes should have taken effect.

[[Category:STAR64]]

Recovering the Bootloader for STAR64 JH7710 over serial using screen

2023-07-12T06:33:52Z

Nuess0r: Added picture for serial wiring

{{Under construction}}

== STAR64 serial wiring ==
Connect a USB to serial converter cable with 3.3 V TTL levels to your STAR64 to the pins 4 (GND), 6 (TXD) and 8 (RXD).

Avoid the pins below pin 6; those are 5 V which is enough to mess up most serial cables.

[[File:STAR64-serial-pins.jpg|400px|thumb|left|Serial pins on the STAR64 I/O connector]]

<div style="clear: both"></div>
== Recovering the Bootloader for STAR64 JH7710 over serial using screen ==
<syntaxhighlight lang="sh">
cd <path-to-directory-with-Tools>
screen -m -S star64 /dev/ttyUSB0 115200
# open a second shell
screen -S star64 -X exec \!\! sx Tools/recovery/jh7110-recovery-20230322.bin
# type 0 in the first shell
screen -S star64 -X exec \!\! sx u-boot/spl/u-boot-spl.bin.normal.out # file created with: ../Tools/spl_tool/spl_tool -c -f spl/u-boot-spl.bin
# type 2 in the first shell
screen -S star64 -X exec \!\! sx u-boot/u-boot.itb # file created with: tools/mkimage -f ../Tools/uboot_its/visionfive2-uboot-fit-image.its -A riscv -O u-boot -T firmware u-boot.itb
</syntaxhighlight>

== Backup current SPI ==
=== Using Linux ===
Execute the commands on the star64 (takes some time):
<syntaxhighlight lang="sh">
dd if=/dev/mtd0 of=/tmp/star64-factory-spl.bin
dd if=/dev/mtd1 of=/tmp/star64-factory-uboot.bin
dd if=/dev/mtd2 of=/tmp/star64-factory-data.bin
</syntaxhighlight>

Execute on you host:
<syntaxhighlight lang="sh">
rsync ${MNAME}:'/tmp/star64-factory-*' .
</syntaxhighlight>

== References ==
* [https://github.com/starfive-tech/Tools/blob/master/README.md#recovery Tools README.md about recovery]
* [https://doc-en.rvspace.org/VisionFive2/PDF/VisionFive2_QSG.pdf#page=40 VisionFive 2 Single Board Computer Quick Start Guide: 4.4. Recovering the Bootloader p. 40]
* [https://doc-en.rvspace.org/VisionFive2/PDF/VisionFive2_SDK_QSG.pdf#page=19 VisionFive 2 SDK Quick Start Guide: 7.4. Recovering the Bootloader p. 19]

[[Category:STAR64]]

File:STAR64-serial-pins.jpg

2023-07-12T06:25:38Z

Nuess0r: Category:STAR64

== Summary ==

[[Category:STAR64]]
== Licensing ==
{{cc-by-sa-4.0}}

NASCase-STAR64

2023-07-08T15:42:19Z

Nuess0r: Added description to modify the HDD power cable for STAR64

{{Under construction}}

'''Modification of HDD power cable missing'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Follow [[User:RemDogKap/SandBox/First_Setup|First Setup]] to install an operating system and test if it boots.

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
[[File:STAR64-HDD-power-cable-remove-pins.jpg|200px|thumb|right|Modifying the HDD power cable for STAR64]]
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

As the HDD power connector on the STAR64 revision 1.0 and 1.1 is reversed compared to the ROCKPro64 you have to modify the SATA power cable. Use a flat headed screw driver to push down the retention lever of the crimp contact and pull it out of the connector housing at the same time. Take your time, it's a bit fiddly and it you use too much force you will damage the crimp contact and you will need to order replacements.

First remove the two outer black and yellow pin, insert them again the the other position. Repeat with the two inner pins. Black and yellow cables are now swapped and ready for the STAR64.

<div style="clear: both"></div>
===Step 2. Install operating system===
[[File:Star64 EMMC switch map.png |200px|thumb|right|Correct DIP switch settings to boot from eMMC for the Star64 SBC.]]
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the boot mode is below the HDD cage and not reachable without partial disasembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]

Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

File:STAR64-HDD-power-cable-remove-pins.jpg

2023-07-08T15:37:45Z

Nuess0r:

== Summary ==
Modifying the HDD power cable for STAR64
[[Category:STAR64]]

== Licensing ==
{{CC0}}

User:RemDogKap/SandBox/First Setup

2023-07-06T21:44:09Z

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

{{Under construction}}

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

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 [[User:RemDogKap/SandBox/Status of Features | 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 <code>bzip2</code> and <code>wget</code>.
$ sudo apt update && sudo apt install bzip2 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>

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>

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

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

$ 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 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">
$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 | sudo dd of=/dev/sdh
</div>

====Windows====

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

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.

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.

<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}}

User:RemDogKap/SandBox/First Setup

2023-07-06T21:42:04Z

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.

{{Under construction}}

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

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 [[User:RemDogKap/SandBox/Status of Features | 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 <code>bzip2</code> and <code>wget</code>.
$ sudo apt update && sudo apt install bzip2 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>

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>

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

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

$ 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 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">
$ bzip2 -cd star64-image-minimal-star64-1.3.rootfs.wic.bz2 | sudo dd of=/dev/sdb
</div>

====Windows====

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

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.

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.

<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}}

User:RemDogKap/SandBox/Status of Features

2023-07-06T06:07:10Z

Nuess0r: Adding BT and MIPI interfaces

{|class="wikitable" style="margin:auto"
|+pinix
! style=width:100px | Feature !! style=width:100px | Status !! style=width:300px | Notes !! style=width:200px | More info
|-
| SD Card Boot || style="background-color:#9eff9e" | Working || There is a design flaw such that the SD card can only receive 3.3V and not the 1.8V required for speeds over 20 MB/s. || #Star64
|-
| eMMC Boot || style="background-color:#9eff9e" | Working || || #Star64
|-
| UART Boot || style="background-color:#9eff9e" | Not Tested, assumed working|| The only current known use for UART boot is the [https://github.com/starfive-tech/Tools recovery tool from StarFive] ||
|-
| PCIE/NVME Boot || style="background-color:#ebc934" | Partially Implemented || || #Star64 @Tenkawa
|-
| USB 2.0 || style="background-color:#9eff9e" | Working || A design flaw means that USB overcurrent protection is disabled so be careful ||
|-
| USB 3.0 || style="background-color:#9eff9e" | Working || ||
|-
| 4K Output || style="background-color:#ebc934" | Partially Implemented || || #Star64 @Fishwaldo
|-
| 4K HDR || style="background-color:#ffc7c7" | Not Implemented || ||
|-
| H.264 || style="background-color:#ffc7c7" | Not Implemented || ||
|-
| H.265 || style="background-color:#ffc7c7" | Not Implemented || ||
|-
| 3.5mm audio Jack || style="background-color:#9eff9e" | Working || ||
|-
| Ethernet || style="background-color:#9eff9e" | Working || ||
|-
| Wifi || style="background-color:#9eff9e" | working || ||
|-
| BT || style="background-color:#9eff9e" | working || || #Star64 @Fishwaldo, needs binary blob
|-
| PCIe 2.0 ×1 lane || style="background-color:#9eff9e" | Working || ||
|-
| "Pi2" GPIO || style="background-color:#9eff9e" | Working || ||
|-
| TTL UART || style="background-color:#9eff9e" | Working || ||
|-
| MIPI-DSI || style="background-color:#ffc7c7" | Unknown || || Display interface
|-
| MIPI-CSI || style="background-color:#ffc7c7" | Unknown || || Camera interface
|}

[[Category:STAR64]]

NASCase-STAR64

2023-07-05T20:10:01Z

Nuess0r: Add photos of STAR64

{{Under construction}}

'''Modification of HDD power cable missing'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

===Step 2. Install operating system===
[[File:Star64 EMMC switch map.png |200px|thumb|right|Correct DIP switch settings to boot from eMMC for the Star64 SBC.]]
The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

Test that your STAR64 boots from eMMC before installing it in the case as the DIP switch to select the bootmode is below the HDD cage and not reachable without partial disasembly.
<div style="clear: both"></div>
===Step 3. Installing the STAR64 into the NAS Case===
[[File:STAR64-NAS-mount-star64-1.jpg|300px|thumb|left|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:STAR64-NAS-mount-star64-2.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]

Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.

If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. Install it by placing it with the USB connectors and power button first with a slight angle into the case. Then push gently the side walls of the NAS case outwards until the STAR64 falls into place.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.
<div style="clear: both"></div>
===Step 4. Installing 80 mm Fan and eMMC===
[[File:STAR64-fan-parts.jpg|200px|thumb|left|The 80 mm fan and JST connector parts]]
[[File:STAR64-fan-wiring.jpg|200px|thumb|right|Correct wiring of the fan cable]]
The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.
<div style="clear: both"></div>
===Step 5. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:STAR64-NAS-internal-wiring.jpg|300px|thumb|right|PCIe to SATA installed and cables routed through the case]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.
<div style="clear: both"></div>
===Step 6. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.
<div style="clear: both"></div>
===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).
<div style="clear: both"></div>
===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:STAR64-NAS-with-hdd.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).
[[File:STAR64-NAS-front-io.jpg|300px|thumb|left|Front IO with power button]]

[[Category:STAR64]] [[Category:SBC Cases]]

File:STAR64-NAS-with-hdd.jpg

2023-07-05T19:29:53Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

File:STAR64-NAS-mount-star64-2.jpg

2023-07-05T19:29:28Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:STAR64-NAS-mount-star64-1.jpg

2023-07-05T19:29:06Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

File:STAR64-NAS-internal-wiring.jpg

2023-07-05T19:28:40Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:STAR64-NAS-front-io.jpg

2023-07-05T19:28:19Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:STAR64-HDD-power-cable-remove-pins.jpg

2023-07-05T19:27:50Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:STAR64-fan-wiring.jpg

2023-07-05T19:26:16Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:STAR64-fan-parts.jpg

2023-07-05T19:24:25Z

Nuess0r: Category:STAR64

== Summary ==
[[Category:STAR64]]

== Licensing ==
{{CC0}}

File:Star64-pcie-fit-check.jpg

2023-07-02T22:04:44Z

Nuess0r: Add category

== Summary ==
Try if the Pine64 SATA PCIe card fits into the Pine64 NAS case.
== Licensing ==
{{PD|PD}}

[[Category:STAR64]]

File:Star64 EMMC switch map.png

2023-07-02T22:04:12Z

Nuess0r: Add category

== Summary ==
Image of the correct dip switch settings to boot from eMMC for the STAR64 SBC.

== Licensing ==
{{PD|PD}}

[[Category:STAR64]]

File:Star64 SD switch map.png

2023-07-02T22:03:05Z

Nuess0r: Add category

== Summary ==
Image of the correct dip switch settings to boot from SD Card for the Star64 SBC.

== Licensing ==
{{PD|PD}}

[[Category:STAR64]]

NASCase-STAR64

2023-07-02T21:54:30Z

Nuess0r: Adding proper "under construction" box

{{Under construction}}

'''Pictures are still showing ROCKPro64, modification of HDD power cable missing, description of fan connection missing'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[File:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case with the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

===Step 2. Install operating system===

The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

===Step 3. Installing the STAR64 into the NAS Case===
[[File:ROCKPro64inNASCase.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:FrontIO.png|300px|thumb|left|Front IO with IR and LED relay installed]]
Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.
If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. It should fit snugly and align with the port cut-outs in the case. Do not attempt at installing the board at an angle; insert it while holding it level and lowering it into the case.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.

===Step 4. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:PCIeFittedSATAsockets.png|200px|thumb|right|PCIe to SATA installed. Note the SATA connection orientation]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.

===Step 5. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.

===Step 6. Installing 80 mm Fan and eMMC===
[[File:80mmfan.png|200px|thumb|right|The 80 fan is a worthwhile addition to the NAS Case build]]

The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.

===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).

===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:NASCAsewithdrives.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
[[File:TopViewAssembly.png|300px|thumb|right|Top view of a complete NAS Case Assembly]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).

[[Category:STAR64]] [[Category:SBC Cases]]

NASCase-STAR64

2023-07-02T21:44:51Z

Nuess0r: Add summary of missing things.

'''Warning: This page is currently work in progress!'''

'''Pictures are still showing ROCKPro64, modification of HDD power cable missing, description of fan connection missing'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[file:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case for the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

===Step 2. Install operating system===

The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

===Step 3. Installing the STAR64 into the NAS Case===
[[File:ROCKPro64inNASCase.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:FrontIO.png|300px|thumb|left|Front IO with IR and LED relay installed]]
Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.
If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. It should fit snugly and align with the port cut-outs in the case. Do not attempt at installing the board at an angle; insert it while holding it level and lowering it into the case.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.

===Step 4. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:PCIeFittedSATAsockets.png|200px|thumb|right|PCIe to SATA installed. Note the SATA connection orientation]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.

===Step 5. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.

===Step 6. Installing 80 mm Fan and eMMC===
[[File:80mmfan.png|200px|thumb|right|The 80 fan is a worthwhile addition to the NAS Case build]]

The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.

===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).

===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:NASCAsewithdrives.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
[[File:TopViewAssembly.png|300px|thumb|right|Top view of a complete NAS Case Assembly]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).

[[Category:STAR64]] [[Category:SBC Cases]]

NASCase-STAR64

2023-07-02T16:57:27Z

Nuess0r: work in progress

'''Warning: This page is currently work in progress!'''
'''Pictures are still showing ROCKPro64'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[file:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case for the STAR64]]

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One Gigabit Ethernet port
* HDMI

Be aware that these STAR64 IO ports are '''not accessible''' without modifying the case:
* Micro SD slot
* Second Gigabit Ethernet port

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:RPRO-SATA852-1.jpg|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*eMMC module (The micro SD card slot is '''not''' accessible without modifying the case)
*optionally an eMMC to USB 2.0 adapter
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If you want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.

Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

===Step 2. Install operating system===

The micro SD card slot is not accessible from outside. Therefore you have to install the chosen operating system before mounting the STAR64 into the NAS case when using an micro SD card for the installation process.

Alternative is that you have the optional eMMC to USB 2.0 adapter to install the operating system then you can do it just before step 6 (or now and test if everything is working).

===Step 3. Installing the STAR64 into the NAS Case===
[[File:ROCKPro64inNASCase.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:FrontIO.png|300px|thumb|left|Front IO with IR and LED relay installed]]
Make sure nothing is plugged into your STAR64 - including antennas and a micro SD card.
If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. It should fit snugly and align with the port cut-outs in the case. Do not attempt at installing the board at an angle; insert it while holding it level and lowering it into the case.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.

===Step 4. PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:PCIeFittedSATAsockets.png|200px|thumb|right|PCIe to SATA installed. Note the SATA connection orientation]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.

===Step 5. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.

===Step 6. Installing 80 mm Fan and eMMC===
[[File:80mmfan.png|200px|thumb|right|The 80 fan is a worthwhile addition to the NAS Case build]]

The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.

===Step 7. Installing Extras (SMA Antennas)===
If you have additional peripherals, such as an SMA Antennas, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 8''' of this guide.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).

===Step 8. Installing the HDD / SSD Bracket and Routing Cables===
[[File:NASCAsewithdrives.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
[[File:TopViewAssembly.png|300px|thumb|right|Top view of a complete NAS Case Assembly]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 9. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).

[[Category:STAR64]] [[Category:SBC Cases]]

File:RPRO-SATA852-1.jpg

2023-07-02T10:12:59Z

Nuess0r: PCIe to Dual SATA-III Interface Card with JMicron JMB582 Chipset

== Summary ==
PCIe to Dual SATA-III Interface Card with JMicron JMB582 Chipset
== Licensing ==
{{subst:Unknown_copyright}}

NASCase-STAR64

2023-07-02T10:11:12Z

Nuess0r: Initial version

'''Warning: This page is currently work in progress!'''
'''Pictures are still showing ROCKPro64'''

The PINE64 NAS Case is intended for either a Network Attached Storage (NAS) or Desktop application, but it can also be used in a number of other server capacities. It is built from precision-cut and powder-coated aluminum. The physical dimensions are 232.4 mm (Width) x 105.0 mm (Height) x 145.2 mm (Depth).

An exploded view of the NAS Case, illustrating how all the components come together, can be found [http://files.pine64.org/doc/rockpro64/ROCKPro64%20NAS%20Case%20Exploded%20View%20Diagram.pdf here]. Please refer back to this PDF document during assembly to verify correct orientation of individual components.
[[file:NASCaseMain.png|400px|thumb|right|Front View of the PINE64 NAS Case for the STAR64]]

==What does the NAS Case house?==
[[File:NAS_Case_internals.jpg|200px|thumb|left|Internal Layout of the NAS Case]]

The NAS Case can house the following components:
*A STAR64 Single Board Computer (SBC) with a tall, mid-size or slim heatsink
*A PCIe to dual SATA adapter or a different low-profile PCIe card, e.g. an NVMe adapter
*Either two 3.5” OR two 2.5” HDDs / SSDs; combination of any two sized drives is accepted
*A 80 mm fan with 12 V supply voltage
*Up to three SMA antennas, two of which can be attached to the WiFi/ BT module

==What comes in the box?==
When you purchase the NAS Case from the PINE store the following items are shipped to you:
*The NAS Case itself, which consists of a top and a bottom half as well as an internal HDD SSD mount.
*Two SATA cables
*A custom power cable capable of powering two 2.5” or 3.5” HDDs /SSDs
*The required screws, fittings and a LED relay

==What other bare-minimum things do I need for a NAS build?==
[[File:PCIetoSATA.png|200px|thumb|right|You will need the PCIe to SATA adapter from the PINE64 store to connect your disks to your STAR64 board.]]
To assemble a functional NAS in the NAS Case you will require a number of additional parts.
With the exception of HDDs/SSDs, most of it can be purchased from the [https://www.pine64.org/?post_type=product PINE64 store]:
*A STAR64 4 GiB or 8 GiB board
*A 12 V 5 A power supply
*A PCIe to dual SATA adapter [https://forum.pine64.org/showthread.php?tid=6932 '''WARNING''': Old adapters with AS Media chips don't] [https://forum.pine64.org/showthread.php?tid=6511 work well with two HDD!]
*One or two 2.5”/ 3.5” HDDs (not sold in the PINE store)
*A class 10 micro SD card and/or eMMC module (optionally an eMMC to USB 2.0 adapter)
*80 mm fan with 12 V supply
*3 pin JST PH connector and crimp contacts with 2 mm pitch (not sold in the PINE store)

==Which software should I use?==

'''Help needed!'''

Please help to contribute with your experience:
*OMV for Risc-V?
*Nextcloud?
*Others?

==Step-by-Step Assembly Instructions==

If want an overview of the process before you start in video format [http://www.youtube.com/watch?v=_UeeklKo0Og check out this instructional video] for the ROCKPro64.
Come back afterwards and read the instructions carefully here, as there are few important differences when using a STAR64!

===Step 1. Preparation of the NAS Case for Installation===
Remove the top of the NAS Case. It is held together by two screws on either side with the exception of the bottom (left, right, top and back). Once done, the top of the case should lift right off without any resistance.

The next step is to remove the HDD/SSD holding bracket, which is screwed into the bottom of the case. Flip the bottom over and undo the screws which hold the bracket in place.

You should now be left with a bare case ready for installation of the necessary components.

===Step 2. Installing the STAR64 into the NAS Case===
[[File:STAR64inNASCase.jpg|300px|thumb|right|Correct Placement of the STAR64 in the empty case, with Ethernet; Power; and HDMI at the back of the NAS Case]]
[[File:FrontIO.png|300px|thumb|left|Front IO with IR and LED relay installed]]
Make sure nothing is plugged into your STAR64 - including a micro SD card.
If you intend to use a heatsink with your board then please install it now before proceeding. If you bought the heatsink from the Pine64 store it comes with thermal paste and/or a thermal pad. You can use one or the other (not both!). The thermal pad is easier to apply but the thermal paste should be better at cooling if properly applied.

Place your STAR64 into the case with USB 2.0 and 3.0 ports facing the front of the case. It should fit snugly and align with the port cut-outs in the case. Do not attempt at installing the board at an angle; insert it while holding it level and lowering it into the case.

Secure the board with 4x screws included in the see-through bag. Make sure that the board is held firmly in the case but do not overtighten the screws.

On the STAR64 the LEDs are at the back so just ignore the small semi-opaque plastic cylinder you can find in the see-through bag.

If you wish to install an IRx receiver into your case then you should also place it into the IR socket at this stage. It should align with the cutout right above the power (PWR) switch.

===Step 3 PCIe to SATA adapter and Cabling===
[[File:DC_Location.jpg|200px|thumb|left|DC header on the STAR64 for the power cable]]
[[File:PCIeFittedSATAsockets.png|200px|thumb|right|PCIe to SATA installed. Note the SATA connection orientation]]
With the board in place it's time to set up the PCIe to SATA adapter and do the cabling necessary to attach HDDs / SSDs.

Place the SATA Adapter into the PCIe slot on the STAR64 board so that the holding bracket of the adapter faces the back of the case. In the back of the case there is a cutout for the PCIe adapter.

Secure the PCIe dual SATA Adapter with a single screw at the top of the bracket, in the back of the NAS Case.

This is the right time to plug in the SATA and custom power cable. The SATA cables plug into the ports on the top or front of the adapter while the power cable plugs into DC header located on the board - just below the power jack, to the left of the Ethernet port (when viewed from front).

Have the cables hang outside the case or to the side for now so that they do not get in the way until they are needed.

===Step 4. Installing HDDs / SSDs into the Holding Bracket===
[[File:Bracket_Orientation.png|300px|thumb|left|Bracket Orientation in the NAS Case]]
The next step is to install HDDs/ SSDs into their holding bracket; 2.5” drives need to be installed at the very bottom of the bracket while 3.5” drives are at the top of the the bracket.

For 2.5” drives make sure that the drives are oriented up and their SATA and power ports face the front of the NAS Case.

For 3.5” HDDs, make sure they are oriented up and their SATA and power ports face the right side of the NAS Case (towards the fan mounting location).

Each drive you mount in the holding bracket requires 4x screws which come supplied in the see-through bag. Make sure the drives are held in place firmly but do not over-tighten the screws.

Once the holding bracket is assembled and you have your drives mounted, please set it aside and proceed to the next step.

===Step 5. Installing 80mm Fan===
[[File:80mmfan.png|200px|thumb|right|The 80mm fan is a worthwhile addition to the NAS Case build]]

The fan should be mounted on the right-hand side of the case. We suggest that the fan is oriented for negative pressure, blowing air out of the case rather than taking air in. ([[User:AlephNull]] disagrees and recommends a positive pressure configuration both to allow a filter to be placed over the intake to prevent dust ingress and because the cage on the outlet side of the fan helps keep the wiring for 3.5" disks away from the fan blades). For best cable management results, have the fan power lead face the front of the case so that it can easily be routed to its header located next to GPIO pins on the STAR64.
The fan should be secured using 4x long screws (that fasten into bolts) which can be found in the see-through bag supplied with the NAS Case.
Plug in the fan at this stage of the installation and route the cable at the bottom of the front of the case.

===Step 6. Installing Extras (eMMC; SMA Antennas)===
If you have additional peripherals, such as an eMMC or SMA Antennas as well as the 80mm fan, then now is the right time to install them. If you have '''none of the above''', please '''proceed to step 6''' of this guide.

The eMMC is fitted into it respective placements on the STAR64 board - please consult the diagram for their correct installation.

If you intend to use external u.FL to SMA antennas in the NAS Case then this is also the time to install them into the case. In the back section of the case at the very top you will find three cut-outs where the SMA antennas can be fitted. Don’t plug the u.FL leads antenna leads into the WiFi/BT module just yet - instead wait until after the disk holding bracket is installed into the case (step 6).

===Step 7. Installing the HDD / SSD Bracket and Routing Cables===
[[File:NASCAsewithdrives.jpg|300px|thumb|right|Complete assembly of the NAS Case]]
[[File:TopViewAssembly.png|300px|thumb|right|Top view of a complete NAS Case Assembly]]
Installing the HDD/SSD bracket into the case and wiring it up is the last step before closing up the case.

Place the bracket with the disks installed (from step 4) into the case. The bracket should line up with the guiding bolts and screw holes at the bottom of the case. The section of the bracket that holds 3.5” HDDs needs to face the left side of the case (when viewed from front) and should overhang the STAR64 board slightly. The 3.5” SATA and power ports should face the right side of the case - where the fan mounts, while 2.5” SATA and power ports should face the front of the case.

With the bracket aligned, flip the bottom of the case over while holding the bracket in place. Screw it into place using 4x Phillips head screws that came included with the NAS Case.

The last thing remaining before the NAS Case can be screwed shut is routing SATA and power cables:
For 3.5” HDDs we suggest routing power and SATA cables underneath the drives, where 2.5” HDDs/SSDs would otherwise reside.

For 2.5” disks you have plenty of routing options as there is much space available. The most obvious route is straight over the disks, where the 3.5” HDDs would reside.

===Step 8. Closing the NAS Case and Powering On your NAS===

Almost there. All that's left to do is to screw together the NAS Case. Screw in the top front screws first followed by screws on either side of the case. Do the back screws last. There, you are done.

To power on your new NAS Case and HDDs all you need to do is to plug in power and Ethernet (This is obviously assuming that you are intending to use it as a NAS or a headless server).

==IO accessibility when the NAS Case is assembled==

When the NAS Case is assembled and screwed shut these STAR64 IO ports remain accessible:
* Micro SD slot
* 3 x USB 2.0
* USB 3.0
* Power switch
* The headphone jack
* One of two Gigabit Ethernet port
* HDMI

[[Category:STAR64]] [[Category:SBC Cases]]

STAR64

2023-06-26T21:05:40Z

Nuess0r: Adding section to change the blue LED behavior

[[File:Star64.jpg|400px|thumb|right|The STAR64]]

The '''Star64''' is a RISC-V based Single Board Computer powered by StarFive JH7110 Quad-Core SiFive U74 64-Bit CPU, Imagination Technology BX-4-32 GPU and supports up to 8GB 1866MHz LPDDR4 memory. It provides an eMMC module socket, MicroSD Card slot, PCI-e, Pi-2 Bus, USB 3.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software releases ==

The releases are still in '''alpha''' state and are only fit for testing purposes.

* [https://github.com/Fishwaldo/meta-pine64 A Set of Images built with Yocto for commandline, weston and plasma - Where possible, GPU/VPU acceleration is enabled.]
* [https://forum.pine64.org/showthread.php?tid=18276 Armbian]

== SoC and Memory Specification ==
* Based on [https://www.starfivetech.com/en/site/soc StarFive JH7110]

[[File:StarFive.jpg|right]]
[[File:JH7110_Block_Diagram.png|800px]]

=== CPU Architecture ===
* [https://www.sifive.com/cores/u74 Quad-core U74 up to 1.5GHz CPU]
[[File:SiFive.jpg|right|200px]]
* Fully compliant with the RISC-V ISA specification
* 64-bit RISC-V Application Core
* 32KB L1 I-cache with ECC
* 32KB L1 D-cache with ECC
* 8 Region Physical Memory Protection
* Virtual Memory support with up to 47 Physical Address bits
* Integrated up to 2MB L2 Cache with ECC
* includes RV64IMAC S7 monitor core, 16 KB L1 I-Cache with ECC, 8 KB DTIM with ECC
* 32-bit RISC-V CPU core (E24) for real time control, support RV32IMFC RISC-V ISA

=== GPU Architecture ===
* [https://www.imaginationtech.com/product/img-bxe-4-32-mc4/ Imagination Technology BXE-4-32 up to 600Mhz GPU]
[[File:imgtech.png|right|200px]]
* Support OpenCL 3.0
* Support OpenGL ES 3.2
* Support Vulkan 1.2
* Tile-based deferred rendering architecture for 3D graphics workloads, with concurrent processing of multiple tiles
* Support for GPU visualization, up to 8 virtual GPUs
* On fly frame buffer compression and decompression (TFBC) algorithm
* Performance: 128 FP32 FLOPs/Clock, 256 FP16 FLOPs/Clock

=== System Memory ===
* LPDDR4 RAM Memory Variants: 2GB, 4GB and 8GB.

== Board Features ==

=== Video ===
* Digital Video output up to 4K@30Hz
* 4K HDR @ 60fps
* H.264/AVC Base/Main/High/High10 profile @ level 5.1; up to 4K×2K @ 60fps
* H.265/HEVC Main/Main10 profile @ level 5.1 High-tier; up to 4K×2K @ 60fps

=== Audio ===
* 3.5mm audio Jack

=== Network ===
* Single or Dual 10/100/1000Mbps Ethernet
* 2.4GHz/5Ghz MIMO WiFi 802.11 b/g/n/ac with Bluetooth 5.2

=== Storage ===
* on-board 128Mbit (16MByte) XSPI NOR flash memory - bootable
* microSD - bootable, supports SDHC and SDXC and storage up to 256GB
* eMMC - bootable (optional eMMC Module)
* 1× USB3.0 Dedicated Host port
* 3× USB2.0 Host port

=== Expansion Ports ===
* PCIe 2.0 ×1 lane
* 2×20 pins "Pi2" GPIO Header
** The JH7110 SoC supports full multiplexing of its GPIO pins. This means any non-power/ground pin can be configured to any function outlined in Table 4-2 of the SoC datasheet.
* 4 lane MiPi DSI port for LCD panel
* 4 lane MiPi CSI port for camera module

== Board Information, Schematics and Certifications ==
Model "A" Baseboard Dimensions: 133mm×80mm×19mm

Input Power: DC 12V @ 3A 5.5mmOD/2.1mmID center-positive Barrel DC Jack connector

Schematic:
* [https://files.pine64.org/doc/star64/Star64_Schematic_V1.1_20230504.pdf STAR64 Schematic 20230504 v1.1 (Production Released version)]
* [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf STAR64 Schematic 20220721 v1.0 (Prototype Board)]

Certifications:
* Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submits the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
* Not yet available

== Datasheets for Components and Peripherals ==

Star64 JH7110 SoC information:
* [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Product_Brief.pdf StarFive JH7110 SoC Product Brief]
* [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Datasheet.pdf StarFive JH7110 SoC Datasheet]
* [https://doc-en.rvspace.org/JH7110/TRM/ StarFive JH7110 SoC Technical Reference Manual]

X-Power PMU information:
* [https://files.pine64.org/doc/datasheet/star64/AXP15060%20datasheet%20V0.1.pdf X-Power AXP15060 Datasheet V0.1]

LPDDR4 (200 Balls) SDRAM:
* [https://files.pine64.org/doc/datasheet/rockpro64/SM512M32Z01MD2BNP(200BALL).pdf Micron LPDDR4 Mobile LPDDR4 Datasheet]

eMMC information:
* [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
* [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
* [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
* [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
* [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]

SPI NOR Flash information:
* [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]

Ethernet related info:
* TBA

WiFi/BT module info:
* [https://files.pine64.org/doc/datasheet/star64/Fn-Link_6252B-UUB_datasheet_V1.1_20220329.pdf Fn-Link 6252B 11AC Dual Band 2T2R WiFi + Bluetooth5.2 Datasheet]

== Bringup Notes ==

# The USB over-current protection is not wired up correctly to the USB ports on Star64. The default Starfive Kernel will disable USB on boot as it belives the ports are overcurrent. This ugly hack works around it: https://github.com/Fishwaldo/Star64_linux/commit/2634a13ecfa1fa5c232ec2b9f6a6b6b0d9d66898
# The Wifi Chip (RTL8852BU) is not supported in the kernel. There is a Vendor Driver that is imported in the kernel at https://github.com/Fishwaldo/Star64_linux/tree/Star64_devel/drivers/staging/rtl8852bu but it really needs a cleanup. It does BUG_ON at boot, but wifi is confirmed working.
# HDMI can be finicky. 4K Monitors are known to have a issue. This is also relevant for VisionFive2
# Some kernels/distributions do not detect the total memory correctly. This is due to the way u-boot is configured. Currently, u-boot reads the memory from the eeprom on the Star64, and updates the dtb file before booting the kernel. Distributions that boot differently may not get the updated dtb file with the correct memory entry. You can work around this by recompiling the DTB with the correct memory for your board
# VisionFive2 Kernels will only offer limited functionality on the Star64 - Mainly USB, Wifi and PCI will not work.
# The 4-pin 12 volt JST-XH-4A connector found on the Star64 is incompatible with the dual SATA power adapter intended for the ROCKPro64. The connector on the Star64 is rotated 180 degrees to the one on the ROCKPro64, resulting in the cable receiving +12V where GND is expected and vice versa. The cable's internal circuitry ends up shorting in this configuration.

=== LEDs ===

How can one make the blue led stop blinking?

sudo echo "default-on" >> /sys/devices/platform/leds/leds/blue-led/trigger

To see the various things you can set the trigger to if you ever "do" want to use that blue led:

cat /sys/devices/platform/leds/leds/blue-led/trigger

For example the trigger ''activity'' is all cpu activity.

== Potential Issues ==

<onlyinclude>
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 initilize
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.
</onlyinclude>

== Prototype Bringup Notes ==

Note: This section is relevant to the original prototype (v1.0) that a few developers received.

# The [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf schematic] has several discrepancies with actual board labels.
# The serial console can be found with TXD on pin 8 and RXD on pin 10; a convention common to Pi-style boards. Use the 40pin header pinouts in color on page one and not the schematic prose.
# If you have only a single core running and no PCI card present, it appears to power up via the +5V/GND lines from the USB serial adapter pins.
# It will not boot from a VisionFive R1 uSD card.
# The boot device switch labels and the silk screen are inverted. "0" means "On".
# 2021.10-00001-gdbdaad919b will attempt to boot from SPI, but it appears blank. If you let it for many minutes, the device will eventually time out and boot OpenSBI v1.0 from (SPI?). This will fail, but only after self-identifying as a VisionFive R2, complete with five cores and 4 GB of RAM, before failing. A "press any key" timeout is offered, but I've been unable to make it stop. It will eventually crash with:

Loading Environment from SPIFlash... SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
*** Warning - bad CRC, using default environment

Not a StarFive EEPROM data format - magic error

[[Category:STAR64]] [[Category:StarFive JH7110]]

File:Star64-pcie-fit-check.jpg

2023-06-04T20:18:07Z

Nuess0r: Try if the Pine64 SATA PCIe card fits into the Pine64 NAS case.

== Summary ==
Try if the Pine64 SATA PCIe card fits into the Pine64 NAS case.
== Licensing ==
{{PD|PD}}