Elias at 19:06, 1 July 2024

2024-07-01T19:06:45Z

Elias: /* Note */

2024-06-26T10:21:31Z

‎Note

Elias: /* Instructions */

2024-06-17T19:28:54Z

‎Instructions

Elias: Created page with "
Reflash header.png
Reflash is a Linux image for downloading and installing Rebuild and Refactor images on R..."

2024-06-11T19:07:50Z

Created page with "<div class="res-img"> Reflash header.png </div> Reflash is a Linux image for downloading and installing Rebuild and Refactor images on R..."

New page

<div class="res-img">
[[File:Reflash header.png|Reflash header.png]]
</div>

Reflash is a Linux image for downloading and installing [[Rebuild]] and [[Refactor]] images on [[Recore]]. You can also create an image from the contents of the eMMC.

<div class="alert alert-warning">
===='''Note on v1.0.0'''====
Reflash v1.0.0 marks a big change from software switching of boot medium to always booting to Reflash/USB drive if the USB drive is present.
For older versions of Reflash:
[[Reflash_v0.1.2]]
</div>

<div class="alert alert-warning">

===='''Entering FEL mode'''====
The first time you use Reflash 1.0.0 and above, you need to boot to Reflash using FEL-mode. Hold the FEL button on the board down and press the RST (reset) button. You need to have a USB C cable connected between the USB C connector on Recore and a host computer.
<tabs>
<tab name="Linux">
You should see the board show up as a USB device:
<pre>
lsusb
</pre>
<div class="res-img">
[[File:FEL-mode lsusb.png]]
</div>
Download the Recore git repository. On the command line write:
<pre>
wget https://github.com/intelligent-agent/Recore/raw/master/binaries/Recore-fel.zip
unzip Recore-fel.zip
</pre>
Install the sunxi-tools package on the host computer:
<pre>
sudo apt install sunxi-tools
</pre>
Now you can run the whole command on a shell.
<pre>
sudo sunxi-fel -v -p spl fel/sunxi-spl.bin write 0x44000 fel/bl31.bin write 0x4a000000 fel/u-boot.bin reset64 0x44000
</pre>
On the host computer, you should see the binary files being uploaded like the following:
<div class="res-img">
[[File:Make-fel.png]]
</div>
</tab>
<tab name="Windows">
# Open Device Manager and check that the device shows up. It might not have a known vendor and product description. <div class="res-img">[[File:Windows-Device-manager.png]]</div>
# Download the [https://github.com/intelligent-agent/Recore/archive/refs/heads/master.zip Recore repository] and extract the contents.
# Download [https://github.com/eperie/build-scripts/releases/download/v1.3/sunxi-tools-mingw64-530adfa.zip sunxi-fel binary for windows] and extract the contents so it is the the Recore-master folder.
# Download and install Zadig https://linux-sunxi.org/FEL/USBBoot#Using_sunxi-fel_on_Windows
# Open the CMD prompt and navigate to the extracted Recore folder.
# Insert the USB drive with Reflash 1.0.0 (See instructions further down)
# Run the following command from the Recore folder:
<pre>
(prefix) sunxi-fel.exe -v -p spl binaries\new\sunxi-spl.bin write 0x44000 binaries\new\bl31.bin write 0x4a000000 binaries\new\u-boot.bin reset64 0x44000
</pre>

After running that command, you should see the SPL and u-boot being transferred and the board should start to boot from the USB drive.
<div class="res-img">[[File:Sunxi-fel-windows.png]]</div>
</tab>
</tabs>
</div>

