Repository navigation
cpcxray 0.9.2
Pre-release
Pre-release
Comments and names
- New: comment blocks before and after a line - a routine header above it, a longer explanation
below it, several lines each - besides the comment at the end of the line. Edit them in the
Symbols tab or withsymbol_add/comment_addover MCP; the CPU tab shows them, the Trace
tab marks them (¶) and shows them for the selected instruction, and the generated source
writes them as comment lines (still byte-identical). They are kept in
project/annotations.txtasbefore/afterlines; older files load unchanged. - New: say what an instruction's operand is - right-click it in the CPU tab, or
operand_set
over MCP: a number (always hex,call #0010instead ofcall SIDE_CALL), an address (named),
or judged by cpcxray again. The decision is kept inproject/annotations.txtand holds in
the disassembly, the trace and the generated source. - New: groups for your variables and RAM labels, and code contexts - for programs that use the
same RAM differently (VDOS and CP/M, for example). Put variables and global labels in groups
(Symbols tab: Groups panel, orgroup_add/variable_add(group=)/symbol_add(group=)),
give code a context (CPU tab: right-click a line's address - from/to, this routine, whole
scope; orcontext_set), and every listing, the trace and the generated source name an
address by the context of the code that uses it. One RAM address can have a label per group.
The generated source defines the names in one section per group (still byte-identical). Kept
inproject/annotations.txt(group,context,group=); older files load unchanged. - New:
symbol_add(..., group=, replaces=<old group>)moves a RAM label to another group in one
step, with its type, comment and comment blocks (asvariable_add(replaces=)does for
variables); the Symbols tab's editor uses it. - Changed: the firmware's jumpblock and restart names are fixed - a label of yours on such an
address is refused (a comment is fine); an older annotation file with one loads without it
and the Symbols tab's status says so.
Analysis and source
- New: the data kind
word_data(classify) for words that are numbers - parameters,
offsets, time constants. They are always written in hex: a parameter &0010 no longer turns
intodefw SIDE_CALL(the name of RST 2), as it did in aword_table, whose words are
addresses and keep their names. Existing analysis databases stay valid. - Fixed: the generated source no longer labels the target of a FAR CALL into another ROM in
the analysed ROM (VDOS:rst #18to &C1DC in ROM 7 made asub_c1dcin ROM 5), nor that of
a SIDE CALL to another slot; the far address staysdefw #C1DC ; ROM 7.
The machine
- Fixed: BASIC could hang in
MC WAIT FLYBACK(for example after a disc LOAD). The 300 Hz
interrupt now follows the Gate Array's real line counter (R52): the first interrupt of a frame
comes 2 scan lines into VSYNC, and the phase is resynchronised every frame, also after an RMR
bit 4 write or a snapshot load. The Devices tab shows the frame line next to R52. Emulation
is slightly faster as a side effect.
Downloads
cpcxray-0.9.2-py3-none-any.whl- the Python package, for Python 3.12 or newer:
pipx install "cpcxray[gui,mcp] @ https://github.com/SerErris/cpcxray/releases/download/v0.9.2/cpcxray-0.9.2-py3-none-any.whl"cpcxray-0.9.2-linux-x86_64.tar.gz,cpcxray-0.9.2-windows-x86_64.zip- ready-made
programs, no Python needed: unpack and runcpcxray(cpcxray.exe); the folder is a project
folder already.sjasmpluson the PATH is needed only for the round-trip check of generated sources.
See the install guide.