This is the Neotron OS. It will run on any system which can execute ARM Thumb v7-M instructions, and has an implementation of the Neotron BIOS.

This OS is a work in progress. We intend to support:

• Calling BIOS APIs
• Text mode VGA console
• Serial console
• Starting a command-line shell application
• Executing applications from RAM
• MBR/FAT32 formatted block devices with standard open/close/read/write file semantics
• Basic networking
• Music playback
• Various keyboard layouts
• Ethernet / WiFi networking

Your board will need an appropriate Neotron BIOS installed, and you need to have OpenOCD running for your particular board. You also need to set the linker arguments so you link the binary to suit the memory available on your system.

The Neotron Pico has some special memory requirements - in particular, the flash lives at 0x1000_0000 and not 0x0000_0000. There is 1920 KiB of flash, and 240 KiB of RAM available.

$ git clone https://github.com/neotron-compute/Neotron-OS.git
$ cd Neotron-OS
$ git submodule update --init
$ RUSTFLAGS="-C link-arg=-Tneotron-os-pico.ld" cargo build --release --target=thumbv6m-none-eabi

Systems which reserve the second 512 KiB of Flash and first 256 KiB of SRAM for the OS can use this linker script. These systems include the Neotron 340ST.

$ git clone https://github.com/neotron-compute/Neotron-OS.git
$ cd Neotron-OS
$ git submodule update --init
$ RUSTFLAGS="-C link-arg=-Tneotron-os-256k.ld" cargo run --release

Systems which reserve the second 128 KiB of Flash and first 26 KiB of SRAM for the OS can use this linker script. These systems include the Neotron 32.

$ git clone https://github.com/neotron-compute/Neotron-OS.git
$ cd Neotron-OS
$ git submodule update --init
$ RUSTFLAGS="-C link-arg=-Tneotron-os-26k.ld" cargo run --release

TODO: Think of a better way of setting the memory limits for a particular OS build.

• Basic println! to the text buffer.

Neotron-OS Copyright (c) The Neotron Developers, 2020

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.