Port MicroPython

Author: object-Object

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "riscof/riscv-arch-test"]
 	path = riscof/riscv-arch-test
 	url = https://github.com/riscv-non-isa/riscv-arch-test
+[submodule "micropython/micropython"]
+	path = micropython/micropython
+	url = https://github.com/micropython/micropython

micropython/compile_flags.txt

@@ -0,0 +1,2 @@
+-I./micropython
+-I./mlogv32

micropython/micropython

@@ -0,0 +1,60 @@
+# Include the core environment definitions; this will set $(TOP).
+include ../micropython/py/mkenv.mk
+
+# Include py core make definitions.
+include $(TOP)/py/py.mk
+include $(TOP)/extmod/extmod.mk
+
+# Define toolchain and other tools.
+CROSS_COMPILE ?= riscv32-unknown-elf-
+
+# Set CFLAGS and libraries.
+RV32_ARCH ?= rv32ima_zicsr
+RV32_ABI = ilp32
+
+AFLAGS += -march=$(RV32_ARCH) -mabi=$(RV32_ABI)
+CFLAGS += -march=$(RV32_ARCH) -mabi=$(RV32_ABI) -ffreestanding -I. -I$(BUILD) -I$(TOP)
+LDFLAGS += -march=$(RV32_ARCH) -mabi=$(RV32_ABI) -nostartfiles -Tlink.x
+
+LIBS += -lm
+
+ifeq ($(DEBUG), 1)
+CFLAGS += -Og
+else
+CFLAGS += -Os
+endif
+
+# Define the required source files.
+SRC_C = \
+	init.c \
+	main.c \
+	mphalport.c \
+	shared/readline/readline.c \
+	shared/runtime/gchelper_generic.c \
+	shared/runtime/pyexec.c \
+	shared/runtime/stdout_helpers.c \
+
+SRC_S = \
+	entry.s \
+
+# Define source files containing qstrs.
+SRC_QSTR += shared/readline/readline.c shared/runtime/pyexec.c
+
+# Define the required object files.
+OBJ = $(PY_O) $(addprefix $(BUILD)/, $(SRC_C:.c=.o) $(SRC_S:.s=.o))
+
+# Define the top-level target, the main firmware.
+all: $(BUILD)/firmware.bin $(BUILD)/firmware.elf
+
+# Define how to build the firmware.
+$(BUILD)/firmware.elf: $(OBJ)
+	$(ECHO) "LINK $@"
+	$(Q)$(CC) $(LDFLAGS) -o $@ $^ $(LIBS)
+	$(Q)$(SIZE) $@
+
+$(BUILD)/firmware.bin: $(BUILD)/firmware.elf
+	$(ECHO) "GEN $@"
+	$(Q)$(OBJCOPY) --output-target binary $< $@
+
+# Include remaining core make rules.
+include $(TOP)/py/mkrules.mk

micropython/mlogv32/Makefile

@@ -0,0 +1,47 @@
+.section .text.start
+
+.global _start
+_start:
+    # initialize icache
+    la t0, __etext
+    .insn i CUSTOM_0, 0, zero, t0, 0
+
+    # set stack pointer and global pointer
+    la t1, _stack_start
+    andi sp, t1, -16
+    add s0, sp, zero
+
+    .option push
+    .option norelax
+    la gp, __global_pointer$
+    .option pop
+
+    # initialize .data
+    la t0, __sidata
+    la t1, __sdata
+    la t2, __edata
+load_data:
+    bgeu t1, t2, data_done
+    lb t3, 0(t0)
+    sb t3, 0(t1)
+    addi t0, t0, 1
+    addi t1, t1, 1
+    j load_data
+data_done:
+    
+    # clear .bss
+    la t0, __sbss
+    la t1, __ebss
+clear_bss:
+    bgeu t0, t1, bss_done
+    sb zero, 0(t0)
+    addi t0, t0, 1
+    j clear_bss
+bss_done:
+
+    # jump to C code
+    call main
+
+    # if main returns, halt the processor
+    li t0, 0xfffffff0
+    sw zero, 0(t0)    

micropython/mlogv32/entry.s

@@ -0,0 +1,11 @@
+#include "py/mpconfig.h"
+#include "py/mphal.h"
+#include "uart.h"
+
+void init(void) {
+    *UART0_FCR = 0b111;
+}
+
+void deinit(void) {
+    mp_hal_stdout_tx_str("Halting.");
+}

micropython/mlogv32/init.c

@@ -0,0 +1,2 @@
+void init(void);
+void deinit(void);

micropython/mlogv32/init.h

