mirror of
https://git.planet-casio.com/Vhex-Kernel-Core/fxlibc.git
synced 2024-12-29 13:03:38 +01:00
115 lines
3.4 KiB
Markdown
115 lines
3.4 KiB
Markdown
# The FX C Library
|
|
|
|
This directory contains the sources of the FxLibc Library. See `CMakeLists.txt`
|
|
to see what release version you have.
|
|
|
|
The FxLibc is the standard system C library implementation for all Casio
|
|
fx calculators, and is an important part of what makes up programs on these
|
|
devices. It provides the system API for all programs written in C and
|
|
C-compatible languages such as C++ and Objective-C; the runtime facilities of
|
|
other programming languages use the C library to access the underlying operating
|
|
system.
|
|
|
|
---
|
|
|
|
## Dependencies
|
|
FxLibc requires a GCC compiler toolchain the PATH to build for any calculator.
|
|
You cannot build with your system compiler! The tutorial on Planète Casio
|
|
builds an `sh-elf` toolchain that supports all models using multilib.
|
|
|
|
For Vhex and gint targets, the headers of the kernel are also required.
|
|
|
|
---
|
|
|
|
## Building and installing FxLibc
|
|
FxLibc supports several targets:
|
|
* Vhex on SH targets (`vhex-sh`)
|
|
* CASIOWIN for fx-9860G-like calculators (`casiowin-fx`)
|
|
* CASIOWIN for fx-CG-series calculators (`casiowin-cg`)
|
|
* gint for all targets (`gint`)
|
|
|
|
Each target supports different features depending on what the kernel/OS
|
|
provides.
|
|
|
|
#### Configuration and support
|
|
|
|
Configure with CMake; specify the target with `-DFXLIBC_TARGET`. For SH
|
|
platforms, set the toolchain to `cmake/toolchain-sh.cmake`.
|
|
|
|
The FxLibc supports shared libraries when building with Vhex (TODO); set
|
|
`-DSHARED=1` to enable this behavior.
|
|
|
|
You can either install FxLibc in the compiler's `include` folder, or installl
|
|
in another location of your choice. In the second case, you will need a `-I`
|
|
option when using the library.
|
|
|
|
To use the compiler, set `PREFIX` like this:
|
|
|
|
```
|
|
% PREFIX=$(sh-elf-gcc -print-file-name=.)
|
|
```
|
|
|
|
To use another location, set `PREFIX` manually (recommended):
|
|
|
|
```
|
|
% PREFIX="$HOME/.sh-prefix/"
|
|
```
|
|
|
|
Example for a static Vhex build:
|
|
|
|
```
|
|
% cmake -B build-vhex-sh -DFXLIBC_TARGET=vhex-sh -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-sh.cmake -DCMAKE_INSTALL_PREFIX="$PREFIX"
|
|
```
|
|
|
|
#### Building
|
|
Build in the directory specified in `cmake -B`.
|
|
|
|
```
|
|
% make -C build
|
|
```
|
|
|
|
To install, run the `install` target.
|
|
|
|
```
|
|
% make -C build install
|
|
```
|
|
|
|
---
|
|
|
|
### Contributing
|
|
Bug reports, feature suggestions and especially code contributions are most
|
|
welcome.
|
|
|
|
If you are interested in doing a port, or want to contribute to this project,
|
|
please, try to respect these constraints:
|
|
* Document your code.
|
|
* One function per file (named like the function).
|
|
* Use the same formatting conventions as the rest of the code.
|
|
* Only use hardware-related code (DMA, SPU, etc) in target-specified files
|
|
when the target explicitly supports it.
|
|
|
|
---
|
|
|
|
### Using FxLibc
|
|
|
|
Include headers normally (`#include <stdio.h>`); on SH platforms where
|
|
`sh-elf-gcc` is used, link with `-lc` (by default the `-nostdlib` flag is
|
|
used for a number of reasons).
|
|
|
|
If you're installing in a custom folder, you also need `-I "$PREFIX/include"`
|
|
and `-L "$PREFIX/lib"`. If you're installing in the GCC install folder, you
|
|
don't need `-I` but you still need the `-L` as the default location for
|
|
libraries is at the root instead of in a `lib` subfolder.
|
|
|
|
---
|
|
|
|
### Licences
|
|
This work is licensed under a CC0 1.0 Universal License. To view a copy of this
|
|
license, visit: https://creativecommons.org/publicdomain/zero/1.0/legalcode.txt
|
|
Or see the LICENSE file.
|
|
|
|
---
|
|
|
|
### Special thanks to
|
|
* Lephenixnoir - For all <3
|
|
* Kristaba - For the idea with the shared libraries workaround !
|