Build a RISC OS module using the PRM documentation using only AI

by gerph 1 month ago

macOS • xterm-256color • fish 6 views

I had a short break from real work today, whilst I waited for AWS deployments, to experiment with using AI to build a module interface.

I selected the Joystick module as one of the simplest implementations that exists. I wanted to see whether a stub could be built using only the PRM documentation and simple guidance within the RISC OS Build Environment.

What I got out wasn’t unreasonable. It wasn’t how I would have done it exactly, but it’s quite close, and it’s done some things I’d have not thought of.

It has decided that the author is RISC OS Open, which is clearly wrong. I can probably provide some extra guidance for that in the environment. It decided to use the ZN449 chip, which isn’t a terrible choice have made, and it’s stubbed the routines in a quite reasonable manner.

And the code compiled - it built it to check.

At the end I told it to add CI and git management before committing the code itself.

Here’s the resulting repository:

https://github.com/gerph/riscos-joystick-ai

More recordings by gerph

Browse all

TCC compiles a RISC OS 'hello world' program 2:20

by gerph 9 months ago

Freeway works! Hosts appear from other machines. 0:22

by gerph 6 years ago

Compiling Pascal code in Pyromaniac 1:06

by gerph 6 years ago

RISC OS 64 BBC BASIC with AArch64 assembly 0:37

by gerph 1 year ago

https://asciinema.org/a/853173

Copied!

Append ?t=30 to start the playback at 30s, ?t=3:20 to start the playback at 3m 20s.

See sharing docs for more link customization options.

Embed as image link

Use snippets below to display a preview image linking to this recording.
Ideal for places where scripts are not allowed, such as project README files.

HTML:

<a href="https://asciinema.org/a/853173" target="_blank"><img src="https://asciinema.org/a/853173.svg" /></a>

Copied!

Markdown:

[![asciicast](https://asciinema.org/a/853173.svg)](https://asciinema.org/a/853173)

Copied!

Embed the player

If you're embedding on your own page or on a site which permits script tags, you can use the full player widget:

<script src="https://asciinema.org/a/853173.js" id="asciicast-853173" async="true"></script>

Copied!

Paste the above script tag where you want the player to be displayed on your page.

See embedding docs for more player customization options.

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 853173.cast

Copied!

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="/assets/asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="/assets/asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/853173.cast',
      document.getElementById('player'),
      { cols: 116, rows: 45 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/853173 demo.gif

Copied!

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Copied!

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.