/* RETRO ------------------------------------------------------ A personal, minimalistic forth Copyright (c) 2016 - 2019 Charles Childers This is a quick interface layer that loads and runs a source file, then saves a new image file. It's used to merge the `retro.forth` into the base `rx` image. In addition to the above, this tracks some statistics on stack usage. ---------------------------------------------------------- */ #include #include #include #include #include #include /* To aid in readability */ #define TOS data[sp] #define NOS data[sp-1] #define TORS address[rp] /* This assumes some knowledge of the ngaImage format for the Retro language. If things change there, these will need to be adjusted to match. */ #define TIB memory[7] #define D_OFFSET_LINK 0 #define D_OFFSET_XT 1 #define D_OFFSET_CLASS 2 #define D_OFFSET_SOURCE 3 #define D_OFFSET_HASH 4 #define D_OFFSET_STACK 5 #define D_OFFSET_RSTACK 6 #define D_OFFSET_FSTACK 7 #define D_OFFSET_DESCR 8 #define D_OFFSET_NAME 9 /* These settings can be overridden at compile time. */ #ifndef BIT64 #define CELL int32_t #define CELL_MIN INT_MIN + 1 #define CELL_MAX INT_MAX - 1 #else #define CELL int64_t #define CELL_MIN LLONG_MIN + 1 #define CELL_MAX LLONG_MAX - 1 #endif #ifndef IMAGE_SIZE #define IMAGE_SIZE 524288 /* Amount of RAM, in cells */ #endif #ifndef ADDRESSES #define ADDRESSES 256 /* Depth of address stack */ #endif #ifndef STACK_DEPTH #define STACK_DEPTH 256 /* Depth of data stack */ #endif /* Begin the actual code */ typedef void (*Handler)(void); CELL sp, rp, ip; CELL data[STACK_DEPTH]; CELL address[ADDRESSES]; CELL memory[IMAGE_SIZE + 1]; CELL ngaLoadImage(char *imageFile); void ngaPrepare(); void ngaProcessOpcode(CELL opcode); void ngaProcessPackedOpcodes(CELL opcode); int ngaValidatePackedOpcodes(CELL opcode); CELL max_sp, max_rsp; CELL Dictionary, Heap, Compiler; CELL notfound, interpret; CELL stack_pop(); void stack_push(CELL value); int string_inject(char *str, int buffer); char *string_extract(CELL at); int d_link(CELL dt); int d_xt(CELL dt); int d_class(CELL dt); int d_name(CELL dt); int d_lookup(CELL Dictionary, char *name); CELL d_xt_for(char *Name, CELL Dictionary); CELL d_class_for(char *Name, CELL Dictionary); void update_rx(); void execute(CELL cell); void evaluate(char *s); int not_eol(int ch); void read_token(FILE *file, char *token_buffer, int echo, int max); void dump_stack() { CELL i; if (sp == 0) return; printf("\nStack: "); for (i = 1; i <= sp; i++) { if (i == sp) printf("[ TOS: %lld ]", (long long)data[i]); else printf("%lld ", (long long)data[i]); } printf("\n"); } int include_file(char *fname) { FILE *fp; char source[2049]; int inBlock = 0; int tokens = 0; fp = fopen(fname, "r"); if (fp == NULL) return 0; while (!feof(fp)) { read_token(fp, source, 0, 2048); if (strcmp(source, "~~~") == 0) { if (inBlock == 0) inBlock = 1; else inBlock = 0; } else { if (inBlock == 1) { evaluate(source); tokens++; } } } fclose(fp); return tokens; } int main(int argc, char **argv) { int tokens, i; FILE *fp; ngaPrepare(); max_sp = 0; max_rsp = 0; ngaLoadImage(argv[1]); update_rx(); printf("Initial Image Size: %lld\n", (long long)Heap); for (i = 2; i < argc; i++) { tokens = include_file(argv[i]); printf(" + %lld tokens from %s\n", (long long)tokens, argv[i]); } update_rx(); printf("New Image Size: %lld\n", (long long)Heap); printf("MAX SP: %lld, RP: %lld\n", (long long)max_sp, (long long)max_rsp); if ((fp = fopen(argv[1], "wb")) == NULL) { printf("Unable to save the ngaImage!\n"); exit(2); } fwrite(&memory, sizeof(CELL), memory[3] + 1, fp); fclose(fp); if (sp != 0) { printf("Stack not empty!\n"); dump_stack(); } return 0; } /* Some I/O Parameters */ CELL stack_pop() { sp--; return data[sp + 1]; } void stack_push(CELL value) { sp++; data[sp] = value; } int string_inject(char *str, int buffer) { int m = strlen(str); int i = 0; while (m > 0) { memory[buffer + i] = (CELL)str[i]; memory[buffer + i + 1] = 0; m--; i++; } return buffer; } char string_data[8192]; char *string_extract(CELL at) { CELL starting = at; CELL i = 0; while(memory[starting] && i < 8192) string_data[i++] = (char)memory[starting++]; string_data[i] = 0; return (char *)string_data; } int d_link(CELL dt) { return dt + D_OFFSET_LINK; } int d_xt(CELL dt) { return dt + D_OFFSET_XT; } int d_class(CELL dt) { return dt + D_OFFSET_CLASS; } int d_name(CELL dt) { return dt + D_OFFSET_NAME; } int d_lookup(CELL Dictionary, char *name) { CELL dt = 0; CELL i = Dictionary; char *dname; while (memory[i] != 0 && i != 0) { dname = string_extract(d_name(i)); if (strcmp(dname, name) == 0) { dt = i; i = 0; } else { i = memory[i]; } } return dt; } CELL d_xt_for(char *Name, CELL Dictionary) { return memory[d_xt(d_lookup(Dictionary, Name))]; } CELL d_class_for(char *Name, CELL Dictionary) { return memory[d_class(d_lookup(Dictionary, Name))]; } /* Retro needs to track a few variables. This function is called as necessary to ensure that the interface stays in sync with the image state. */ void update_rx() { Dictionary = memory[2]; Heap = memory[3]; Compiler = d_xt_for("Compiler", Dictionary); notfound = d_xt_for("err:notfound", Dictionary); interpret = d_xt_for("interpret", Dictionary); } /* The `execute` function runs a word in the Retro image. */ void execute(CELL cell) { CELL opcode, a, i; rp = 1; ip = cell; while (ip < IMAGE_SIZE) { opcode = memory[ip]; if (ip == notfound) { printf("%s ?\n", string_extract(TIB)); } if (ngaValidatePackedOpcodes(opcode) != 0) { ngaProcessPackedOpcodes(opcode); } else { printf("\nERROR: Invalid instruction!\n"); printf("At %lld, opcode %lld\n", (long long)ip, (long long)opcode); printf("Instructions: "); a = opcode; for (i = 0; i < 4; i++) { printf("%lldd ", (long long)a & 0xFF); a = a >> 8; } printf("\n"); exit(1); } ip++; if (sp > max_sp) max_sp = sp; if (rp > max_rsp) max_rsp = rp; if (rp == 0) ip = IMAGE_SIZE; } } /* The `evaluate` function moves a token into the Retro token buffer, then calls the Retro `interpret` word to process it. */ void evaluate(char *s) { if (strlen(s) == 0) return; string_inject(s, TIB); stack_push(TIB); execute(interpret); } /* `read_token` reads a token from the specified file. It will stop on a whitespace or newline. It also tries to handle backspaces, though the success of this depends on how your terminal is configured. */ int not_eol(int ch) { return (ch != (char)10) && (ch != (char)13) && (ch != (char)32) && (ch != EOF) && (ch != 0); } void read_token(FILE *file, char *token_buffer, int echo, int max) { int ch, count; ch = getc(file); if (echo != 0) putchar(ch); count = 0; while (not_eol(ch)) { if ((ch == 8 || ch == 127) && count > 0) { count--; if (echo != 0) { putchar(8); putchar(32); putchar(8); } } else { token_buffer[count++] = ch; } if (count == max) { break; } ch = getc(file); if (echo != 0) putchar(ch); } token_buffer[count] = '\0'; } /* Nga ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Copyright (c) 2008 - 2017, Charles Childers Copyright (c) 2009 - 2010, Luke Parrish Copyright (c) 2010, Marc Simpson Copyright (c) 2010, Jay Skeer Copyright (c) 2011, Kenneth Keating ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ CELL ngaLoadImage(char *imageFile) { FILE *fp; CELL imageSize = 0; long fileLen; if ((fp = fopen(imageFile, "rb")) != NULL) { /* Determine length (in cells) */ fseek(fp, 0, SEEK_END); fileLen = ftell(fp) / sizeof(CELL); rewind(fp); /* Read the file into memory */ imageSize = fread(&memory, sizeof(CELL), fileLen, fp); fclose(fp); } else { printf("Unable to find the ngaImage!\n"); exit(1); } return imageSize; } void ngaPrepare() { ip = sp = rp = 0; for (ip = 0; ip < IMAGE_SIZE; ip++) memory[ip] = 0; /* 0 is the opcode for "no", a no-operation instruction */ for (ip = 0; ip < STACK_DEPTH; ip++) data[ip] = 0; for (ip = 0; ip < ADDRESSES; ip++) address[ip] = 0; } void inst_nop() { } void inst_lit() { ip++; stack_push(memory[ip]); } void inst_dup() { sp++; data[sp] = NOS; } void inst_drop() { data[sp] = 0; if (--sp < 0) ip = IMAGE_SIZE; } void inst_swap() { CELL a; a = TOS; TOS = NOS; NOS = a; } void inst_push() { rp++; TORS = stack_pop(); } void inst_pop() { stack_push(TORS); rp--; } void inst_jump() { ip = TOS - 1; inst_drop(); } void inst_call() { rp++; TORS = ip; ip = TOS - 1; inst_drop(); } void inst_ccall() { CELL quote, flag; quote = stack_pop(); flag = stack_pop(); if (flag != 0) { rp++; TORS = ip; ip = quote - 1; } } void inst_return() { ip = TORS; rp--; } void inst_eq() { NOS = (NOS == TOS) ? -1 : 0; inst_drop(); } void inst_neq() { NOS = (NOS != TOS) ? -1 : 0; inst_drop(); } void inst_lt() { NOS = (NOS < TOS) ? -1 : 0; inst_drop(); } void inst_gt() { NOS = (NOS > TOS) ? -1 : 0; inst_drop(); } void inst_fetch() { switch (TOS) { case -1: TOS = sp - 1; break; case -2: TOS = rp; break; case -3: TOS = IMAGE_SIZE; break; case -4: TOS = CELL_MIN; break; case -5: TOS = CELL_MAX; break; default: TOS = memory[TOS]; break; } } void inst_store() { if (TOS <= IMAGE_SIZE && TOS >= 0) { memory[TOS] = NOS; inst_drop(); inst_drop(); } else { ip = IMAGE_SIZE; } } void inst_add() { NOS += TOS; inst_drop(); } void inst_sub() { NOS -= TOS; inst_drop(); } void inst_mul() { NOS *= TOS; inst_drop(); } void inst_divmod() { CELL a, b; a = TOS; b = NOS; TOS = b / a; NOS = b % a; } void inst_and() { NOS = TOS & NOS; inst_drop(); } void inst_or() { NOS = TOS | NOS; inst_drop(); } void inst_xor() { NOS = TOS ^ NOS; inst_drop(); } void inst_shift() { CELL y = TOS; CELL x = NOS; if (TOS < 0) NOS = NOS << (TOS * -1); else { if (x < 0 && y > 0) NOS = x >> y | ~(~0U >> y); else NOS = x >> y; } inst_drop(); } void inst_zret() { if (TOS == 0) { inst_drop(); ip = TORS; rp--; } } void inst_end() { ip = IMAGE_SIZE; } void inst_ie() { /* retro-extend only provides one i/o device */ stack_push(1); } void inst_iq() { stack_push(0); stack_push(0); } void inst_ii() { putc(stack_pop(), stdout); fflush(stdout); } Handler instructions[] = { inst_nop, inst_lit, inst_dup, inst_drop, inst_swap, inst_push, inst_pop, inst_jump, inst_call, inst_ccall, inst_return, inst_eq, inst_neq, inst_lt, inst_gt, inst_fetch, inst_store, inst_add, inst_sub, inst_mul, inst_divmod, inst_and, inst_or, inst_xor, inst_shift, inst_zret, inst_end, inst_ie, inst_iq, inst_ii }; void ngaProcessOpcode(CELL opcode) { instructions[opcode](); } int ngaValidatePackedOpcodes(CELL opcode) { CELL raw = opcode; CELL current; int valid = -1; int i; for (i = 0; i < 4; i++) { current = raw & 0xFF; if (!(current >= 0 && current <= 29)) valid = 0; raw = raw >> 8; } return valid; } #define INST(n) ((opcode >> n) & 0xFF) != 0 void ngaProcessPackedOpcodes(CELL opcode) { if (INST(0)) instructions[opcode & 0xFF](); if (INST(8)) instructions[(opcode >> 8) & 0xFF](); if (INST(16)) instructions[(opcode >> 16) & 0xFF](); if (INST(24)) instructions[(opcode >> 24) & 0xFF](); }