Libronin: Difference between revisions
(Created page with "libronin is a software development library similar to KallistiOS. It was developed by Marcus Comstedt, Peter Bortas and Per Hedbor. It is used in DreamSNES...") |
|||
| (15 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
libronin is a software development library similar to [[KallistiOS]]. It was developed by [[Marcus Comstedt]], [[Peter Bortas]] and [[Per Hedbor]]. It is used in [[DreamSNES]], [[ScummVM]], and [[Cave Story]]. | libronin is a software development library similar to [[KallistiOS]]. It was developed by [[Marcus Comstedt]], [[Peter Bortas]] and [[Per Hedbor]]. It is used in [[DreamSNES]], [[ScummVM]], and [[Cave Story]]. It is primarily known for its use in projects by Marcus Comstedt and [[histat]]. | ||
==Projects using libronin== | |||
* [[Cave Story]] | |||
* [[DreamSNES]] | |||
* [[Neko Project II]] | |||
* [[ScummVM]] | |||
* [[X Millennium]] | |||
==Release history== | |||
libronin's latest release was in 2016.<ref>''[http://dcevolution.sourceforge.net/index.php?id=libronin], Libronin | DC Evolution - The Dreamcast Resource''</ref> | |||
* Libronin 0.1 (2002-02-03) | |||
* Libronin 0.2 (2002-02-27) | |||
* Libronin 0.3 (2002-04-21) | |||
* Libronin 0.4 (2003-05-04) | |||
* Libronin 0.5 (2008-01-01) | |||
* Libronin 0.6 (2016-09-26) | |||
==Building a toolchain for libronin== | |||
The standard [[KallistiOS]] sh-elf toolchain contains patches that prevent it from working with libronin; however, KallistiOS's <code>dc-chain</code> script can be used to easily build a libronin-compatible raw toolchain. You can build this toolchain to a separate directory than an existing KallistiOS toolchain. | |||
Create a directory to hold the toolchain and give yourself ownership: | |||
sudo mkdir -p /opt/toolchains/dc/roninchain | |||
sudo chown -R $USER:$USER /opt/toolchains/dc/roninchain | |||
Clone the KallistiOS repo somewhere convenient: | |||
git clone https://github.com/KallistiOS/KallistiOS.git kos | |||
Enter the toolchain directory: | |||
cd kos/util/dc-chain | |||
Alter the <code>Makefile.cfg</code> options in a text editor if you'd like. | |||
And finally, download and build the toolchain for libronin use with the following command: | |||
make all enable_objc=0 enable_objcpp=0 thread_model=single use_kos_patches=0 auto_fixup_sh4_newlib=0 sh_toolchain_path=/opt/toolchains/dc/roninchain/sh-elf arm_toolchain_path=/opt/toolchains/dc/roninchain/arm-eabi | |||
You can now use the compilers stored at <code>/opt/toolchains/dc/roninchain/sh-elf/bin</code> and <code>/opt/toolchains/dc/roninchain/arm-eabi/bin</code> to compile libronin. You may need to modify <code>Makefile</code> and <code>zlib/Makefile</code> included with libronin to include the path to the compilers. | |||
You may delete the <code>kos</code> folder that you cloned using git earlier once your toolchain is successfully installed. | |||
==Source== | ==Source== | ||
*[https://bitbucket.org/ihi/libronin/src libronin source code repository on Bitbucket] | *[https://bitbucket.org/ihi/libronin/src libronin source code repository on Bitbucket] | ||
==References== | |||
<references/> | |||
{{DISPLAYTITLE:libronin}} | {{DISPLAYTITLE:libronin}} | ||
Latest revision as of 21:22, 7 May 2024
libronin is a software development library similar to KallistiOS. It was developed by Marcus Comstedt, Peter Bortas and Per Hedbor. It is used in DreamSNES, ScummVM, and Cave Story. It is primarily known for its use in projects by Marcus Comstedt and histat.
Projects using libronin
Release history
libronin's latest release was in 2016.[1]
- Libronin 0.1 (2002-02-03)
- Libronin 0.2 (2002-02-27)
- Libronin 0.3 (2002-04-21)
- Libronin 0.4 (2003-05-04)
- Libronin 0.5 (2008-01-01)
- Libronin 0.6 (2016-09-26)
Building a toolchain for libronin
The standard KallistiOS sh-elf toolchain contains patches that prevent it from working with libronin; however, KallistiOS's dc-chain script can be used to easily build a libronin-compatible raw toolchain. You can build this toolchain to a separate directory than an existing KallistiOS toolchain.
Create a directory to hold the toolchain and give yourself ownership:
sudo mkdir -p /opt/toolchains/dc/roninchain sudo chown -R $USER:$USER /opt/toolchains/dc/roninchain
Clone the KallistiOS repo somewhere convenient:
git clone https://github.com/KallistiOS/KallistiOS.git kos
Enter the toolchain directory:
cd kos/util/dc-chain
Alter the Makefile.cfg options in a text editor if you'd like.
And finally, download and build the toolchain for libronin use with the following command:
make all enable_objc=0 enable_objcpp=0 thread_model=single use_kos_patches=0 auto_fixup_sh4_newlib=0 sh_toolchain_path=/opt/toolchains/dc/roninchain/sh-elf arm_toolchain_path=/opt/toolchains/dc/roninchain/arm-eabi
You can now use the compilers stored at /opt/toolchains/dc/roninchain/sh-elf/bin and /opt/toolchains/dc/roninchain/arm-eabi/bin to compile libronin. You may need to modify Makefile and zlib/Makefile included with libronin to include the path to the compilers.
You may delete the kos folder that you cloned using git earlier once your toolchain is successfully installed.