snark13
c71e249a4e
First substantive commit: the entire Sprinter C compiler tree on top of
the bare README+gitignore initial commit.
What's in here:
bin/sprinter-cc — driver script invoking SDCC + linker + mkexe
libc/ — Sprinter-specific libc layer over ESTEX/BIOS
(conio, gfx, io, mem, stdio + headers)
runtime/ — crt0 variants (default/small/banked/minimal)
+ heap + bank trampolines
toolchain/ — mkexe (SprintEXE packer, C + tests)
examples/ — 30 demo programs (gfx, file I/O, env, time, …)
lib/Makefile — builds the libc archive (sprinter.lib)
docs/ — converted Sprinter manuals + asm reference samples
third_party/ — solid-c reference compiler dump + sdcc setup script
release_docs/ — packaging / release notes
gitignore overhaul:
• Drop dangerous blanket patterns: *.asm (would hide docs/samples/*.asm)
and *.exe (case-insensitive match was hiding third_party/solid-c/*.EXE
on macOS APFS). Replaced with examples/*/*.{asm,exe,…} and lib/*.lib.
• Restore tracking of toolchain/mkexe/tests/{one,big}.bin — those are
INPUT fixtures, not build outputs.
• Collapse the duplicated SDCC/C/Sdcc sections into one section per
concern (build outputs / vendored / OS-junk).
• Add .sprinter-cc-*/, build/ (catches lib/build/ too), .claude/.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
71 lines
2.3 KiB
C
71 lines
2.3 KiB
C
/*
|
|
* time.h — system clock access via ESTEX $21 / $22.
|
|
*
|
|
* getdatetime() — read current date/time into a datetime_t.
|
|
* setdatetime() — set system clock from a datetime_t.
|
|
* Returns 0 on success, -1 with errno set on failure.
|
|
*
|
|
* Date/time is the raw Sprinter clock — no epoch conversion, no time_t.
|
|
*/
|
|
|
|
#ifndef TIME_H
|
|
#define TIME_H
|
|
|
|
#include <stdint.h>
|
|
|
|
typedef struct {
|
|
uint8_t day; /* 1..31 */
|
|
uint8_t month; /* 1..12 */
|
|
uint16_t year; /* full year, e.g. 2026 */
|
|
uint8_t hour; /* 0..23 */
|
|
uint8_t minute; /* 0..59 */
|
|
uint8_t second; /* 0..59 */
|
|
uint8_t dow; /* day of week, 1-based: 1=Sun..7=Sat — see DOW_* */
|
|
} datetime_t;
|
|
|
|
/* Sprinter ESTEX SYSTIME dow encoding (verified empirically):
|
|
* 1-based, week starts on Sunday — matches DOS INT 21h AH=2A+1. */
|
|
#define DOW_SUN 1
|
|
#define DOW_MON 2
|
|
#define DOW_TUE 3
|
|
#define DOW_WED 4
|
|
#define DOW_THU 5
|
|
#define DOW_FRI 6
|
|
#define DOW_SAT 7
|
|
|
|
void getdatetime(datetime_t *dt);
|
|
int setdatetime(const datetime_t *dt);
|
|
|
|
/* ------------------------------------------------------------------
|
|
* POSIX <time.h> API — implemented by SDCC's z80.lib (time.rel etc.).
|
|
* We provide RtcRead() in libc/io/time.c which bridges to getdatetime().
|
|
*
|
|
* Layout of struct tm matches SDCC's z80 ABI exactly (__TIME_UNSIGNED=1
|
|
* variant): tm_sec/min/hour/mday/mon/wday/isdst/hundredth are 1 byte,
|
|
* tm_year/tm_yday are 16-bit ints. Total 12 bytes.
|
|
* ------------------------------------------------------------------ */
|
|
|
|
struct tm {
|
|
unsigned char tm_sec; /* 0..60 */
|
|
unsigned char tm_min; /* 0..59 */
|
|
unsigned char tm_hour; /* 0..23 */
|
|
unsigned char tm_mday; /* 1..31 */
|
|
unsigned char tm_mon; /* 0..11 (POSIX, not Sprinter native!) */
|
|
int tm_year; /* years since 1900 */
|
|
unsigned char tm_wday; /* 0..6 (Sunday=0, POSIX) */
|
|
int tm_yday; /* 0..365 */
|
|
unsigned char tm_isdst;
|
|
unsigned char tm_hundredth; /* SDCC extension; we leave 0 */
|
|
};
|
|
|
|
typedef unsigned long time_t;
|
|
|
|
time_t time (time_t *t);
|
|
struct tm *gmtime (time_t *timep);
|
|
struct tm *localtime(time_t *timep);
|
|
time_t mktime (struct tm *timeptr);
|
|
char *asctime (struct tm *timeptr);
|
|
char *ctime (time_t *timep);
|
|
|
|
#endif
|