snark13
527d4a6a18
libc/mem/:
• Split bank_io.c into bank_io_w3.c (existing W3 helpers, base 0xC000,
port 0xE2) and bank_io_w1.c (new mirror through W1, base 0x4000,
port 0xA2). Two .rel files so DCE picks only the needed group:
a W3-only user pulls ~70 bytes instead of all 134. W1 variants are
`--memory tiny`-only (any other mode runs code from W1 or uses W1
for the banked-code segment, swapping it crashes).
• mem_alloc.c: add CF=err checks for mem_free_block and mem_get_page
(were silently ignored), per-function docstrings on alloc/free/
get_page/info, drop the confused "wait wrong order" comment in
mem_info. Header sprinter_mem.h gets matching per-function doc.
libc/stdio/:
• Add hex_print.c (hex8/hex16/hex32, ~26 bytes) and dec_print.c
(dec8/dec16/dec32, ~170 bytes) ported from solid-c STDLIB.ASM.
Replaces the printf("%u"/"%X") wrappers in solid_helpers.c that
dragged in the 3-5 KB printf machinery.
- hex* use the classic cp 10 / sbc 0x69 / daa nibble→ASCII trick;
hex8 self-calls for the high nibble, hex16/hex32 tail-call hex8.
- dec32 is the master routine; dec8/dec16 jump into shared entry
points (__dec_entry3 / __dec_entry5). 32-bit subtract-power-of-10
keeps the high 16 bits in HL alt (shadow set).
- DISCOVERY: ESTEX PUTCHAR ($5B) on our Sprinter build preserves
the main register set + IX but CLOBBERS the shadow set
(BC'/DE'/HL'). solid-c's original code assumed otherwise and
garbled output for values ≥ 6 digits. Fix: save/restore HL alt
around the RST 10 in _dec_emit_or_skip. Documented in
memory/estex_putchar_abi.md.
• file.c: drop stdaux/stdprn (no Sprinter printer API), change
stdin/stdout/stderr fd markers to 0/-1/-2 (positive fds clash with
ESTEX OPEN return values), add TODO header pointing at v2 buffered
FILE rewrite (see docs/TODO.md for the Solid-C reference struct).
bin/sprinter-cc:
• --memory big and --memory huge now always use crt0_banked.s (was:
only with --bank flags), matching docs/memory_modes_implemented.md.
When the user has no --bank flags, generate a tiny stub with
`const uint8_t n_banks = 0;` and assemble bank.s for _bank_pages.
Without this fix, openenv with --memory big could not see the
estex_file_handle symbol exported by crt0_banked.
examples/openenv:
• Add usage of estex_file_handle to confirm the crt0_banked startup-
info is reachable. Local extern decl — keeps the symbol out of
sprinter.h since it only exists in big/huge builds.
examples/dec_test:
• New regression test covering hex8/16/32 and dec8/16/32 across the
interesting boundary values.
.gitignore: add .kilo/ (editor session cache).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
53 lines
1.5 KiB
C
53 lines
1.5 KiB
C
/*
|
|
* bank_io_w3.c — far-page accessors that swap window 3 (port 0xE2,
|
|
* base 0xC000). Save the current W3 page, set the target, do the
|
|
* byte/memcpy access, restore the saved page.
|
|
*
|
|
* Safe in `tiny`, `small`, `big` memory modes (W3 is free for data).
|
|
* NOT safe in `huge` — there banked code lives in W3.
|
|
*
|
|
* No DI/EI around the swap: ISRs that don't touch W3 are unaffected;
|
|
* concurrent W3 use from an ISR is unsafe.
|
|
*
|
|
* The `_w1` family (bank_io_w1.c) is the mirror through W1 and is
|
|
* `tiny`-only. See sprinter_mem.h for the full safety matrix.
|
|
*/
|
|
|
|
#include <stdint.h>
|
|
#include <string.h>
|
|
#include <sprinter.h>
|
|
#include <sprinter_mem.h>
|
|
|
|
uint8_t bank_load_byte(uint8_t phys_page, uint16_t off_in_window)
|
|
{
|
|
uint8_t saved = _io_page_w3;
|
|
sprinter_page_w3(phys_page);
|
|
uint8_t v = *((volatile uint8_t *)(0xC000u + off_in_window));
|
|
sprinter_page_w3(saved);
|
|
return v;
|
|
}
|
|
|
|
void bank_store_byte(uint8_t phys_page, uint16_t off_in_window, uint8_t v)
|
|
{
|
|
uint8_t saved = _io_page_w3;
|
|
sprinter_page_w3(phys_page);
|
|
*((volatile uint8_t *)(0xC000u + off_in_window)) = v;
|
|
sprinter_page_w3(saved);
|
|
}
|
|
|
|
void bank_read(uint8_t phys_page, uint16_t off, void *dst, uint16_t n)
|
|
{
|
|
uint8_t saved = _io_page_w3;
|
|
sprinter_page_w3(phys_page);
|
|
memcpy(dst, (const void *)(0xC000u + off), n);
|
|
sprinter_page_w3(saved);
|
|
}
|
|
|
|
void bank_write(uint8_t phys_page, uint16_t off, const void *src, uint16_t n)
|
|
{
|
|
uint8_t saved = _io_page_w3;
|
|
sprinter_page_w3(phys_page);
|
|
memcpy((void *)(0xC000u + off), src, n);
|
|
sprinter_page_w3(saved);
|
|
}
|