Updated readme
renamed linux setup script
This commit is contained in:
Robin Jones
parent
63872f6e61
commit
42b5d9e09e
160
README.md
160
README.md
@ -1,36 +1,19 @@
|
|||||||
# alt64
|
# Altra64
|
||||||
|
|
||||||
Alternative Everdrive64 menu
|
Alternative Everdrive64 menu
|
||||||
|
|
||||||
Kuroneko!
|
|
||||||
|
|
||||||
:\ /; _
|
`Altra64` is an open source menu for [Everdrive64](http://krikzz.com/) and is based on a fork of alt64 which was
|
||||||
; \___/ ; ; ;
|
|
||||||
,:-"' `"-:. / ;
|
|
||||||
_ /,---. ,---.\ _ _; /
|
|
||||||
_:>(( | ) ( | ))<:_ ,-""_,"
|
|
||||||
\````` `````/""""",-""
|
|
||||||
'-.._ v _..-' )
|
|
||||||
/ ___ ____,.. \
|
|
||||||
/ / | | | ( \. \
|
|
||||||
ctr / / | | | | \ \
|
|
||||||
`" `" `" `"
|
|
||||||
|
|
||||||
nyannyannyannyannyannyannyannyannyannyannyannyannyannyannyannyannyan
|
|
||||||
|
|
||||||
|
|
||||||
`alt64` is an open source menu for [Everdrive64](http://krikzz.com/). It was
|
|
||||||
originally written by saturnu, and released on the
|
originally written by saturnu, and released on the
|
||||||
[Everdrive64 forum](http://krikzz.com/forum/index.php?topic=816.0).
|
[Everdrive64 forum](http://krikzz.com/forum/index.php?topic=816.0).
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
|
||||||
If you want to build the menu, you need an n64 toolchain. We'll use the
|
If you want to build the menu, you need an n64 toolchain. When using windows 10, installation is totally automated through a script.
|
||||||
toolchain recommended by libdragon, with some updated versions.
|
|
||||||
|
|
||||||
### Dependencies
|
### Dependencies (installed automatically)
|
||||||
|
* Windows 10 (Aniversary Update or above) / Ubuntu 16.04 (or above)
|
||||||
* [libdragon](https://github.com/parasyte/libdragon)
|
* [libdragon](https://github.com/DragonMinded/libdragon)
|
||||||
* [libmikmod-n64](https://github.com/parasyte/libmikmod-n64)
|
* [libmikmod-n64](https://github.com/parasyte/libmikmod-n64)
|
||||||
* [libmad-n64](https://github.com/parasyte/libmad-n64)
|
* [libmad-n64](https://github.com/parasyte/libmad-n64)
|
||||||
* [libyaml](http://pyyaml.org/wiki/LibYAML)
|
* [libyaml](http://pyyaml.org/wiki/LibYAML)
|
||||||
@ -39,101 +22,50 @@ toolchain recommended by libdragon, with some updated versions.
|
|||||||
|
|
||||||
*You may skip this step if it's already installed.*
|
*You may skip this step if it's already installed.*
|
||||||
|
|
||||||
Clone the `libdragon` repo and create a directory for the build.
|
Clone this `Altra64` repo to a directory of your choice.
|
||||||
|
|
||||||
```bash
|
On Windows 10, browse to the tools directory and double click on setup-wsfl.cmd
|
||||||
$ git clone https://github.com/parasyte/libdragon.git
|
On Ubuntu, browse to the tools directory and run the command ```chmod +x ./setup-linux.sh;source ./setup-linux.sh```
|
||||||
$ mkdir libdragon/build_gcc
|
|
||||||
$ cp libdragon/tools/build libdragon/build_gcc
|
|
||||||
$ cd libdragon/build_gcc
|
### Build `Altra64`
|
||||||
|
|
||||||
|
To build the Rom
|
||||||
|
|
||||||
|
from the projects root directory,
|
||||||
|
On Windows 10 run
|
||||||
```
|
```
|
||||||
|
> build
|
||||||
Modify the `build` script to set your installation path. Here is the default:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# EDIT THIS LINE TO CHANGE YOUR INSTALL PATH!
|
|
||||||
export INSTALL_PATH=/usr/local/mips64-elf
|
|
||||||
```
|
```
|
||||||
|
on linux
|
||||||
Build it! This can take an hour or more.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ ./build
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Configure your Environment
|
|
||||||
|
|
||||||
Add the following environment variable to your `~/.bash_profile` or `~/.bashrc`
|
|
||||||
Be sure to use the same path that you configured in the build script!
|
|
||||||
|
|
||||||
```bash
|
|
||||||
export N64_INST=/usr/local/mips64-elf
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build `libdragon`
|
|
||||||
|
|
||||||
Make sure you are in the `libdragon` top-level directory, and make sure `libpng`
|
|
||||||
is installed:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ make && make install
|
|
||||||
$ make tools && make tools-install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build `libmikmod`
|
|
||||||
|
|
||||||
Clone `libmikmod-n64` and build:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ git clone https://github.com/parasyte/libmikmod-n64.git
|
|
||||||
$ cd libmikmod-n64
|
|
||||||
$ make
|
|
||||||
$ make install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build `libmad-n64`
|
|
||||||
|
|
||||||
Clone `libmad-n64` and build, be sure to set the path according to your
|
|
||||||
toolchain installation path:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ git clone https://github.com/parasyte/libmad-n64.git
|
|
||||||
$ cd libmad-n64
|
|
||||||
$ export PATH=$PATH:$(N64_INST)/bin
|
|
||||||
$ CFLAGS="-march=vr4300 -mtune=vr4300 -mno-extern-sdata" \
|
|
||||||
LDFLAGS="-L$(N64_INST)/lib" LIBS="-lc -lnosys" \
|
|
||||||
./configure --host=mips64-elf --disable-shared \
|
|
||||||
--prefix=$(N64_INST) --enable-speed --enable-fpm=mips
|
|
||||||
$ make
|
|
||||||
$ make install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build `libyaml`
|
|
||||||
|
|
||||||
Download libyaml 0.1.6 and build, be sure to set the path according to your
|
|
||||||
toolchain installation path:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ hg clone https://bitbucket.org/xi/libyaml
|
|
||||||
$ cd libyaml
|
|
||||||
$ hg update 0.1.6
|
|
||||||
$ ./bootstrap
|
|
||||||
$ export PATH=$PATH:$(N64_INST)/bin
|
|
||||||
$ CFLAGS="-std=gnu99 -march=vr4300 -mtune=vr4300" \
|
|
||||||
LDFLAGS="-L$(N64_INST)/lib -Tn64ld.x" \
|
|
||||||
LIBS="-ldragon -lc -ldragonsys -lnosys" \
|
|
||||||
./configure --host=mips64-elf --prefix=$(N64_INST)
|
|
||||||
$ make
|
|
||||||
$ make install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Build `alt64`
|
|
||||||
|
|
||||||
Finally, we can clone `alt64` and build it!
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ git clone https://github.com/parasyte/alt64.git
|
|
||||||
$ make
|
$ make
|
||||||
```
|
```
|
||||||
|
|
||||||
If it all worked, you will find `OS64.v64` in the `alt64` bin directory.
|
### Debug Build `Altra64`
|
||||||
|
To build the debug version of the Rom
|
||||||
|
|
||||||
|
from the projects root directory,
|
||||||
|
On Windows 10 run
|
||||||
|
```
|
||||||
|
> build debug
|
||||||
|
```
|
||||||
|
on linux
|
||||||
|
```
|
||||||
|
$ make debug
|
||||||
|
```
|
||||||
|
|
||||||
|
### Clean `Altra64`
|
||||||
|
Finally, we can clean the build objects from the project
|
||||||
|
|
||||||
|
from the projects root directory,
|
||||||
|
On Windows 10 run
|
||||||
|
```
|
||||||
|
> build clean
|
||||||
|
```
|
||||||
|
on linux
|
||||||
|
```
|
||||||
|
$ make clean
|
||||||
|
```
|
||||||
|
|
||||||
|
If it all worked, you will find `OS64.v64` in the `Altra64` bin directory.
|
||||||
|
|||||||
@ -48,8 +48,8 @@ if '%1'=='ELEV' (del "%vbsGetPrivileges%" 1>nul 2>nul & shift /1)
|
|||||||
|
|
||||||
lxrun /install /y
|
lxrun /install /y
|
||||||
bash -c "echo 'export N64_INST=/usr/local/libdragon' >> ~/.bashrc; source ~/.bashrc"
|
bash -c "echo 'export N64_INST=/usr/local/libdragon' >> ~/.bashrc; source ~/.bashrc"
|
||||||
bash -c "chmod +x ./setup-wsfl.sh"
|
bash -c "chmod +x ./setup-linux.sh"
|
||||||
bash --verbose -c "source ./setup-wsfl.sh"
|
bash --verbose -c "source ./setup-linux.sh"
|
||||||
|
|
||||||
::bash
|
::bash
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user