electrified / z88dk-libraries Goto Github PK

This file describes some some z88dk compatible libraries.

The implementation of time.h aspires to conform with ISO/IEC 9899 (C90). However, due to limitations of the target processor and the nature of its development environment, a practical implementation must of necessity deviate from the standard.

FatFs is a generic FAT/exFAT filesystem module for small embedded systems. The FatFs module is written in compliance with ANSI C (C89) and completely separated from the disk I/O layer. Therefore it is independent of the platform. It can be incorporated into small microcontrollers with limited resource, such as 8051, PIC, AVR, ARM, Z80, RX and etc.

TBC

The libraries can be compiled using the following command lines in Linux, with the +target modified to be relevant to your machine, from the relevant library sub-directory. e.g. for any library.

cd ~/library
zcc +target -lm -x -SO3 --opt-code-size -clib=sdcc_ix --max-allocs-per-node200000 @library.lst -o library
mv library.lib target/lib/newlib/sdcc_ix
zcc +target -lm -x -SO3 --opt-code-size -clib=sdcc_iy --max-allocs-per-node200000 @library.lst -o library
mv library.lib target/lib/newlib/sdcc_iy

The resulting library.lib file should be moved to ~/library/target/lib/newlib/sdcc_ix or ~/library/target/lib/newlib/sdcc_iy respectively, as noted above.

Then, the z88dk-lib function is used to install for the desired target. e.g. for the time library on the yaz180 machine.

cd ..
z88dk-lib +yaz180 time

Some further examples of z88dk-lib usage.

• libraries list help

z88dk-lib

• list 3rd party libraries already installed for the zx target

z88dk-lib +zx

• remove the libname1 libname2 ... libraries from the zx target, -f for no nagging about deleting files.

z88dk-lib +zx -r -f libname1 libname2 ...

Once installed, the libraries can be linked against on the compile line by adding -llib/target/library and the include file can be found with #include <lib/target/library.h>.