3 unstable releases

0.7.0	Nov 17, 2024
0.3.1	Jul 13, 2024
0.3.0	Jul 11, 2024

#4 in #tool-manipulate

151 downloads per month

MIT license

365KB
1K SLoC

cpclib

Success stories

Several demos have been released using this toolchain. However they may not build with the very last version due to its evolution.

It is also able to build the (potentially closed, with minimal modifications) sources of

Aim

cpclib is a library that aims at helping to develop Amstrad CPC demos. Maybe it could be usefull for other z80 platform or even games. None of the functionalities are 100% functional. I have only implemented the subset I need for my current Amstrad CPC demo project. Several tools are provided in addition to library.

There are more are less able to do:

assemble z80 source code.
- Mainly interesting for auto-generated code, not for handcrafted one.
- Not all opcodes are managed.
- Functionalities not available in other assemblers:
  - Injection of basic source code (WIP)
  - Function able to provided the opcode value of an instruction or its standard duration
manipulate .sna files
- Minimal support of chunks at the moment
convert images to CPC format. Usable for standard resolutions/modes
manipulate DSK (trying to mimick iDSK or dskmanager). Able to format and add files
communicate with cpcwifi board
- Replication of xfer utility.
- Only reset and run file have been coded at the moment
- In opposite to the original xfer tool, cpclib one is able to start snapshots V3 (there are simply converted as snapshot v2 on the fly)
create basic tokens from basic source (WIP)

Documentation is available at https://cpcsdk.github.io/rust.cpclib/

WARNING the windows toolchain has to be nightly-x86_64-pc-windows-gnu

Dependencies

~6–17MB
~178K SLoC