==Instructions==
This page has step-by-step instructions for using the image. Here is what you should do:
<ol>
<li>
Use [https://www.balena.io/etcher/ Balena Etcher] to download and flash the Reflash image. Here is the URL to the image: <pre>https://github.com/intelligent-agent/Reflash/releases/download/v1.0.0/reflash-v1.0.0.img.xz</pre><div class="res-img">[[File:BalenaEthcer.png|center]]</div>
</li>
<li>
After flashing the image to a USB drive with at least 4 GB of storage, eject the USB drive <b>properly</b> and insert it in a USB port on the Recore board.
</li>
<li>
If you want to get back to Reflash from Rebuild or Refactor, you can do so by having the USB drive inserted during boot. A reboot can be done from Mainsail, Fluidd or OctoPrint.
<li>
Once the board has booted from USB, you should be able to access the web interface using the address http://recore.local<div class="res-img">[[File:Reflash.png|center]]</div>
</li>
<li>
From the web interface, choose witch version of Refactor/Rebuild you want to download. There are two types of images, either with OctoPrint as the web interface, with Mainsail or with Fluidd. You can also choose to upload a custom image using the "Upload file" option.
</li>
<li>
Once the image has been downloaded (to the USB drive) you can install/flash the image to the eMMC. This will take 3-4 minutes.
</li>
<li>Once the image has been flashed on the eMMC drive, you can reboot the board, and it will boot using the Refactor image that you chose.
</li>
</ol>
You can keep the Reflash USB drive in a safe place and reuse it the next time you want to upgrade the software. If you want to upgrade to a later version of Refactor, the same image can be used again.

<div class="alert alert-warning">

===='''Note'''====
It is possible to log in to the Reflash image for manual operations. The SSH access is available using username '''root''' and password '''temppwd'''
</div>

==Reflash image==
Reflash is an initRamFS Linux image. That is in order to completely remove the boot medium before a reboot occurs. Because of that, Reflash needs to be very small. The application is built in Go witch makes it stand alone with very little dependencies. The Network management is handled by systemd-networkd and systemd-resolved. Very few extra programs are installed, and any additional programs that gets installed will be lost after a reboot. SSH is enabled for user '''debian''' with password '''temppwd'''. The kernel is 5.15.127.

==Known issues==
===Flash progress not showing any progress===
Sometimes the flashing process does not work as expected. There is no progress on the progress indicator and the flashing never completes. A workaround is to go back to step 1 and install Reflash again.

← Older revision		Revision as of 19:06, 1 July 2024
Line 4:		Line 4:

	Reflash is a Linux image for downloading and installing [[Rebuild]] and [[Refactor]] images on [[Recore]]. You can also create an image from the contents of the eMMC.		Reflash is a Linux image for downloading and installing [[Rebuild]] and [[Refactor]] images on [[Recore]]. You can also create an image from the contents of the eMMC.
		+
		+	The latest image is: [https://github.com/intelligent-agent/Reflash/releases/tag/v1.0.1 Reflash v1.0.1]

	<div class="alert alert-warning">		<div class="alert alert-warning">

@@ Line 91: / Line 91: @@
 ===='''Note'''====
-It is possible to log in to the Reflash image for manual operations. The SSH access is available using username '''root''' and password '''temppwd'''
+It is possible to log in to the Reflash image for manual operations. The SSH access is available using username '''debian''' and password '''temppwd'''
 </div>

@@ Line 65: / Line 65: @@
 <ol>
 <li>
-Use [https://www.balena.io/etcher/ Balena Etcher] to download and flash the Reflash image. Here is the URL to the image: <pre>https://github.com/intelligent-agent/Reflash/releases/download/v1.0.0/reflash-v1.0.0.img.xz</pre><div class="res-img">[[File:BalenaEthcer.png|center]]</div>
+Use [https://www.balena.io/etcher/ Balena Etcher] to download and flash the Reflash image. Here is the URL to the image: <pre>https://github.com/intelligent-agent/Reflash/releases/download/v1.0.1/reflash-v1.0.1.img.xz</pre>
 </li>
 <li>

Reflash v1.0.1 - Revision history

Elias at 19:06, 1 July 2024

Elias: /* Note */

Elias: /* Instructions */

Elias: Created page with " Reflash header.png Reflash is a Linux image for downloading and installing Rebuild and Refactor images on R..."

Elias: Created page with "
Reflash header.png
Reflash is a Linux image for downloading and installing Rebuild and Refactor images on R..."