Publish VCC Plus OSS source distribution for 3.6.2 build 60
This commit is contained in:
commit
c652a5276d
1192 files changed
+272368
No files matched your search
@@ -0,0 +1,31 @@
|
||||
// SPDX-License-Identifier: GPL-3.0-or-later
|
||||
#ifndef VCC_BANK_H
|
||||
#define VCC_BANK_H
|
||||
|
||||
#define BANK_FIRST_PAGE 0x28
|
||||
#define BANK_PAGE_SIZE 8192u
|
||||
#define BANK_CAPACITY 32768u
|
||||
|
||||
// Claim the BASIC program's dedicated physical blocks $28-$2B ($50000-$57FFF).
|
||||
// The caller reserves this RAM for assets. Opening and closing do not clear it.
|
||||
// Requires stock CoCo 3 BASIC task 0, 512 KiB or more, and a normal CMOC layout
|
||||
// below $8000. On RAM expansions retain BASIC's default $FF9B bank/prefix and
|
||||
// map; these write-only settings cannot be reconstructed after custom paging.
|
||||
// Compatible with gime_open(). Use from foreground code; open with IRQ enabled.
|
||||
// Return 1 on success, 0 for an unsupported setup or a second open.
|
||||
unsigned char bank_open(void);
|
||||
|
||||
// Transfer exactly length bytes at a byte offset measured from BANK_FIRST_PAGE.
|
||||
// A transfer may span pages. The complete range must fit BANK_CAPACITY.
|
||||
// Supply a caller-owned C buffer entirely below $8000; read requires writable
|
||||
// data, write accepts const data. A zero length needs no buffer and permits
|
||||
// offset == BANK_CAPACITY. Return 1 on success or 0 before copying any bytes.
|
||||
// Between calls both MMU tasks and the normal expansion group must stay under
|
||||
// BASIC's control. Each short copy restores the CPU mapping and interrupt mask.
|
||||
unsigned char bank_read(unsigned offset, void *destination, unsigned length);
|
||||
unsigned char bank_write(unsigned offset, const void *source, unsigned length);
|
||||
|
||||
// Release the claim. Safe to repeat. RAM contents survive until reused/reset.
|
||||
void bank_close(void);
|
||||
|
||||
#endif
|
||||
Reference in new issue
Block a user