Hello, this is the first non-source release of Nekot for the Copico Bonobo 2.4!

This is nekot-bonobo-quick-release/nebo-2025-03-27.zip

This is compiled for Ubuntu 24.04 x86_64 GNU/Linux
(but this probably works with almost any Ubuntu in the last few years).

The linux kernel version was 6.11.0-19-generic #19~24.04.1-Ubuntu SMP PREEMPT_DYNAMIC
(but this probably works with almost any Linux kernel in the last few years).

*  Unzip the archive.

*  Three files are fundamental:
    
   1. bonobo.uf2   (a compiled C program for Raspberry Pi Pico 1)

   2. tether            (an x86_64 Linux static binary)

   3. mcp-bonobo-only   (an x86_64 Linux static binary)

*  Plus the *.game files are needed.

*  All other files are for your curiosity or debugging.
   They come from this directory:
       coco-shelf/nekot-coco-microkernel/build-for-16k-bonobo

STEPS TO RUN:

0.  Plug the Copico Bonobo 2.4 card into your
    coco3, preferably without any MPI.  Leave the
    coco3 powered off, for now.

1.  Program the Pi Pico on the Bonobo board with the 
    "bonobo.uf2" file:

    Disconnect the USB cable for 5 seconds.
    Plug the USB into your Linux box.
    Wait 5 seconds.
    Type "df" and look for the final /media/ mount path,
       like /media/strick/RPI-RP2/
    Copy bonobo.uf2 into that mount:
       cp -vf bonobo.uf2 /media/strick/RPI-RP2/

    Leave the USB cable plugged in.

2.  Copy all the *.game files into your /tmp/ directory
    (which is where mcp-bonobo-only will look for them):

        cp -v *.game /tmp/

3.  In one shell, run ./mcp-bonobo-only
    (To see configurable flags, run `./mcp-bonobo-only --help`).

4.  In another shell, run ./tether
    (To see configurable flags, run `./tether --help`).

5.  Turn on your Coco3 on.
    If the screen is weird, reset it once.
    You should see Nekot running.

6.  These are the temporary commands you can run:

    0   stop running a game
    L   conway's Life
    R   bogus demo saying Red    (chains to Green)
    G   bogus demo saying Green  (chains to Blue)
    B   bogus demo saying Blue   (chains to Red)
    4   very incomplete Forth interpreter, but you can try `23 42 * .` 
    S   spacewar (kinda broken, not fixed)

    Hit BREAK to background a game, and BREAK to foreground it.
    (while it is backgrounded, you can use the 0 command to kill it.)

7.  If the ./tether command exits, run it again,
    and do the following step, too.

8.  If the LED on the Pi Pico blinks in Threes,
    that means it hit a fatal error.  Unplug the USB for 5 seconds
    and plug it back in.
       (now the LED flashes rapidly (10Hz) -- that means
       the Bonobo is HALTing your coco, and you must
       reset it.)
    Then hit RESET on your coco.
    And you're back to Nekot.

No multiplayer Chat or Games or APIs are available yet.

REPOS:

  https://github.com/strickyak/nekot-coco-microkernel

  https://github.com/strickyak/copico-bonobo

  https://github.com/strickyak/coco-shelf


