Documentation of aarch64 port on Spectrum OS upstream

Documentation of aarch64 port on Spectrum OS upstream

[Ville Ilvonen]

Hi,

We've built the wayland demo branch on aarch64 port and added some other 
apps on it to showcase embedded virtualization with Spectrum OS.

The build configuration for the reference device is documented [1] with 
the out-of-tree build configuration as agreed in our earlier 
discussion[2]. There's also some additional accompanied documentation on 
binary cache we have used with aarch64 and could be of general use. I'd 
like to see that documentation upstreamed as much as possible.

Would it make sense to link this work from Spectrum documentation? To 
indicate work in progress aarch64 support with known issues on a ref. 
device and avoid forking this documentation?

The practical benefit is that anyone interested in building Spectrum OS 
for an aarch64 device using vendor BSP would have some reference linked 
from Spectrum OS documentation - e.g. an initial porting guide as even 
the x86_64 does not yet use the build configuration. Additionally, I 
don't want to fragment Spectrum OS ports and their documentation further 
than necessary.

Best,

-Ville

[1] https://github.com/tiiuae/spectrum-config-imx8/blob/main/README.md
[2] 
https://spectrum-os.org/lists/archives/spectrum-discuss/CAP-nJwHTmROzMbyYNtrTrOdXGV-iJvwPuJ3FSZb3gLy5R3z80Q@mail.gmail.com/ 

Re: Documentation of aarch64 port on Spectrum OS upstream

[Alyssa Ross]

[-- Attachment #1: Type: text/plain, Size: 1913 bytes --]

On Mon, Nov 14, 2022 at 02:02:52PM +0200, Ville Ilvonen wrote:
> Hi,
>
> We've built the wayland demo branch on aarch64 port and added some other
> apps on it to showcase embedded virtualization with Spectrum OS.
>
> The build configuration for the reference device is documented [1] with the
> out-of-tree build configuration as agreed in our earlier discussion[2].
> There's also some additional accompanied documentation on binary cache we
> have used with aarch64 and could be of general use. I'd like to see that
> documentation upstreamed as much as possible.
>
> Would it make sense to link this work from Spectrum documentation? To
> indicate work in progress aarch64 support with known issues on a ref. device
> and avoid forking this documentation?
>
> The practical benefit is that anyone interested in building Spectrum OS for
> an aarch64 device using vendor BSP would have some reference linked from
> Spectrum OS documentation - e.g. an initial porting guide as even the x86_64
> does not yet use the build configuration. Additionally, I don't want to
> fragment Spectrum OS ports and their documentation further than necessary.

Yeah, I think it would be a great idea to link to that from the build
configuration page in the Spectrum documentation, as an example.

To clarify, I don't expect the *generic* x86_64 image to use a build
configuration file, nor would I expect a generic aarch64 image to.
The build configuration file is there for when it's neccesary to
override the defaults, for example to use a custom kernel.  (But it
would also make sense to have a commented *example* build configuration
file in the Spectrum repo, to be a starting point for users.)

> Best,
>
> -Ville
>
> [1] https://github.com/tiiuae/spectrum-config-imx8/blob/main/README.md
> [2] https://spectrum-os.org/lists/archives/spectrum-discuss/CAP-nJwHTmROzMbyYNtrTrOdXGV-iJvwPuJ3FSZb3gLy5R3z80Q@mail.gmail.com/
>
>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]