Skip to content

README.md

Latest commit

 

History

History
104 lines (81 loc) · 3.64 KB

README.md

File metadata and controls

104 lines (81 loc) · 3.64 KB

Introduction

こたま | kotama | noun

Small-sized egg; small sphere.
An egg that is smaller than the standard grade.

This is an experiment for bare metal Go unikernels, as supported by TamaGo on RISCV64 low-memory, extension constrained targets.

This project requires the experimental GOOS=tamago compiler branch tamago1.26.1-73608-softfloat branch, such branch extends mainline tamago to support the following:

  • GOSOFT=1: compiler build time variable to enable soft float for riscv64, removing requirement for ad extensions and forcing single-threaded operation.

  • tiny: tamago library build tag for considerable reduction of RAM allocation requirements.

Supported RISC-V targets

Building the compiler

wget https://github.com/abarisani/tamago-go/archive/refs/heads/tamago1.26.1-73608-softfloat.zip
unzip tamago1.26.1-73608-softfloat.zip
cd tamago-go-tamago1.26.1-73608-softfloat/src && ./all.bash
cd ../bin && export TAMAGO=`pwd`/go

Note

As GOSOFT=1 not accounted in Go build ID, it is advised to go clean -cache before compiling for the first time with the GOSOFT=1 enabled compiler.

Building and running

You can build, and run the available targets as follows:

# AI Foundry Erbium processor (16MB RAM) with /opt/et/bin/erbium_emu
./run erbium

# AI Foundry ET-SoC-1 Minion Core (16MB RAM) with /opt/et/bin/sys_emu
./run etsoc1

# SiFive FU540 (6MB RAM) with qemu-system-riscv64
./run fu540

Tip

Extra arguments (e.g. -gdb for ET emulators) can be passed and are applied to the emulator command line.

Operation

build                                    # build information
cat         <path>                       # show file contents
date        (<time in RFC339 format>)?   # show/change runtime date and time
exit                                     # close session
halt                                     # halt the machine
help                                     # this help
info                                     # device information
kem                                      # benchmark post-quantum KEM
ls          (<path>)?                    # list directory contents
metrics                                  # show runtime metrics
peek        <hex addr> <size>            # memory display (use with caution)
poke        <hex addr> <hex value>       # memory write   (use with caution)
rand                                     # gather 32 random bytes
reset       (soft|warm)?                 # reset system
stack                                    # goroutine stack trace (current)
stackall                                 # goroutine stack trace (all)
test                                     # launch tests
uptime                                   # show system running time

> info
SoC ..........: Erbium (eb680000) @ 200 MHz (rv64cfimsux)
Runtime ......: go1.26.1 tamago/riscv64 thread 0
RAM ..........: 0x40000000-0x41000000 (16 MiB)
Text .........: 0x40010000-0x400f57c8 (917 KiB)
Data .........: 0x402452a0-0x40279bc0 (210 KiB)

License

Copyright (c) The kotama authors. All Rights Reserved.

These source files are distributed under the BSD-style license found in the LICENSE file.