Documentation📄: RISC-V documentation updates

[johnwalicki]

What is the current documentation state?

When Open Horizon is supported on the RISC-V platform, we should add RISC-V to the documentation.

Where is this stated?

No response

Why do you want to improve the statement?

No response

Proposed Statement

No response

Additional context.

No response

[YashKamboj]

@johnwalicki A little more description on the issue would be really helpful

[joewxboy]

@YashKamboj part of the problem is that we don't have a definitive list of all of the pages that should be modified to include listing support for a new environment (operating system and/or architecture). As part of this issue, it would be helpful to review every page in the documentation to see if they mention OS or arch and compile a list.

That's likely a reason why this is not labeled "good first issue". :)

[joewxboy]

1. Need to modify _data/keyword.yml to add term for RISC-V, key likely "riscv64".
2. Need to search for all pages that are candidates for term inclusion. Try searching for "linux_ppc64le" as a starting point.
   Only found it in two files besides the keywords:

  docs/installing/adding_devices.md
  docs/installing/advanced_man_install.md

[davidyao19]

Hi @joewxboy I think we can help on it. Sorry that we've been too busy on our daily job in the past months and haven't got time on risc-v related work. But I think we can resume it from Oct., and build the doc and any needed code changes for risc-v support in OH.

[johnwalicki]

Hi @davidyao19 - Thanks! We are very interested in getting Open Horizon running on RISC-V hardware.

[johnwalicki]

I recently saw that Pine64 is working on a RISC-V board. I might buy one of these when they become available:
https://liliputing.com/pine64-is-working-on-a-risc-v-single-board-computer/

[johnwalicki]

We might see affordable risc-v boards early in 2023
https://www.phoronix.com/news/Ubuntu-StarFive-VisionFive-2

[johnwalicki]

There's a $88 USD board - starting to ship : https://ameridroid.com/products/visionfive-2?variant=40845950910498

[johnwalicki]

I follow the development of the Pine Star64 SBC - https://www.pine64.org/category/star64/

[johnwalicki]

Latest news about the Pine Star64 SBC - https://www.pine64.org/2023/03/01/february-update-things-are-taking-shape/

• We expect to have the Star64 available in March or beginning of April
• We had a working demo of Debian with XFCE at FOSDEM (thanks to ayufan)
• There is much interest in RISC-V platform and Star64 in particular
• The software on RISC-V is in early stages
• Star64’s significance: we believe that affordable RISC-V hardware will drive Linux development on the platform

[johnwalicki]

https://www.phoronix.com/news/ASUS-Tinker-V

[johnwalicki]

https://pine64.com/product/star64-model-a-4gb-single-board-computer/

[johnwalicki]

@joewxboy I just bought a Star64 board. I will be interested to test the Open Horizon agent on it.
https://pine64.com/product/star64-model-a-4gb-single-board-computer/

[joewxboy]

@johnwalicki That sold out quickly! I was able to order one of these: https://www.amazon.com/dp/B0BQYDTM9M?ref=myi_title_dp which should arrive in a month or so.

[johnwalicki]

In addition to the Star64 board (which hasn't arrived yet), I purchased a MangoPi 1GHz 1GB Allwinner D1 RISC-V board. It arrived and I've got it running Ubuntu Jammy

Linux nezha 5.19.0-rc1-d1 #trunk Fri Jul 22 12:44:22 MSK 2022 riscv64 riscv64 riscv64 GNU/Linux

I tried to install docker but there are no prebuilt docker binaries for the RISC-V architecture. Instead, I was able to apt install podman

$ sudo podman version
Version:      3.4.4
API Version:  3.4.4
Go Version:   go1.17.3
Built:        Wed Dec 31 19:00:00 1969
OS/Arch:      linux/riscv64

[johnwalicki]

Podman on RISC-V is running.

$ sudo podman run hello-world

Hello from Docker!
This message shows that your installation appears to be working correctly.

The next step is to compile the anax and hzn binaries for riscv64

[johnwalicki]

My Pine STAR64 arrived last week. I have it running

Linux star64 5.15.107 #1 SMP Mon May 15 17:57:25 UTC 2023 riscv64 riscv64 riscv64 GNU/Linux

but it will take some effort to get docker / podman installed on this Yocto based image.