cd7fe7a329
This version of signal (which does not rely on a notion of userland processes and is thus excluded from Vhex) follows C99 semantics but does not generate any signals by default. Basically, the signal function sets up function pointers and the signal function calls them. Termination signals call exit() while other signals call _Exit(), which is a quicker program termination similar to abort(). C99 allows programs to long jump out of signal handlers (!) which is unbelievably scary because it would bypass stack switching code in Vhex as well as normal interrupt handler termination in gint. |
||
|---|---|---|
| cmake | ||
| include | ||
| src | ||
| .gitignore | ||
| CMakeLists.txt | ||
| giteapc.make | ||
| LICENSE | ||
| README.md | ||
| STATUS | ||
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 !