mirror of
https://git.planet-casio.com/Lephenixnoir/gint.git
synced 2024-12-28 20:43:36 +01:00
update README
This commit is contained in:
parent
e5a7d968a6
commit
deeaaa499f
1 changed files with 16 additions and 17 deletions
33
README.md
33
README.md
|
@ -46,7 +46,7 @@ A couple of libraries extend these features, including:
|
||||||
* [OpenLibm](/Lephenixnoir/OpenLibm): A port of the standard math library
|
* [OpenLibm](/Lephenixnoir/OpenLibm): A port of the standard math library
|
||||||
* Integration with [a Newlib port by Memallox](/PlaneteCasio/libc) (unstable)
|
* Integration with [a Newlib port by Memallox](/PlaneteCasio/libc) (unstable)
|
||||||
|
|
||||||
## Basic use with GiteaPC and the fxSDK
|
## Installing with GiteaPC
|
||||||
|
|
||||||
gint can be installed automatically with [GiteaPC](/Lephenixnoir/GiteaPC).
|
gint can be installed automatically with [GiteaPC](/Lephenixnoir/GiteaPC).
|
||||||
|
|
||||||
|
@ -54,21 +54,16 @@ gint can be installed automatically with [GiteaPC](/Lephenixnoir/GiteaPC).
|
||||||
% giteapc install Lephenixnoir/gint
|
% giteapc install Lephenixnoir/gint
|
||||||
```
|
```
|
||||||
|
|
||||||
Normally you don't use it directly, instead the fxSDK provides project
|
Normally you don't use gint directly, instead the fxSDK provides project
|
||||||
templates that are set up to use gint. Please see the
|
templates that are set up to use gint. Please see the
|
||||||
[fxSDK README file](/Lephenixnoir/fxsdk) for details.
|
[fxSDK README file](/Lephenixnoir/fxsdk) for details.
|
||||||
|
|
||||||
## Building and installing manually
|
## Building and installing manually
|
||||||
|
|
||||||
You will need a couple of tools:
|
gint is built using the [fxSDK](/Lephenixnoir/fxsdk), which provides a suitable
|
||||||
|
CMake environment for the calculator. gint is always installed in the
|
||||||
* A suitable GCC toolchain in the `PATH`. You can absolutely *not* build gint
|
compiler's install path (as given by `sh-elf-gcc --print-search-dirs`) which is
|
||||||
with your system compiler!
|
detected automatically, so normally you don't need to set the install prefix.
|
||||||
* The tutorial on Planète Casio builds an `sh-elf` that works everywhere
|
|
||||||
* For fx-9860G II, `sh3eb-elf` is strongly advised
|
|
||||||
* For fx-CG 50, `sh4eb-elf` (with `-m4-nofpu`) is slightly better but
|
|
||||||
`sh3eb-elf` is completely fine
|
|
||||||
* The [fxSDK](/Lephenixnoir/fxsdk) installed and available in the PATH.
|
|
||||||
|
|
||||||
fx-CG 50 developers probably want a g3a wrapper as well; the reference
|
fx-CG 50 developers probably want a g3a wrapper as well; the reference
|
||||||
implementation is Tari's [mkg3a](https://gitlab.com/taricorp/mkg3a). This is
|
implementation is Tari's [mkg3a](https://gitlab.com/taricorp/mkg3a). This is
|
||||||
|
@ -76,11 +71,6 @@ needed at the very last compilation step to create the g3a file. On Arch Linux,
|
||||||
you can use the [AUR/mkg3a](https://aur.archlinux.org/packages/mkg3a) package
|
you can use the [AUR/mkg3a](https://aur.archlinux.org/packages/mkg3a) package
|
||||||
maintained directly by Tari.
|
maintained directly by Tari.
|
||||||
|
|
||||||
gint is built with CMake; the fxSDK provides CMake modules to target the
|
|
||||||
calculator, as well as a couple of utilities. gint is always installed in the
|
|
||||||
compiler's install path (as given by `sh-elf-gcc --print-search-dirs`) which is
|
|
||||||
detected automatically, so normally you don't need to set the install prefix.
|
|
||||||
|
|
||||||
**Building for fx-9860G II**
|
**Building for fx-9860G II**
|
||||||
|
|
||||||
`fxsdk build-fx` will invoke CMake and make. If you have specific configuration
|
`fxsdk build-fx` will invoke CMake and make. If you have specific configuration
|
||||||
|
@ -110,7 +100,16 @@ The available options are:
|
||||||
|
|
||||||
* `-DGINT_USER_VRAM=1`: Store all VRAMs in the user stack (takes up 350k/512k)
|
* `-DGINT_USER_VRAM=1`: Store all VRAMs in the user stack (takes up 350k/512k)
|
||||||
|
|
||||||
## Linking with gint manually
|
## Using in CMake-based add-ins
|
||||||
|
|
||||||
|
Find the `Gint` module and link against `Gint::Gint`.
|
||||||
|
|
||||||
|
```cmake
|
||||||
|
find_module(Gint 2.1 REQUIRED)
|
||||||
|
target_link_libraries(<target_name> Gint::Gint)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Using in Makefile-based add-ins
|
||||||
|
|
||||||
Projects created with the fxSDK link with gint out-of-the-box. If you're not
|
Projects created with the fxSDK link with gint out-of-the-box. If you're not
|
||||||
using the fxSDK, you will need to:
|
using the fxSDK, you will need to:
|
||||||
|
|
Loading…
Reference in a new issue