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.

[johnwalicki]

I've got a Lichee Pi4 RISC-V board that I'm trying to install the horizon agent on. I've been hacking at the agent-install.sh script. Have it working all the way to downloading the agent binaries.

2024-07-28 21:08:15 Downloading file https://cp-console.ieam42-edge-8e....us-south.containers.appdomain.cloud/edge-css/api/v1/objects/IBM/agent_files/horizon-agent-linux-deb-riscv64.tar.gz/data ...
2024-07-28 21:08:15 ERROR: HTTP code 403 from: downloading https://cp-console.ieam42-edge-8e....us-south.containers.appdomain.cloud/edge-css/api/v1/objects/IBM/agent_files/horizon-agent-linux-deb-riscv64.tar.gz/data, stdout: Unauthorized. The object may not exist or be public.

Looks like I will have to compile the agent binaries myself?
I don't see the riscv64 binaries available in any of the anax release packages
https://github.com/open-horizon/anax/releases/

Before I go down that journey, has anyone compiled the agent binaries for risc-v?
@joewxboy @dlarson04

[dlarson04]

@johnwalicki riscv64 is not an architecture that is currently being built

[joewxboy]

@bencourliss We had discussed adding RISC-V to the packages being built. Any idea where that stands currently? Are there any impediments or roadblocks?

[bencourliss]

@joewxboy Are we talking just the Debian and RPM packages? For the GitHub Action, we use https://github.com/uraimo/run-on-arch-action to build the non-amd64 architectures. It appears that riscv64 is a supported architecture so theoretically we can support building it. Would require changes to the Github Action workflow and the release process needs to be changed to publish those packages once built. I don't believe there is a UBI9 Docker base image available for riscv64 however.

[joewxboy]

@joewxboy Are we talking just the Debian and RPM packages? ... I don't believe there is a UBI9 Docker base image available for riscv64 however.

@johnwalicki any feedback for Ben?

[johnwalicki]

@joewxboy @bencourliss - Do you really need UBI9 containers to build the hzn and anax binaries? Those would only be needed for the anax-in-container makefiles. You could skip the anax-in-container step initially.

[johnwalicki]

Tracking riscv64 architecture support in this issue
open-horizon/anax#4125