...
Code Block |
---|
theme | Eclipse |
---|
title | CRC_FILE, Iterate CRC-32 on complete RAM file (from file pointer until EOF), using OS_Mv |
---|
|
OZ GN_Crc - RST 20H, DEFW $7C09
IN:
A = CRC_FILE (1)
HL = pointer to file buffer (local memory)
BC = buffer size
DE = 0, Initialize CRC-32 with FFFFFFFFh
DE > 0, (local) pointer to initial 4-byte CRC-32
IX = file handle of open file (using GN_Opf)
OUT, if call successful:
Fc = 0,
DEBC = CRC-32
OUT, if call failed:
Fc = 1,
A = RC_BAD ($04) - bad argument
A = RC_xxx (file & handle related errors)
Registers changed after return:
......HL/IXIY same
AFBCDE../.... different
|
Code Block |
---|
theme | Eclipse |
---|
title | Iterate CRC-32 partially on RAM file (from file pointer onwards), using OS_Gb |
---|
|
OZ GN_Crc - RST 20H, DEFW $7C09
IN:
A = CRC_PARTFILEBYTE (2)
HL = max bytes to read for this partial scan, or -1 for rest of file
DEBC = Initial CRC-32 or input from result of previous partial CRC-32 scan
IX = file handle of open file (using GN_Opf)
OUT, if call successful:
Fc = 0
DEBC = partial CRC-32 result (DE = high-word, BC = low-word), to be used for next scan iteration
Fc = 1, A _RC_Eof
DEBC = final CRC-32 result (DE = high-word, BC = low-word)
OUT, if call failed:
Fc = 1,
A = RC_BAD ($04) - bad argument
A = RC_xxx (file & handle related errors)
Registers changed after return:
......HL/IXIY same
AFBCDE../.... different
|
Code Block |
---|
theme | Eclipse |
---|
title | Iterate CRC-32 partially (buffered) on RAM file (from file pointer onwards), using OS_Mv |
---|
|
OZ GN_Crc - RST 20H, DEFW $7C09
IN:
A = CRC_PARTFILEBUF (3)
HL = pointer to file buffer (local memory),
BC = buffer size
DE = 0, Initialize CRC-32 with FFFFFFFFh
DE > 0, (local) pointer to 4-byte CRC-32 (initial CRC-32 or input from result of previous partial scan)
IX = file handle of open file (using GN_Opf)
OUT, if call successful:
Fc = 0
DEBC = partial CRC-32 result (DE = high-word, BC = low-word), to be used for next scan iteration
Fc = 1, A _RC_Eof
DEBC = final CRC-32 result (DE = high-word, BC = low-word)
OUT, if call failed:
Fc = 1,
A = RC_BAD ($04) - bad argument
A = RC_xxx (file & handle related errors)
Registers changed after return:
......HL/IXIY same
AFBCDE../.... different
|
Code Block |
---|
theme | Eclipse |
---|
title | Iterate CRC-32 on complete File Entry (File Card) |
---|
|
OZ GN_Crc - RST 20H, DEFW $7C09
IN:
A = CRC_EPFILE (4)
BHL = pointer to file entry
DE = 0, Initialize CRC-32 with FFFFFFFFh
DE > 0, (local) pointer to initial 4-byte CRC-32
OUT, if call successful:
Fc = 0,
DEBC = CRC-32
OUT, if call failed:
Fc = 1,
A = RC_BAD ($04) - bad argument
A = RC_xxx (file card related errors)
Registers changed after return:
......HL/IXIY same
AFBCDE../.... different |
Code Block |
---|
theme | Eclipse |
---|
title | Iterate CRC-32 partially on File Entry (File Card) |
---|
|
OZ GN_Crc - RST 20H, DEFW $7C09
IN:
A = CRC_PARTEPFILE (5)
Initial call:
BHL = pointer to File Entry
DE = max. size of bytes to read per partial scan
IX = pointer to local memory (allocated in application/popdown workspace, 12 bytes):
(IX + 0,23) : 24bitInitial offsetCRC-32 toor fileinput entryfrom imageresult (setof toprevious 0 on inital call), low-byte, high-byte orderpartial CRC-32 scan
(IX + 4,6) : Reserved for 24bit file pointer (initialized after first call)
(IX + 7,9) : Reserved for size of file entry (initialized after first call)
(IX + 10,11) : Reserved for max. bytes to read per partial scan
Subsequent calls:
BHL = 0 (this is returned automatically after initial call to this method)
IX = pointer to updated local memory of CRC-32 variables (12 bytes):
OUT:
(IXBHL += 30,4) :always
max.
bytes to read per Fc partial= scan0
(IX + 50,83) : Initialpartial CRC-32 or input from result of previous partial CRC-32 scan
OUT, if call successful:
Fc = 0result, low-byte, high-byte order
(IX + 4,6) : 24bit file pointer updated for next partial scan
(IX + 07,29) : 24bitRemaining file pointersize updated for next partial scan
(IX + 510,811) : max. bytes to read per partial CRC-32 result, low-byte, high-byte orderscan = DE (initial input)
Fc = 1
A = RC_Eof (complete file scanned)
(IX + 58,811) : final CRC-32 result, low-byte, high-byte order
OUT, if call failed:
byte order;
Fc = 1,
A = RC_BADxxx ($04)System -error badoccurred argument- file entry corrupt, not A = RC_xxx (file card related errors)
found, etc.)
Registers changed afteron return:
........BCDEHL/IXIY same
AF......AFBCDEHL/.... different |
None.
Notes
GN_Crc was implemented in OZ V4.5. It is used by the integrated EazyLink popdown to validate uploaded file content. FlashStore also uses it to display the checksum of a File Entry to be fetched to RAM. GN_Crc will be used more in future OZ developments.
If this system call is used in stand-alone applications, it is necessary to validate which OZ version the application is running on:
Code Block |
---|
include "fileio.def"
ld a,FA_PTR
ld ix,ffffh
ld de,0 ; result in DEBC
oz OS_Frm
ld a,44h ; OZ versions are embedded as hexnibbles in C register.
cp c
jr nc, not_ozv45 ; Check for OZ V4.5 failed (44h-45h gives Fc = 1) |
Code Block |
---|
title | Example for CRC - 32 on memory contents |
---|
|
include "crc32.def"
ld a,CRC_MEMA
ld hl,crctext
ld bc,crctext_end - crctext
ld de,0
oz GN_Crc
; CRC–32 returned is 0x414FA339 (DE = 0x414F, BC = 0xA339)
.crctext
defm "The quick brown fox jumps over the lazy dog"
.crctext_end |
Code Block |
---|
theme | Eclipse |
---|
title | Example for CRC - 32 on open RAM file using a buffer |
---|
|
include "crc32.def"
include "fileio.def"
DEFC FileBufferSize = 1280
DEFVARS $2000 ; "popdown" workspace from 2000H onwards
FileBuffer ds.b FileBufferSize ; buffer for file I/O
ENDDEF
LD A, OP_IN
LD BC,128
LD HL,filename ; pointer to local filename
LD D,H
LD E,L
OZ GN_Opf
JR C,not_available
ld a, CRC_FILE
ld hl,FileBuffer ; use buffer
ld bc,FileBufferSize
ld de,0 ; Use FFFFFFFFh as initial Crc-32
oz GN_Crc ; get CRC-32 of Open file (with buffer), returned in DEBC
oz GN_Cl ; close file
|
Code Block |
---|
theme | Eclipse |
---|
title | Example for CRC - 32 on open RAM file without buffer (slowest) |
---|
|
include "crc32.def"
include "fileio.def"
include "error.def"
LD A, OP_IN
LD BC,128
LD HL,filename ; pointer to local filename
LD D,H
LD E,L
OZ GN_Opf
JR C,not_available
ld a, CRC_PARTFILEBYTE
ld hl,1024 ; read 1024 bytes at a time from file
ld bc,$ffff
ld d,b
ld e,c ; Use FFFFFFFFh as initial Crc-32
.scan_file
oz GN_Crc ; get CRC-32 of Open file (no buffer)
jr c,check_eof
push bc
push de
push hl
call do_task
pop hl
pop de
pop bc
jr scan_file
.check_eof
oz GN_Cl ; close file
cp Rc_eof
ret z ; CRC-32 completed, return DEBC to caller
scf ; other error occurred - signal Fc = 1, A = RC_xxx
ret |
Code Block |
---|
title | Example for CRC - 32 on File Entry in File Card |
---|
|
include "crc32.def"
include "eprom.def"
ld c,2
ld de,epfilename ; search for filename in filea area of slot 2
ld a, EP_Find
oz OS_Epr
ret c ; file area not there
ret nz ; file entry not found
ld a, CRC_EPFILE
ld de,0 ; Use FFFFFFFFh as initial Crc-32
oz GN_Crc ; get CRC-32 of File Entry returned in DEBC
|