mirror of
https://github.com/UpsilonNumworks/Upsilon.git
synced 2026-01-18 16:27:34 +01:00
Update building docs and french readme (#136)
This commit is contained in:
LeMoustachu
GitHub
288
README.fr.md
288
README.fr.md
@@ -32,67 +32,268 @@ Ne débranchez votre calculatrice qu'une fois l'installation terminée.
|
||||
|
||||
### Manuelle
|
||||
|
||||
Tout d'abord, suivez **la première étape** [ici](https://www.numworks.com/resources/engineering/software/build/), puis :
|
||||
*Vous pouvez vous référer à ce [site internet](https://www.numworks.com/resources/engineering/software/build/)pour la première étape si vous avez des erreurs*
|
||||
|
||||
|
||||
|
||||
### 1. Installation du SDK
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
<summary><b>Modèle n0100</b></summary>
|
||||
|
||||
(note : vous pouvez changer `EPSILON_I18N=fr` en `en`, `nl`, `pt`, `it`, `de`, `es` ou `hu`).
|
||||
<summary><b>1.1 Linux</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Debian ou Ubuntu</summary>
|
||||
|
||||
<br>
|
||||
|
||||
Il suffit juste d'installer les dépendances en tapant ces commandes dans un Terminal en mode super-utilisateur.
|
||||
|
||||
```bash
|
||||
apt-get install build-essential git imagemagick libx11-dev libxext-dev libfreetype6-dev libpng-dev libjpeg-dev pkg-config gcc-arm-none-eabi binutils-arm-none-eabi
|
||||
```
|
||||
|
||||
C'est fait! Vous pouvez aller à l'étape 2.
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Fedora</summary>
|
||||
|
||||
<br>
|
||||
|
||||
Installez tout d'abord des outils de développement.
|
||||
|
||||
```bash
|
||||
dnf install make automake gcc gcc-c++ kernel-devel
|
||||
```
|
||||
|
||||
Puis les pquets requis:
|
||||
|
||||
```bash
|
||||
dnf install git ImageMagick libX11-devel libXext-devel freetype-devel libpng-devel libjpeg-devel pkg-config
|
||||
```
|
||||
|
||||
Et enfin la version pour ARM de GCC:
|
||||
|
||||
```bash
|
||||
dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.2 Mac</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
Il est recommandé d'utiliser [Homebrew](https://brew.sh/). Une fois intsallé, utilisez:
|
||||
```bash
|
||||
brew install numworks/tap/epsilon-sdk
|
||||
```
|
||||
Et toutes les dependances seront installées.
|
||||
|
||||
<br>
|
||||
|
||||
Vous pouvez aller à l'étape 2.
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.3 Windows</b></summary>
|
||||
|
||||
[Git](http://git-scm.com) doit être installé.
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Avec Msys2/Mingw (Supportés par Numwoks bien qu'il y ait beaucoup de bugs)</summary>
|
||||
|
||||
L'environnement de compilation [Msys2](https://www.msys2.org/) est recommandé par Numworks pour obtenir la plupart des outils requis facilement. C'est ici que vous allez copier-colletoutes lecommandes de ce tutoriel. Une fois installé, copier-coller ces deux commandes dans le terminal:
|
||||
|
||||
```bash
|
||||
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-freetype mingw-w64-x86_64-pkg-config mingw-w64-x86_64-libusb git make python
|
||||
echo "export PATH=/mingw64/bin:$PATH" >> .bashrc
|
||||
```
|
||||
|
||||
Ensuite, vous devrez installer [GCC toolchain for ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). Quand il vouest demandde choisir u dossier d'installation, choisissez `C:\msys64\home\User\gcc-arm\`. Il vous faudra ensuite ajouter ce dossier à votre $PATH. Tapez juste:
|
||||
|
||||
```bash
|
||||
echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc
|
||||
```
|
||||
Redémarrez votre terminal et vous pouvez aller à l'étape 2!
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Avec WSL 2</summary>
|
||||
|
||||
WSL est un système qui virtualise un environnement GNU/Linux dans Windows.
|
||||
|
||||
Votre version de windows doit être >= 1903.
|
||||
|
||||
#### Installation de WSL
|
||||
|
||||
1. Apuyez simulatanément sur les touches "windows" et "x" puis cliquez sur "Powershell administrateur". Entrez ensuite ceci dans la nouvelle fenêtre:
|
||||
```powershell
|
||||
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart
|
||||
```
|
||||
Cette commande active WSL
|
||||
|
||||
```powershell
|
||||
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
|
||||
```
|
||||
Cette commande permet d'autoriser le démarrage des machines signées par Microsoft.
|
||||
|
||||
2. Redémarrez votre ordinateur.
|
||||
|
||||
3. Téléchargez ce fichier [this file](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) et suivez les instructions d'installation.
|
||||
|
||||
4. Ouvrez votre fenêtre powershell comme avant et tapez:
|
||||
```powershell
|
||||
wsl --set-default-version 2
|
||||
```
|
||||
5. téléchargez [Ubuntu](https://www.microsoft.com/store/apps/9n6svws3rx71) depuis le Microsoft store. Vous pouvez aussi installer [Debian](https://www.microsoft.com/store/productI9MSVKQC78PK6).
|
||||
|
||||
WSL est maintenant installé.
|
||||
|
||||
### Installation d'usbipd pour connecter la calculatrice à WSL (facultatif)
|
||||
Pour connecter la calculatrice, il faut installer cet [outil](https://github.com/dorssel/usbipd-win/releases/download/v1.3.0/usbipd-win_1.3.0.msi). Il permet de connecter deperiphériques USpar internet.Suivez les instructions pour installer.
|
||||
|
||||
#### Ubuntu
|
||||
1. Dans un terminal WSL Ubuntu, tapez:
|
||||
```bash
|
||||
sudo apt install linux-tools-5.4.0-77-generic hwdata
|
||||
```
|
||||
2. Editez /etc/sudoers pour que l'on puisse utiliser la commande usbip. Sur Ubutu, cele est fait de cette manière:
|
||||
```bash
|
||||
sudo visudo
|
||||
```
|
||||
3. Ajoutez `/usr/lib/linux-tools/5.4.0-77-generic` au début du secure_path. Après édition, la ligne devrait ressembler à:
|
||||
`Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."`
|
||||
|
||||
#### Debian
|
||||
1.Si vous utiliser Debian, utilisez cette commande:
|
||||
```bash
|
||||
sudo apt install usbip hwdata usbutils
|
||||
```
|
||||
|
||||
### Pour connecter la calculatrice à WSL
|
||||
1. Ouvrez encore un powershell en mode administrateur et tapez:
|
||||
```powershell
|
||||
usbipd wsl list
|
||||
```
|
||||
Ceci va lister les périphériques USB connectés à l'ordinateur. Reagrdez le BUSID de votre "Numworks Calculator".
|
||||
|
||||
2. Maintenant, lancez cette commande en remplçant <BUSID> par celui de votre caculatrice:
|
||||
```powershell
|
||||
usbipd wsl attach --busid <BUSID>
|
||||
```
|
||||
|
||||
Le mot de passe de votre machine WSL vous sera demandé.
|
||||
|
||||
Vous pouvez aller à l'étape 2.
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
### 2. Récupérer le code source
|
||||
|
||||
|
||||
Le code source est disponible dans une repository git. Récupérez-le de cette manière:
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout omega-master
|
||||
git checkout upsilon-dev
|
||||
```
|
||||
<br>
|
||||
|
||||
|
||||
### 3. Choisissez le système à compiler
|
||||
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>Model n0100</b></summary>
|
||||
|
||||
(note: vous pouvez changer l'argument `EPSILON_I18N=en` avec `fr`, `nl`, `pt`, `it`, `de`, `es` or `hu`).
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 clean
|
||||
make MODEL=n0100 EPSILON_I18N=fr OMEGA_USERNAME="{Votre nom ici, 15 caractères max}" -j4
|
||||
make MODEL=n0100 EPSILON_I18N=en OMEGA_USERNAME="{Votre nom, maximum 15 caractères}" -j4
|
||||
```
|
||||
|
||||
Maintenant, lancez soit:
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 epsilon_flash
|
||||
```
|
||||
pour directement flasher la calculatrice après avoir appuyé simultanément sur `reset` et `6` et avoir branché la calculatrice à l'ordinateur.
|
||||
|
||||
Important : N'oubliez pas l'argument `--recursive`, Upsilon a besoin de sous-modules.
|
||||
Vous pouvez aussi changer le nombre de processus parallèles pendant la compilation en changeant la valeur suivant `-j`.
|
||||
<br>
|
||||
|
||||
soit:
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 OMEGA_USERNAME="" binpack -j4
|
||||
```
|
||||
pour compiler les binpacks que vous pouvez distribuer et flasher depuis le [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0100/).
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Modèle n0110</b></summary>
|
||||
|
||||
<summary><b>Model n0110</b></summary>
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout omega-master
|
||||
make clean
|
||||
make OMEGA_USERNAME="{Votre nom ici, 15 caractères max}" -j4
|
||||
make OMEGA_USERNAME="{Votre nom, maximum 15 caractères}" -j4
|
||||
``
|
||||
|
||||
Maintenant, lancez soit:
|
||||
|
||||
```bash
|
||||
make epsilon_flash
|
||||
```
|
||||
pour directement flasher la calculatrice après avoir appuyé simultanément sur `reset` et `6` et avoir branché la calculatrice à l'ordinateur.
|
||||
|
||||
Important : N'oubliez pas l'argument `--recursive`, Upsilon a besoin de sous-modules.
|
||||
Vous pouvez aussi changer le nombre de processus parallèles pendant la compilation en changeant la valeur suivant `-j`.
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Fichiers binaires</b></summary>
|
||||
|
||||
Ces fichiers peuvent être utilisés pour distribuer Upsilon (pour que tout le monde puisse le flasher via [Webdfu_Numworks](https://ti-planet.github.io/webdfu_numworks/)).
|
||||
soit:
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout omega-master
|
||||
make clean
|
||||
make MODEL=n0100 OMEGA_USERNAME="" -j8
|
||||
make MODEL=n0100 OMEGA_USERNAME="" binpack -j8
|
||||
make OMEGA_USERNAME="" -j8
|
||||
make OMEGA_USERNAME="" binpack -j8
|
||||
make OMEGA_USERNAME="" binpack -j4
|
||||
```
|
||||
|
||||
Important : N'oubliez pas l'argument `--recursive`, Upsilon a besoin de sous-modules.
|
||||
Vous pouvez aussi changer le nombre de processus parallèles pendant la compilation en changeant la valeur suivant `-j`.
|
||||
pour compiler les binpacks que vous pouvez distribuer et flasher depuis le [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0100/).
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Simulateur web</b></summary>
|
||||
|
||||
<summary><b>Simulateur web</b></summary>
|
||||
|
||||
D'abord, installez emsdk :
|
||||
|
||||
@@ -107,24 +308,20 @@ source emsdk_env.sh
|
||||
Puis, compilez Upsilon :
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout omega-master
|
||||
make clean
|
||||
make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Votre nom ici, 15 caractères max}" -j4
|
||||
make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Votre nom, maximum 15 caractères}" -j4
|
||||
```
|
||||
|
||||
Le simulateur se trouve dans `output/release/simulator/web/simulator.zip`
|
||||
|
||||
Important : N'oubliez pas l'argument `--recursive`, Upsilon a besoin de sous-modules.
|
||||
Vous pouvez aussi changer le nombre de processus parallèles pendant la compilation en changeant la valeur suivant `-j`.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Simulateur 3DS</b></summary>
|
||||
|
||||
Vous aurez besoin de devkitPro et de devkitARM disponible dans votre `$PATH` (instructions [ici](https://devkitpro.org/wiki/Getting_Started) (en anglais))
|
||||
<summary><b>Simulateur pour 3DS</b></summary>
|
||||
|
||||
Il vous faut devkitPro et devkitARM installés et dans votre path (les instructions sont [ici](https://devkitpro.org/wiki/Getting_Started))
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
@@ -132,15 +329,20 @@ cd Upsilon
|
||||
git checkout --recursive upsilon-dev
|
||||
make PLATFORM=simulator TARGET=3ds -j
|
||||
```
|
||||
|
||||
Vous pouvez ensuite copier epsilon.3dsx sur une carte SD pour l'exécuter depuis le HBC ou utiliser 3dslink pour le lancer via le réseau :
|
||||
Vous pouvez ensuite mettre epsilon.3dsx sur une carte SDpour le lancer depuis le HBC ou utilisez 3dslink pour le lancer via le réseau:
|
||||
|
||||
```bash
|
||||
3dslink output/release/simulator/3ds/epsilon.3dsx -a <ADRESSE IP 3DS>
|
||||
3dslink output/release/simulator/3ds/epsilon.3dsx -a <3DS' IP ADDRESS>
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
Important: n'oubliez pas l'argument `--recursive` Parce qu'Upsilon dépend de submodules.
|
||||
Aussi, vous pouvez changer le nombre de processus de compilation en parallèles en changeant le nombre après l'argument `-j`.
|
||||
N'oubliez pas de mettre votre nom à la place `{Votre nom, maximum 15 caractères}`.Si vous n'en voulez pas, enlevez l'argument `OMEGA_USERNAME`.
|
||||
|
||||
Si vous avez besoin d'aide, n'hésitez pas à rejoindre notre serveur discord : https://discord.gg/Q9buEMduXG
|
||||
|
||||
<a href="https://discord.gg/Q9buEMduXG"><p align="center"><img alt="Omega Banner Discord" src="https://user-images.githubusercontent.com/12123721/86287349-54ef5800-bbe8-11ea-80c1-34eb1f93eebd.png" /></p></a>
|
||||
|
||||
50
README.md
50
README.md
@@ -46,12 +46,13 @@ Do not disconnect your calculator until the installation is complete.
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.1 Linux</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Debian or Ubuntu</summary>
|
||||
|
||||
<br>
|
||||
@@ -69,26 +70,27 @@ And there you can go to step 2!
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Fedora</summary>
|
||||
|
||||
<br>
|
||||
|
||||
First install basics dev tools.
|
||||
To install basics dev tools:
|
||||
|
||||
```bash
|
||||
dnf install make automake gcc gcc-c++ kernel-devel
|
||||
```
|
||||
|
||||
Then install required packages.
|
||||
And then install required packages.
|
||||
|
||||
```bash
|
||||
dnf install git ImageMagick libX11-devel libXext-devel freetype-devel libpng-devel libjpeg-devel pkg-config
|
||||
install git ImageMagick libX11-devel libXext-devel freetype-devel libpng-devel libjpeg-devel pkg-config
|
||||
```
|
||||
|
||||
Then, install GCC cross compiler for ARM.
|
||||
|
||||
```bash
|
||||
dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
|
||||
dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
|
||||
```
|
||||
|
||||
<br>
|
||||
@@ -100,14 +102,17 @@ dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.2 Mac</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
It's recommended to use [Homebrew](https://brew.sh/). Once it's installed, just run:
|
||||
|
||||
```bash
|
||||
brew install numworks/tap/epsilon-sdk
|
||||
```
|
||||
|
||||
and it will install all dependencies.
|
||||
|
||||
<br>
|
||||
@@ -116,24 +121,26 @@ And there you can go to step 2!
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.3 Windows</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>With Msys2/Mingw (officialized by numworks but with a lot of bugs)</summary>
|
||||
[Msys2](https://www.msys2.org/) environment is recommended by Numworks to get most of the required tools on Windows easily. It's where you'll paste all the commands of this tutorial. Once it's installed, paste these commands into the Msys2 terminal.
|
||||
|
||||
[Msys2](https://www.msys2.org/) environment is recommended by Numworks to get most of the required tools on Windows easily. It's where you'll paste all the commands of this tutorial. Once it'sinstalled, paste these commands into the Msys2 terminal.
|
||||
|
||||
```bash
|
||||
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-freetype mingw-w64-x86_64-pkg-config mingw-w64-x86_64-libusb git make python
|
||||
echo "export PATH=/mingw64/bin:$PATH" >> .bashrc
|
||||
```
|
||||
|
||||
Next, you'll need to install the [GCC toolchain for ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). When prompted for an install location, choose `C:\msys64\home\User\gcc-arm\`. You'll then need to add this folder to your $PATH. Just enter:
|
||||
Next, you'll need to install the [GCC toolchain for ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). When prompted for aninstall location, choose `C:\msys64\home\User\gcc-arm\`. You'll then need to add this folder to your $PATH. Just enter:
|
||||
|
||||
```bash
|
||||
echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc
|
||||
@@ -143,8 +150,8 @@ Just restart terminal and you can go to step 2!
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>With WSL 2</summary>
|
||||
|
||||
<summary>With WSL 2</summary>
|
||||
|
||||
You need a windows version >= 1903.
|
||||
|
||||
@@ -168,13 +175,13 @@ This one allows virtual machines developed by Microsoft.
|
||||
4. Now open powershell admin like before and type:
|
||||
```powershell
|
||||
wsl --set-default-version 2
|
||||
```
|
||||
```
|
||||
5. Download [Ubuntu](https://www.microsoft.com/store/apps/9n6svws3rx71) from Microsoft store.
|
||||
|
||||
WSL is now installed.
|
||||
|
||||
### Usbipd installation to connect your calculator
|
||||
If you want to connect to the calculator, you have to connect to install this [tool](https://github.com/dorssel/usbipd-win/releases/download/v1.3.0/usbipd-win_1.3.0.msi). This will allow you to connect WSL to the calculator through internet. Follow the on screen information to install.
|
||||
If you want to connect to the calculator, you have to connect to install this [tool](https://github.com/dorssel/usbipd-win/releases/download/v1.3.0/usbipd-win_1.3.0.msi). This will allow you toconnect WSL to the calculator through internet. Follow the on screen information to install.
|
||||
#### Ubuntu
|
||||
1. In a WSL Ubuntu command prompt, type:
|
||||
```bash
|
||||
@@ -188,6 +195,7 @@ sudo visudo
|
||||
`Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."`
|
||||
|
||||
#### Debian
|
||||
|
||||
1. If you use debian for your WSL distro, use this command instead:
|
||||
```bash
|
||||
sudo apt install usbip hwdata usbutils
|
||||
@@ -207,12 +215,14 @@ usbipd wsl attach --busid <BUSID>
|
||||
It will ask you to type your wsl's password and will connect your calculator to WSL.
|
||||
|
||||
You can now go to step 2!
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
### 2. Set up repo
|
||||
|
||||
|
||||
@@ -230,7 +240,8 @@ git checkout upsilon-dev
|
||||
|
||||
|
||||
<details>
|
||||
<summary><b>Model n0100</b></summary>
|
||||
|
||||
<summary><b>Model n0100</b></summary>
|
||||
|
||||
(note: you can change the `EPSILON_I18N=en` flag to `fr`, `nl`, `pt`, `it`, `de`, `es` or `hu`).
|
||||
|
||||
@@ -253,12 +264,13 @@ or:
|
||||
```bash
|
||||
make MODEL=n0100 OMEGA_USERNAME="" binpack -j4
|
||||
```
|
||||
to make binpack witch you can flash to the calculator from [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0100/). Binpacks are a great way to share a custom build of Upsilon to friends.
|
||||
to make binpack which you can flash to the calculator from [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0100/). Binpacks are a great way to share a custom build of Upsilonto friends.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Model n0110</b></summary>
|
||||
|
||||
<summary><b>Model n0110</b></summary>
|
||||
|
||||
|
||||
```bash
|
||||
@@ -285,7 +297,8 @@ to make binpack witch you can flash to the calculator from [Ti-planet's webDFU](
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Web simulator</b></summary>
|
||||
|
||||
<summary><b>Web simulator</b></summary>
|
||||
|
||||
First, install emsdk :
|
||||
|
||||
@@ -306,11 +319,11 @@ make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Your name, max 15 characters
|
||||
|
||||
The simulator is now in `output/release/simulator/web/simulator.zip`
|
||||
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>3DS Simulator</b></summary>
|
||||
|
||||
<summary><b>3DS Simulator</b></summary>
|
||||
|
||||
You need devkitPro and devkitARM installed and in your path (instructions [here](https://devkitpro.org/wiki/Getting_Started))
|
||||
|
||||
@@ -378,4 +391,3 @@ NumWorks SAS and Nintendo of America Inc aren't associated in any shape or form
|
||||
* NumWorks Epsilon is released under a [CC BY-NC-SA License](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).
|
||||
* Omega is released under a [CC BY-NC-SA License](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).
|
||||
* Upsilon is released under a [CC BY-NC-SA License](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).
|
||||
|
||||
|
||||
339
docs/build/index.md
vendored
339
docs/build/index.md
vendored
@@ -4,71 +4,324 @@ breadcrumb: SDK
|
||||
---
|
||||
# Build and run your own version of Upsilon
|
||||
|
||||
## Install the SDK
|
||||
### Manual
|
||||
|
||||
### Windows
|
||||
*You can refer to this [website](https://www.numworks.com/resources/engineering/software/build/) for the first step if you get errors.*
|
||||
|
||||
We recommend using the [Msys2](https://www.msys2.org/) environment to install most of the required tools. We support Windows 7 and up. Once Msys2 has been installed, launch the Msys2 terminal application, and enter the following commands
|
||||
|
||||
|
||||
### 1. Install SDK
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.1 Linux</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Debian or Ubuntu</summary>
|
||||
|
||||
<br>
|
||||
|
||||
You just have to install dependencies by running these command with superuser privileges in a Terminal:
|
||||
|
||||
```bash
|
||||
apt-get install build-essential git imagemagick libx11-dev libxext-dev libfreetype6-dev libpng-dev libjpeg-dev pkg-config gcc-arm-none-eabi binutils-arm-none-eabi
|
||||
```
|
||||
|
||||
And there you can go to step 2!
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Fedora</summary>
|
||||
|
||||
<br>
|
||||
|
||||
To install basics dev tools:
|
||||
|
||||
```bash
|
||||
dnf install make automake gcc gcc-c++ kernel-devel
|
||||
```
|
||||
|
||||
And then install required packages.
|
||||
|
||||
```bash
|
||||
install git ImageMagick libX11-devel libXext-devel freetype-devel libpng-devel libjpeg-devel pkg-config
|
||||
```
|
||||
|
||||
Then, install GCC cross compiler for ARM.
|
||||
|
||||
```bash
|
||||
dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
|
||||
```
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.2 Mac</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
It's recommended to use [Homebrew](https://brew.sh/). Once it's installed, just run:
|
||||
|
||||
```bash
|
||||
brew install numworks/tap/epsilon-sdk
|
||||
```
|
||||
|
||||
and it will install all dependencies.
|
||||
|
||||
<br>
|
||||
|
||||
And there you can go to step 2!
|
||||
|
||||
<br>
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>1.3 Windows</b></summary>
|
||||
|
||||
<br>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>With Msys2/Mingw (officialized by numworks but with a lot of bugs)</summary>
|
||||
|
||||
[Msys2](https://www.msys2.org/) environment is recommended by Numworks to get most of the required tools on Windows easily. It's where you'll paste all the commands of this tutorial. Once it'sinstalled, paste these commands into the Msys2 terminal.
|
||||
|
||||
```bash
|
||||
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-freetype mingw-w64-x86_64-pkg-config mingw-w64-x86_64-libusb git make python
|
||||
echo "export PATH=/mingw64/bin:$PATH" >> .bashrc
|
||||
```
|
||||
|
||||
Last but not least, download and install the latest [GCC toolchain from ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). When prompted for an install location, choose `C:\msys64\home\User\gcc-arm\`. You'll then need to add this folder to your $PATH in Msys2 by running this command: `echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc` and restarting Msys2.
|
||||
|
||||
### macOS
|
||||
|
||||
We recommend using [Homebrew](https://brew.sh) to install all dependencies. Once you have installed Homebrew, install all the dependencies with the following command:
|
||||
Next, you'll need to install the [GCC toolchain for ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). When prompted for aninstall location, choose `C:\msys64\home\User\gcc-arm\`. You'll then need to add this folder to your $PATH. Just enter:
|
||||
|
||||
```bash
|
||||
echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc
|
||||
```
|
||||
brew install numworks/tap/epsilon-sdk
|
||||
Just restart terminal and you can go to step 2!
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary>With WSL 2</summary>
|
||||
|
||||
You need a windows version >= 1903.
|
||||
|
||||
#### WSL Installation
|
||||
|
||||
1. Use simultaneously win + X keys and then click on "admin powershell".
|
||||
```powershell
|
||||
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart
|
||||
```
|
||||
This command activate WSL functionalities.
|
||||
|
||||
```powershell
|
||||
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
|
||||
```
|
||||
This one allows virtual machines developed by Microsoft.
|
||||
|
||||
2. Restart your computer.
|
||||
|
||||
3. Download [this file](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) and follow instructions.
|
||||
|
||||
4. Now open powershell admin like before and type:
|
||||
```powershell
|
||||
wsl --set-default-version 2
|
||||
```
|
||||
5. Download [Ubuntu](https://www.microsoft.com/store/apps/9n6svws3rx71) from Microsoft store.
|
||||
|
||||
WSL is now installed.
|
||||
|
||||
### Usbipd installation to connect your calculator
|
||||
If you want to connect to the calculator, you have to connect to install this [tool](https://github.com/dorssel/usbipd-win/releases/download/v1.3.0/usbipd-win_1.3.0.msi). This will allow you toconnect WSL to the calculator through internet. Follow the on screen information to install.
|
||||
#### Ubuntu
|
||||
1. In a WSL Ubuntu command prompt, type:
|
||||
```bash
|
||||
sudo apt install linux-tools-5.4.0-77-generic hwdata
|
||||
```
|
||||
2. Edit /etc/sudoers so that root can find the usbip command. On Ubuntu, run this command.
|
||||
```bash
|
||||
sudo visudo
|
||||
```
|
||||
3. Add `/usr/lib/linux-tools/5.4.0-77-generic` to the beginning of secure_path. After editing, the line should look similar to this.
|
||||
`Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."`
|
||||
|
||||
#### Debian
|
||||
|
||||
1. If you use debian for your WSL distro, use this command instead:
|
||||
```bash
|
||||
sudo apt install usbip hwdata usbutils
|
||||
```
|
||||
And that's all for installation and set up.
|
||||
|
||||
### To connect your calculator
|
||||
1. Open an Admin powershell and type:
|
||||
```powershell
|
||||
usbipd wsl list
|
||||
```
|
||||
This will list your usb devices connected. Look at the BUSID column and remember the one for your calculator (it should be called "Numworks Calculator").
|
||||
2. Now run this command replacing <BUSID> by your calculator's usb port id:
|
||||
```powershell
|
||||
usbipd wsl attach --busid <BUSID>
|
||||
```
|
||||
It will ask you to type your wsl's password and will connect your calculator to WSL.
|
||||
|
||||
You can now go to step 2!
|
||||
|
||||
</details>
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
|
||||
### 2. Set up repo
|
||||
|
||||
|
||||
Clone repo and use 'upsilon-dev' branch by pasting these two commands:
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout upsilon-dev
|
||||
```
|
||||
<br>
|
||||
|
||||
|
||||
### 3. Choose the target
|
||||
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>Model n0100</b></summary>
|
||||
|
||||
(note: you can change the `EPSILON_I18N=en` flag to `fr`, `nl`, `pt`, `it`, `de`, `es` or `hu`).
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 clean
|
||||
make MODEL=n0100 EPSILON_I18N=en OMEGA_USERNAME="{Your name, max 15 characters}" -j4
|
||||
```
|
||||
|
||||
### Debian or Ubuntu
|
||||
|
||||
Most of the required tools are available as apt packages:
|
||||
Now, run either:
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 epsilon_flash
|
||||
```
|
||||
apt-get install build-essential git imagemagick libx11-dev libxext-dev libfreetype6-dev libpng-dev libjpeg-dev pkg-config
|
||||
to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
|
||||
|
||||
<br>
|
||||
|
||||
or:
|
||||
|
||||
```bash
|
||||
make MODEL=n0100 OMEGA_USERNAME="" binpack -j4
|
||||
```
|
||||
to make binpack which you can flash to the calculator from [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0100/). Binpacks are a great way to share a custom build of Upsilonto friends.
|
||||
|
||||
You'll also need to install the latest version of GCC and make it available in your $PATH:
|
||||
</details>
|
||||
|
||||
1. Download the [GCC toolchain distributed by ARM](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads). You should obtain a `gcc-arm-none-eabi-x-linux.tar.bz2` file.
|
||||
2. Decompress that file with `tar xvfj gcc-arm-none-eabi-*-linux.tar.bz2`
|
||||
3. Add the resulting folder to your $PATH. If you use bash, ``echo "export PATH=\$PATH:`find $(pwd)/gcc-arm-none-eabi-*-update/bin -type d`" >> ~/.bashrc`` should do what you need (you'll need to restart your terminal afterwards).
|
||||
<details>
|
||||
|
||||
Alternatively, on Debian 10 and later you can directly install a sufficiently modern cross-toolchain:
|
||||
```
|
||||
apt-get install gcc-arm-none-eabi binutils-arm-none-eabi
|
||||
```
|
||||
<summary><b>Model n0110</b></summary>
|
||||
|
||||
## Retrieve the source code
|
||||
|
||||
The code is hosted on <a href="https://github.com/Lauryy06/Upsilon">GitHub</a>. You can retrieve it using the following command.
|
||||
|
||||
```
|
||||
git clone https://github.com/Lauryy06/Upsilon.git
|
||||
```
|
||||
|
||||
## Run Upsilon on your computer
|
||||
|
||||
Once the SDK has been installed, just open your terminal (Msys2, Terminal.app, xterm…) and type the following commands:
|
||||
|
||||
```
|
||||
make PLATFORM=simulator clean
|
||||
make PLATFORM=simulator epsilon_run
|
||||
```
|
||||
|
||||
## Run Upsilon on your calculator
|
||||
|
||||
You can also update your NumWorks calculator easily. Note that you'll need to press the Reset button and that all data on your calculator will be lost.
|
||||
|
||||
```
|
||||
```bash
|
||||
make clean
|
||||
make
|
||||
make OMEGA_USERNAME="{Your name, max 15 characters}" -j4
|
||||
```
|
||||
|
||||
Now, run either:
|
||||
|
||||
```bash
|
||||
make epsilon_flash
|
||||
```
|
||||
to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
|
||||
|
||||
<br>
|
||||
|
||||
or:
|
||||
|
||||
```bash
|
||||
make OMEGA_USERNAME="" binpack -j4
|
||||
```
|
||||
to make binpack witch you can flash to the calculator from [Ti-planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0110/). Binpacks are a great way to share a custom build of Upsilon to friends.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>Web simulator</b></summary>
|
||||
|
||||
First, install emsdk :
|
||||
|
||||
```bash
|
||||
git clone https://github.com/emscripten-core/emsdk.git
|
||||
cd emsdk
|
||||
./emsdk install latest-fastcomp
|
||||
./emsdk activate latest-fastcomp
|
||||
source emsdk_env.sh
|
||||
```
|
||||
|
||||
Then, compile Upsilon :
|
||||
|
||||
```bash
|
||||
make clean
|
||||
make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Your name, max 15 characters}" -j4
|
||||
```
|
||||
|
||||
The simulator is now in `output/release/simulator/web/simulator.zip`
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
||||
<summary><b>3DS Simulator</b></summary>
|
||||
|
||||
You need devkitPro and devkitARM installed and in your path (instructions [here](https://devkitpro.org/wiki/Getting_Started))
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/Lauryy06/Upsilon.git
|
||||
cd Upsilon
|
||||
git checkout --recursive upsilon-dev
|
||||
make PLATFORM=simulator TARGET=3ds -j
|
||||
```
|
||||
You can then put epsilon.3dsx on a SD card to run it from the HBC or use 3dslink to launch it over the network:
|
||||
|
||||
```bash
|
||||
3dslink output/release/simulator/3ds/epsilon.3dsx -a <3DS' IP ADDRESS>
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<br>
|
||||
|
||||
Important: Don't forget the `--recursive` tag, because Upsilon relies on submodules.
|
||||
Also, you can change the number of processes that run in parallel during the build by changing the value of the `-j` flag.
|
||||
Don't forget to put your pseudo instead of `{your pseudo, max 15 char}`. If you don't want one, just remove the `OMEGA_USERNAME=""` argument.
|
||||
|
||||
<br>
|
||||
|
||||
Congratulations, you're running your very own version of Upsilon!
|
||||
|
||||
To build with a special theme, please refer to this [page](../../themes/README.md).
|
||||
|
||||
If you need help, you can join our Discord server here : https://discord.gg/NFvzdCBTQn
|
||||
|
||||
<a href="https://discord.gg/NFvzdCBTQn"><p align="center"><img alt="Omega Banner Discord" src="https://user-images.githubusercontent.com/12123721/86287349-54ef5800-bbe8-11ea-80c1-34eb1f93eebd.png" /></p></a>
|
||||
|
||||
Reference in New Issue
Block a user