Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding to functionyard docs #143

Merged
merged 3 commits into from
Mar 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ id: fxblox-app
---

## Installing the FxBlox App

### Initial Setup
:::warning
If you have setup FxBlox **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. You can **format the drive after completing setup** and by **click and holding anywhere on the Hard Drive info box** until the pop-up option appears. See more [details here](./fxblox-app.md/#format-drive)
If you were helping test nightly firmware releases **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. **See more [details here.](./fxblox-app.md/#format-drive)**
:::
### Initial Setup

1. **Download the App**:
- For Android: [FxBlox on Google Play (v1.6.2+)](https://play.google.com/store/apps/details?id=land.fx.blox).
- For iOS: Available soon on the App Store.
Expand All @@ -34,7 +34,7 @@ If you have setup FxBlox **before** official testnet launch, you will be require
10. Finally, on the last screen reconnect your mobile device to your home WiFi and you can turn on the mobile data again if you want to. The app will confirm the successful setup. Please note the app does not continue if you do not have an active internet connection. When Blox is connected to the internet, the LEDs turn `green` for 30 seconds and then turn off.
11. We recommend unplugging and replugging the Blox after the initial setup once for a hard reboot and ensuring that everything is set. After you re-plug the power and it boots, it may reboot automatically once as well.

### Troubleshooting
### Troubleshoot

- **Final step connection issues**: Connect to mobile or home wifi, restart the FxBlox app, select `Connect to Existing Blox`. If that doesn't work, restart the FxBlox device. Close app and reopen to proceed with `Connect to new Blox`.
- **If Metamask doesn't redirect after signing transaction**: Manually go back to the FxBlox app.
Expand Down
65 changes: 65 additions & 0 deletions docs/functionyard/fxblox-hardware-rpi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: FxBlox Lite (CM4)
id: fxblox-hardware-rpi
---

## Updating Your FxBlox Lite (RPI)
:::warning
If you were helping test nightly firmware releases **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. **See more [details here.](./fxblox-app.md/#format-drive)**
:::
### Step 1: Download the firmware
:::info
If this is your very first time setting up your FxBlox Lite, see these [instructions first](#first-time-setup)
:::
- **Download**: Find `rpi_update.zip` in the [latest release](https://github.com/functionland/rk1-image/releases/latest) under the Assets section on GitHub.

- Download: Download `Win32 Disk Imager` for writing update firmware to USB.
https://win32diskimager.org/

### Step 2: Unzip and Write image to USB

1. **Unzipping**: Unzip `rpi_update.zip` on your computer. After unzipping there must be a .img file.
2. **Writing Image to USB**:
- In Image File section select `rpi_update.img` file.
- In Device section select USB Disk Partion letter.
- Click Write to start flashing USB Disk.

![Win32 Disk Imager](/img/fxyard-network/win32DiskImager.png)

### Step 3: Updating FxBlox

1. **Turn Off**: Ensure your FxBlox (RPI) Lite is turned off.
2. **USB Connection**: Connect the USB drive to one of USB port of the FxBlox Lite (RPI).
3. **Power On**: Turn on your FxBlox Lite (RPI). After about 30 sec, the LED will blink yellow 5 times that indicating the update process started.
:::warning
In update process the LED blinks red and green. This phase is very critical, and any mistake in this phase cause breaking FxBlox Lite (RPI).
:::
4. After about 10 minutes, the LED blinks red only. Remove the USB drive.
5. Restart the FxBlox Lite (RPI) by unplugging and plugging back the power.

### Step 4: Post-Update

**Be patient on the first boot, post-update!** The FxBlox automatically reboots 3 times, and will go through a series of lights. This **full process** should take about **30 minutes** to fully process the update and show the FxBlox WiFi.

Please wait for `10 minutes` before doing anything. You may think it is done or stuck or it is turned off, but be sure that it is processing the update for `10 minutes` after the frist boot. We will add LED indicators in the future updates.

:::info
**Future firmware updates will be automatic, eliminating the need for manual updates.**
:::

## First Time Setup
If this is your very first time setting up your FxBlox Lite (RPI), you will not be able to install the latest usb update. The reason for that is because "updating via usb" feature was not added in until a later firmware version.

To automatically get that version, you need to connect the Blox to the wifi first. You can do so by following these steps:

1. Download the latest iOS/Android app.
2. Follow prompts to create password and connect Metamask.
3. If possible, skip format disk. [** * **](#troubleshoot)
4. Connect Blox to wifi. [** * **](#troubleshoot)
5. Now, wait 24 hours for the update to install. [** * **](#troubleshoot)
6. With new version installed, you can proceed with the [normal upgrading process.](#step-1-download-the-firmware)

### Troubleshoot:
* You may need to wait somewhere between 20-30 seconds for the button to appear.
* You may not get a `setup complete` message afer connecting to wifi, because you don't have the latest firmware version. Check your router settings to see if it connected properly.
* We recommend waiting 24 hours, because there are no indicators for when it is completed.
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
---
title: FxBlox Firmware Upgrade Guide
title: FxBlox Lite Plus (RK1)
id: fxblox-hardware
---

## Preparing Your FxBlox
## Updating Your FxBlox Lite Plus (RK1)

:::warning
If you have setup FxBlox **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. You can **format the drive after completing setup** and by **click and holding anywhere on the Hard Drive info box** until the pop-up option appears. See more [details here](./fxblox-app.md/#format-drive)
If you were helping test nightly firmware releases **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. **See more [details here.](./fxblox-app.md/#format-drive)**
:::

### Step 1: Download the Firmware
Expand Down Expand Up @@ -50,9 +50,7 @@ Before starting, make sure that your USB stick is **32GB or smaller**. Anything
5. Restart the FxBlox by unplugging and plugging back the power.

### Step 4: Post-Update
:::warning
**Be patience on the first boot, post-update!** The FxBlox automatically reboots 3 times, and will go through a series of lights. This **full process** should take about **30 minutes** to fully process the update and show the FxBlox WiFi.
:::
**Be patient on the first boot, post-update!** The FxBlox automatically reboots 3 times, and will go through a series of lights. This **full process** should take about **30 minutes** to fully process the update and show the FxBlox WiFi.

**Leave it plugged in!** At any time, you may think it is done or stuck or it is turned off, but be rest assured that it is processing the update. After automatic restarts are done, the FxBlox will proceed to show a variety of colors including: <font color="Blue">blue</font>, <font color="green"> green</font>, <font color="cyan"> cyan</font>, yellow, off, <font color="red"> red</font>; in that order. This process make take around **10 minutes** until LEDs turn flashing <font color="cyan"> cyan</font>.

Expand Down
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ id: join
- If the `Account` and `Join` buttons are greyed out, it means the blox is still syncing the chain data. It may take a few minutes to up to a day depending on the speed of the attached USB and internet speed. We will add a more visual indicator of this in future releases.

:::warning
If you have setup FxBlox **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. You can **format the drive after completing setup** and by **click and holding anywhere on the Hard Drive info box** until the pop-up option appears. See more [details here](./fxblox-app.md/#format-drive)
If you were helping test nightly firmware releases **before** official testnet launch, you will be required to format drive to clear out old/incompatible chain data. **See more [details here.](./fxblox-app.md/#format-drive)**
:::

2. In the FxBlox app, go to `Settings > Pools`. Join a pool nearest to your city. Choose the one closest to you from the list. Please note, that if you choose a pool that is far from you, the request will automatically rejected by the system.
Expand Down
File renamed without changes.
40 changes: 0 additions & 40 deletions docs/release/functionyard/fxblox-hardware-rpi.md

This file was deleted.

108 changes: 0 additions & 108 deletions docs/release/testnet.md

This file was deleted.

13 changes: 7 additions & 6 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -26,14 +26,15 @@ const sidebars = {
label:'Functionyard Testnet',
link: {
type:'doc',
id:'release/functionyard/index',
id:'functionyard/index',
},
items:[
'release/functionyard/fxblox-hardware',
'release/functionyard/fxblox-app',
'release/functionyard/join',
'release/functionyard/metamask',
'release/functionyard/dapps',
'functionyard/fxblox-hardware-rpi',
'functionyard/fxblox-hardware',
'functionyard/fxblox-app',
'functionyard/join',
'functionyard/metamask',
'functionyard/dapps',
]
},
{
Expand Down
Loading