@@ -0,0 +1,56 @@
+ENTRY(_start);
+
+MEMORY {
+    ROM  (rx)  : ORIGIN = 0x00000000, LENGTH = 512K
+    RAM  (rwx) : ORIGIN = 0x80000000, LENGTH = 512K
+}
+
+_stack_start = ORIGIN(RAM) + LENGTH(RAM);
+
+SECTIONS {
+    .text : {
+        __stext = .;
+
+        KEEP(*(.text.start));
+        *(.text.reset);
+        *(.text .text.*);
+
+        . = ALIGN(4);
+        __etext = .;
+    } > ROM
+
+    .rodata : ALIGN(4) {
+        . = ALIGN(4);
+        __srodata = .;
+
+        *(.srodata .srodata.*);
+        *(.rodata .rodata.*);
+
+        . = ALIGN(4);
+        __erodata = .;
+    } > ROM
+
+    .data : ALIGN(4) {
+        . = ALIGN(4);
+        __sdata = .;
+
+        __global_pointer$ = . + 0x800;
+        *(.sdata .sdata.* .sdata2 .sdata2.*);
+        *(.data .data.*);
+
+        . = ALIGN(4);
+        __edata = .;
+    } > RAM AT > ROM
+
+    __sidata = LOADADDR(.data);
+
+    .bss (NOLOAD) : ALIGN(4) {
+        . = ALIGN(4);
+        __sbss = .;
+
+        *(.sbss .sbss.* .bss .bss.*);
+
+        . = ALIGN(4);
+        __ebss = .;
+    } > RAM
+}

micropython/mlogv32/link.x

@@ -0,0 +1,47 @@
+#include "py/builtin.h"
+#include "py/compile.h"
+#include "py/gc.h"
+#include "py/mperrno.h"
+#include "py/stackctrl.h"
+#include "shared/runtime/gchelper.h"
+#include "shared/runtime/pyexec.h"
+
+// Allocate memory for the MicroPython GC heap.
+static char heap[4096];
+
+void main(void) { // NOLINT
+    // Initialise the MicroPython runtime.
+    mp_stack_ctrl_init();
+    gc_init(heap, heap + sizeof(heap));
+    mp_init();
+
+    // Start a normal REPL; will exit when ctrl-D is entered on a blank line.
+    pyexec_friendly_repl();
+
+    // Deinitialise the runtime.
+    gc_sweep_all();
+    mp_deinit();
+}
+
+// Handle uncaught exceptions (should never be reached in a correct C implementation).
+void nlr_jump_fail(void *val) {
+    for (;;) {
+    }
+}
+
+// Do a garbage collection cycle.
+void gc_collect(void) {
+    gc_collect_start();
+    gc_helper_collect_regs_and_stack();
+    gc_collect_end();
+}
+
+// There is no filesystem so stat'ing returns nothing.
+mp_import_stat_t mp_import_stat(const char *path) {
+    return MP_IMPORT_STAT_NO_EXIST;
+}
+
+// There is no filesystem so opening a file raises an exception.
+mp_lexer_t *mp_lexer_new_from_file(qstr filename) {
+    mp_raise_OSError(MP_ENOENT);
+}

micropython/mlogv32/main.c

@@ -0,0 +1,54 @@
+#include <stdint.h>
+#include "init.h"
+
+// Python internal features.
+#define MICROPY_ENABLE_GC                       (1)
+#define MICROPY_HELPER_REPL                     (1)
+#define MICROPY_ERROR_REPORTING                 (MICROPY_ERROR_REPORTING_TERSE)
+#define MICROPY_FLOAT_IMPL                      (MICROPY_FLOAT_IMPL_FLOAT)
+
+#define MICROPY_EMIT_RV32                       (1)
+#define MICROPY_EMIT_INLINE_RV32                (1)
+
+#define MICROPY_CONFIG_ROM_LEVEL                (MICROPY_CONFIG_ROM_LEVEL_CORE_FEATURES)
+
+// Fine control over Python builtins, classes, modules, etc.
+#define MICROPY_PY_ASYNC_AWAIT                  (0)
+#define MICROPY_PY_IO                           (0)
+
+#define MICROPY_PY_BUILTINS_HELP                (1)
+#define MICROPY_PY_BUILTINS_HELP_MODULES        (1)
+#define MICROPY_PY_FSTRINGS                     (1)
+#define MICROPY_PY_MATH_CONSTANTS               (1)
+#define MICROPY_PY_MATH_FACTORIAL               (1)
+#define MICROPY_PY_PLATFORM                     (1)
+#define MICROPY_PY_RANDOM                       (1)
+
+#define MICROPY_PY_ASYNCIO                      (0)
+#define MICROPY_PY_IO_IOBASE                    (0)
+#define MICROPY_PY_JSON                         (0)
+#define MICROPY_PY_OS                           (0)
+#define MICROPY_PY_SELECT                       (0)
+#define MICROPY_PY_SELECT_SELECT                (0)
+#define MICROPY_PY_SYS_PS1_PS2                  (0)
+#define MICROPY_PY_SYS_STDFILES                 (0)
+#define MICROPY_PY_SYS_STDIO_BUFFER             (0)
+#define MICROPY_PY_TIME                         (0)
+
+// Type definitions for the specific machine.
+
+typedef intptr_t mp_int_t; // must be pointer size
+typedef uintptr_t mp_uint_t; // must be pointer size
+typedef long mp_off_t;
+
+// We need to provide a declaration/definition of alloca().
+#include <alloca.h>
+
+// Define the port's name and hardware.
+#define MICROPY_HW_BOARD_NAME "mindustry"
+#define MICROPY_HW_MCU_NAME   "mlogv32"
+
+#define MP_STATE_PORT MP_STATE_VM
+
+#define MICROPY_PORT_INIT_FUNC init()
+#define MICROPY_PORT_DEINIT_FUNC deinit()