From 365c89c9e7706737671bbac8091ce5d571b43ff7 Mon Sep 17 00:00:00 2001 From: David Given Date: Tue, 18 Sep 2018 23:49:31 +0200 Subject: [PATCH] Updated READMEs with the MIPS platform. --- README | 3 ++- plat/linuxmips/README | 37 +++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 plat/linuxmips/README diff --git a/README b/README index b959ba4a1..c27385337 100644 --- a/README +++ b/README @@ -33,6 +33,7 @@ pc86 produces bootable floppy disk images for 8086 PCs linux386 produces ELF executables for PC Linux systems linux68k produces ELF executables for m68020 Linux systems linuxppc produces ELF executables for PowerPC Linux systems +linuxmips produces ELF executables for little-endian MIPS32r2 Linux systems cpm produces i80 CP/M .COM files rpi produces Raspberry Pi GPU binaries pdpv7 produces PDP/11 V7 Unix binaries @@ -194,4 +195,4 @@ Please enjoy. David Given (davidgiven on Github) dg@cowlark.com -2016-11-26 +2018-09-18 diff --git a/plat/linuxmips/README b/plat/linuxmips/README new file mode 100644 index 000000000..ab294db86 --- /dev/null +++ b/plat/linuxmips/README @@ -0,0 +1,37 @@ +The linuxmips platform +====================== + +linuxmips is a little-endian MIPS32r2 BSP that produces Linux MIPS executables. + +This port only implements a very limited number of system calls; basically, +just enough to make the demo apps run. Adding more is easy, but there are some +subtleties that require more thought. The port should be considered only in +proof-of-concept stage right now. + +Important note: you *can't* link access ELF shared libraries from these +executables. In other words, you have to all your work from inside ACK. + +IEEE floating point is available, but requires an FPU. + +The executables are generated with aelfslod and are extremely simple; there's +one rwx ELF section which contains all the application's code and data. This +is not optimal, but it does work. Symbols are provided. + + +Bugs +==== + +isatty() is a stub and always returns 0. + + +Example command line +==================== + +ack -mlinuxmips -O -o linuxmips.exe examples/paranoia.c + +The file linuxmips.exe can then be run on a MIPS32r2 Linux machine (or on an +emulation thereof). + + +David Given +dg@cowlark.com