UpsilonNumworks/Upsilon
1
0
Fork 0
mirror of https://github.com/UpsilonNumworks/Upsilon.git synced 2026-01-18 16:27:34 +01:00
Code Issues Packages Projects Releases Wiki Activity

[README/build] Add bootloader in README

Browse Source
This commit is contained in:
Yaya-Cout
2022-05-20 19:07:50 +02:00
parent 2a6d110f2f
commit e4f0762db3
3 changed files with 156 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files

107
README.fr.md
View File

@@ -2,7 +2,7 @@
<p align="center"> <p align="center">
<a href="https://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="cc by-nc-sa 4.0" src="https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-525252.svg?labelColor=292929&logo=creative%20commons&style=for-the-badge" /></a> <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="cc by-nc-sa 4.0" src="https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-525252.svg?labelColor=292929&logo=creative%20commons&style=for-the-badge" /></a>
<a href="https://github.com/Lauryy06/Upsilon/issues"><img alt="Issues" src="https://img.shields.io/github/issues/Lauryy06/Upsilon.svg?labelColor=292929&logo=git&style=for-the-badge" /></a> <a href="https://github.com/UpsilonNumworks/Upsilon/issues"><img alt="Issues" src="https://img.shields.io/github/issues/Lauryy06/Upsilon.svg?labelColor=292929&logo=git&style=for-the-badge" /></a>
<br/> <br/>
<a href="https://discord.gg/sbGvhWETAd"><img alt="Discord" src="https://img.shields.io/discord/663420259851567114?color=blue&labelColor=292929&label=chat%20-%20discord&logo=discord&style=for-the-badge" /></a> <a href="https://discord.gg/sbGvhWETAd"><img alt="Discord" src="https://img.shields.io/discord/663420259851567114?color=blue&labelColor=292929&label=chat%20-%20discord&logo=discord&style=for-the-badge" /></a>
</p> </p>
@@ -14,6 +14,7 @@
Upsilon est un fork d'Omega, un fork d'Epsilon, l'OS de Numworks tournant sur les calculatrices du même nom, qui apporte beaucoup de fonctionnalités en plus, mais qui fut archivé et fermé pour des raisons légales après un changement de politique de Numworks. Upsilon est fait pour ceux qui aimeraient voir un futur pour les OS créées par les utilisateurs pour Numworks, même après l'arrèt du projet initial. Upsilon est un fork d'Omega, un fork d'Epsilon, l'OS de Numworks tournant sur les calculatrices du même nom, qui apporte beaucoup de fonctionnalités en plus, mais qui fut archivé et fermé pour des raisons légales après un changement de politique de Numworks. Upsilon est fait pour ceux qui aimeraient voir un futur pour les OS créées par les utilisateurs pour Numworks, même après l'arrèt du projet initial.
### Quelques fonctionnalités supplémentaires ### Quelques fonctionnalités supplémentaires
- Un module python kandinsky amélioré - Un module python kandinsky amélioré
- Un support pour fonds d'écrans personnalisés - Un support pour fonds d'écrans personnalisés
- Des applications externes - Des applications externes
@@ -26,6 +27,7 @@ Upsilon est un fork d'Omega, un fork d'Epsilon, l'OS de Numworks tournant sur le
## Installation ## Installation
### Site web ### Site web
Rendez-vous sur le [site d'Upsilon](https://getupsilon.web.app/) à la section "Installer". Rendez-vous sur le [site d'Upsilon](https://getupsilon.web.app/) à la section "Installer".
Si votre calculatrice est reconnue, qu'elle contient une version d'Epsilon inférieure à 16 et que votre navigateur accepte WebUSB, la page vous proposera d'installer Upsilon. Si votre calculatrice est reconnue, qu'elle contient une version d'Epsilon inférieure à 16 et que votre navigateur accepte WebUSB, la page vous proposera d'installer Upsilon.
Ne débranchez votre calculatrice qu'une fois l'installation terminée. Ne débranchez votre calculatrice qu'une fois l'installation terminée.
@@ -34,8 +36,6 @@ Ne débranchez votre calculatrice qu'une fois l'installation terminée.
*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* *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 ### 1. Installation du SDK
<br> <br>
@@ -46,7 +46,6 @@ Ne débranchez votre calculatrice qu'une fois l'installation terminée.
<br> <br>
<details> <details>
<summary>Debian ou Ubuntu</summary> <summary>Debian ou Ubuntu</summary>
@@ -102,9 +101,11 @@ dnf install arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++
<br> <br>
Il est recommandé d'utiliser [Homebrew](https://brew.sh/). Une fois intsallé, utilisez: Il est recommandé d'utiliser [Homebrew](https://brew.sh/). Une fois intsallé, utilisez:
```bash ```bash
brew install numworks/tap/epsilon-sdk brew install numworks/tap/epsilon-sdk
``` ```
Et toutes les dependances seront installées. Et toutes les dependances seront installées.
<br> <br>
@@ -139,6 +140,7 @@ Ensuite, vous devrez installer [GCC toolchain for ARM](https://developer.arm.com
```bash ```bash
echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc
``` ```
Redémarrez votre terminal et vous pouvez aller à l'étape 2! Redémarrez votre terminal et vous pouvez aller à l'étape 2!
</details> </details>
@@ -154,14 +156,17 @@ Votre version de windows doit être >= 1903.
#### Installation de WSL #### 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: 1. Apuyez simulatanément sur les touches "windows" et "x" puis cliquez sur "Powershell administrateur". Entrez ensuite ceci dans la nouvelle fenêtre:
```powershell ```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart
``` ```
Cette commande active WSL Cette commande active WSL
```powershell ```powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
``` ```
Cette commande permet d'autoriser le démarrage des machines signées par Microsoft. Cette commande permet d'autoriser le démarrage des machines signées par Microsoft.
2. Redémarrez votre ordinateur. 2. Redémarrez votre ordinateur.
@@ -169,42 +174,56 @@ Cette commande permet d'autoriser le démarrage des machines signées par Micros
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. 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: 4. Ouvrez votre fenêtre powershell comme avant et tapez:
```powershell ```powershell
wsl --set-default-version 2 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). 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é. WSL est maintenant installé.
### Installation d'usbipd pour connecter la calculatrice à WSL (facultatif) ### 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. 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 #### Ubuntu
1. Dans un terminal WSL Ubuntu, tapez: 1. Dans un terminal WSL Ubuntu, tapez:
```bash ```bash
sudo apt install linux-tools-5.4.0-77-generic hwdata 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: 2. Editez /etc/sudoers pour que l'on puisse utiliser la commande usbip. Sur Ubutu, cele est fait de cette manière:
```bash ```bash
sudo visudo 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 à: 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:..."` `Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."`
#### Debian #### Debian
1.Si vous utiliser Debian, utilisez cette commande: 1.Si vous utiliser Debian, utilisez cette commande:
```bash ```bash
sudo apt install usbip hwdata usbutils sudo apt install usbip hwdata usbutils
``` ```
### Pour connecter la calculatrice à WSL ### Pour connecter la calculatrice à WSL
1. Ouvrez encore un powershell en mode administrateur et tapez: 1. Ouvrez encore un powershell en mode administrateur et tapez:
```powershell ```powershell
usbipd wsl list usbipd wsl list
``` ```
Ceci va lister les périphériques USB connectés à l'ordinateur. Reagrdez le BUSID de votre "Numworks Calculator". 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: 2. Maintenant, lancez cette commande en remplçant <BUSID> par celui de votre caculatrice:
```powershell ```powershell
usbipd wsl attach --busid <BUSID> usbipd wsl attach --busid <BUSID>
``` ```
@@ -221,20 +240,18 @@ Vous pouvez aller à l'étape 2.
### 2. Récupérer le code source ### 2. Récupérer le code source
Le code source est disponible dans une repository git. Récupérez-le de cette manière: Le code source est disponible dans une repository git. Récupérez-le de cette manière:
```bash ```bash
git clone --recursive https://github.com/Lauryy06/Upsilon.git git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git
cd Upsilon cd Upsilon
git checkout upsilon-dev git checkout upsilon-dev
``` ```
<br> <br>
### 3. Choisissez le système à compiler ### 3. Choisissez le système à compiler
<details> <details>
<summary><b>Model n0100</b></summary> <summary><b>Model n0100</b></summary>
@@ -251,6 +268,7 @@ Maintenant, lancez soit:
```bash ```bash
make MODEL=n0100 epsilon_flash 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. pour directement flasher la calculatrice après avoir appuyé simultanément sur `reset` et `6` et avoir branché la calculatrice à l'ordinateur.
<br> <br>
@@ -260,13 +278,14 @@ soit:
```bash ```bash
make MODEL=n0100 OMEGA_USERNAME="" binpack -j4 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/). 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>
<details> <details>
<summary><b>Model n0110</b></summary> <summary><b>Model bootloader (N0110)</b></summary>
```bash ```bash
make clean make clean
@@ -276,9 +295,10 @@ make OMEGA_USERNAME="{Votre nom, maximum 15 caractères}" -j4
Maintenant, lancez soit: Maintenant, lancez soit:
```bash ```bash
make epsilon_flash make epsilon.A_flash
``` ```
pour directement flasher la calculatrice après avoir appuyé simultanément sur `reset` et `6` et avoir branché la calculatrice à l'ordinateur.
pour directement flasher la calculatrice, ou avec le flasher de slots du bootloader avec RESET, puis 4 (menu de flash), et 1 (flash des slots).
<br> <br>
@@ -287,6 +307,34 @@ soit:
```bash ```bash
make OMEGA_USERNAME="" binpack -j4 make 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>
<summary><b>Model n0110 (obsolète, utilisez le bootloader à la place, pas de protection contre Epsilon)</b></summary>
```bash
make MODEL=n0110 clean
make MODEL=n0110 OMEGA_USERNAME="{Votre nom, maximum 15 caractères}" -j4
```
Maintenant, lancez soit:
```bash
make MODEL=n0110 epsilon_flash
```
pour directement flasher la calculatrice après avoir appuyé simultanément sur `reset` et `6` et avoir branché la calculatrice à l'ordinateur.
<br>
soit:
```bash
make MODEL=n0110 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/). 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>
@@ -300,8 +348,8 @@ D'abord, installez emsdk :
```bash ```bash
git clone https://github.com/emscripten-core/emsdk.git git clone https://github.com/emscripten-core/emsdk.git
cd emsdk cd emsdk
./emsdk install latest-fastcomp ./emsdk install 1.40.1
./emsdk activate latest-fastcomp ./emsdk activate 1.40.1
source emsdk_env.sh source emsdk_env.sh
``` ```
@@ -314,7 +362,6 @@ make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Votre nom, maximum 15 caract
Le simulateur se trouve dans `output/release/simulator/web/simulator.zip` Le simulateur se trouve dans `output/release/simulator/web/simulator.zip`
</details> </details>
<details> <details>
@@ -324,11 +371,12 @@ Le simulateur se trouve dans `output/release/simulator/web/simulator.zip`
Il vous faut devkitPro et devkitARM installés et dans votre path (les instructions sont [ici](https://devkitpro.org/wiki/Getting_Started)) Il vous faut devkitPro et devkitARM installés et dans votre path (les instructions sont [ici](https://devkitpro.org/wiki/Getting_Started))
```bash ```bash
git clone --recursive https://github.com/Lauryy06/Upsilon.git git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git
cd Upsilon cd Upsilon
git checkout --recursive upsilon-dev git checkout --recursive upsilon-dev
make PLATFORM=simulator TARGET=3ds -j make PLATFORM=simulator TARGET=3ds -j
``` ```
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: 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 ```bash
@@ -343,14 +391,15 @@ Important: n'oubliez pas l'argument `--recursive` Parce qu'Upsilon dépend de su
Aussi, vous pouvez changer le nombre de processus de compilation en parallèles en changeant le nombre après l'argument `-j`. 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`. 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 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> <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>
--- ---
## Liens utiles ## Liens utiles
* [Upsilon external (pour installer des applications supplémentaires et des fonds d'écran)](https://lauryy06.github.io/Upsilon-External/)
* [Documentation d'ulab](https://micropython-ulab.readthedocs.io/en/latest/) - [Upsilon external (pour installer des applications supplémentaires et des fonds d'écran)](https://upsilonnumworks.github.io/Upsilon-External/)
- [Documentation d'ulab](https://micropython-ulab.readthedocs.io/en/latest/)
## Contribution ## Contribution
@@ -360,14 +409,14 @@ Pour contribuer, merci de lire le [Wiki d'Omega](https://github.com/Omega-Numwor
Les anciens projets d'Omega, avant sa fermeture, qui ont été utilisés pour ce projet Les anciens projets d'Omega, avant sa fermeture, qui ont été utilisés pour ce projet
* [Omega Themes](https://github.com/Omega-Numworks/Omega-Themes) - [Omega Themes](https://github.com/Omega-Numworks/Omega-Themes)
* [Omega Website](https://github.com/Omega-Numworks/Omega-Website) - [Omega Website](https://github.com/Omega-Numworks/Omega-Website)
* [Omega RPN `APP`](https://github.com/Omega-Numworks/Omega-RPN) - [Omega RPN `APP`](https://github.com/Omega-Numworks/Omega-RPN)
* [Omega Atomic `APP`](https://github.com/Omega-Numworks/Omega-Atomic) - [Omega Atomic `APP`](https://github.com/Omega-Numworks/Omega-Atomic)
* [Omega Design](https://github.com/Omega-Numworks/Omega-Design) - [Omega Design](https://github.com/Omega-Numworks/Omega-Design)
* [Omega Discord Bot](https://github.com/Omega-Numworks/Omega-Discord-Bot) - [Omega Discord Bot](https://github.com/Omega-Numworks/Omega-Discord-Bot)
* [Omega App Template `BETA`](https://github.com/Omega-Numworks/Omega-App-Template) - [Omega App Template `BETA`](https://github.com/Omega-Numworks/Omega-App-Template)
* [External Apps](https://github.com/Omega-Numworks/External-Apps) - [External Apps](https://github.com/Omega-Numworks/External-Apps)
## À propos d'Epsilon ## À propos d'Epsilon
@@ -383,6 +432,6 @@ NumWorks est une marque déposée de NumWorks SAS, 24 Rue Godot de Mauroy, 75009
Nintendo est Nintendo 3DS sont des marques déposées de Nintendo of America Inc, 4600 150th Ave NE, Redmond, WA 98052, Etats-Unis. Nintendo est Nintendo 3DS sont des marques déposées de Nintendo of America Inc, 4600 150th Ave NE, Redmond, WA 98052, Etats-Unis.
NumWorks SAS et Nintendo of America Inc ne sont en aucun cas associés avec ce projet. NumWorks SAS et Nintendo of America Inc ne sont en aucun cas associés avec ce projet.
* NumWorks Epsilon est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). - NumWorks Epsilon est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).
* Omega est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). - Omega est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).
* Upsilon est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). - Upsilon est disponible sous [Lisense CC BY-NC-SA](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).

108
README.md
View File

@@ -13,10 +13,8 @@
Upsilon is a fork of Omega, an user-made OS that runs on the Numworks calculator, which brings many features to it, but was discontinued because of a policy change from Numworks. Upsilon is for the people who want to see a future for user-made OSes for Numworks, even after the closure and archiving of Omega. Upsilon is a fork of Omega, an user-made OS that runs on the Numworks calculator, which brings many features to it, but was discontinued because of a policy change from Numworks. Upsilon is for the people who want to see a future for user-made OSes for Numworks, even after the closure and archiving of Omega.
### Some new features ### Some new features
- Enhancements for the Kandinsky python module - Enhancements for the Kandinsky python module
- Support for wallpapers - Support for wallpapers
- External apps - External apps
@@ -39,8 +37,6 @@ Do not disconnect your calculator until the installation is complete.
*You can refer to this [website](https://www.numworks.com/resources/engineering/software/build/) for the first step if you get errors.* *You can refer to this [website](https://www.numworks.com/resources/engineering/software/build/) for the first step if you get errors.*
### 1. Install SDK ### 1. Install SDK
<br> <br>
@@ -145,6 +141,7 @@ Next, you'll need to install the [GCC toolchain for ARM](https://developer.arm.c
```bash ```bash
echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc
``` ```
Just restart terminal and you can go to step 2! Just restart terminal and you can go to step 2!
</details> </details>
@@ -158,14 +155,17 @@ You need a windows version >= 1903.
#### WSL Installation #### WSL Installation
1. Use simultaneously win + X keys and then click on "admin powershell". 1. Use simultaneously win + X keys and then click on "admin powershell".
```powershell ```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux all /norestart
``` ```
This command activate WSL functionalities. This command activate WSL functionalities.
```powershell ```powershell
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
``` ```
This one allows virtual machines developed by Microsoft. This one allows virtual machines developed by Microsoft.
2. Restart your computer. 2. Restart your computer.
@@ -173,6 +173,7 @@ This one allows virtual machines developed by Microsoft.
3. Download [this file](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi) and follow instructions. 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: 4. Now open powershell admin like before and type:
```powershell ```powershell
wsl --set-default-version 2 wsl --set-default-version 2
``` ```
@@ -187,31 +188,41 @@ If you want to connect to the calculator, you have to connect to install this [t
```bash ```bash
sudo apt install linux-tools-5.4.0-77-generic hwdata 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. 2. Edit /etc/sudoers so that root can find the usbip command. On Ubuntu, run this command.
```bash ```bash
sudo visudo 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. 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:..."` `Defaults secure_path="/usr/lib/linux-tools/5.4.0-77-generic:/usr/local/sbin:..."`
#### Debian #### Debian
1. If you use debian for your WSL distro, use this command instead: 1. If you use debian for your WSL distro, use this command instead:
```bash ```bash
sudo apt install usbip hwdata usbutils sudo apt install usbip hwdata usbutils
``` ```
And that's all for installation and set up. And that's all for installation and set up.
### To connect your calculator ### To connect your calculator
1. Open an Admin powershell and type: 1. Open an Admin powershell and type:
```powershell ```powershell
usbipd wsl list 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"). 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: 2. Now run this command replacing `<BUSID>` by your calculator's usb port id:
```powershell ```powershell
usbipd wsl attach --busid <BUSID> usbipd wsl attach --busid <BUSID>
``` ```
It will ask you to type your wsl's password and will connect your calculator to WSL. It will ask you to type your wsl's password and will connect your calculator to WSL.
You can now go to step 2! You can now go to step 2!
@@ -222,23 +233,20 @@ You can now go to step 2!
<br> <br>
### 2. Set up repo ### 2. Set up repo
Clone repo and use 'upsilon-dev' branch by pasting these two commands: Clone repo and use 'upsilon-dev' branch by pasting these two commands:
```bash ```bash
git clone --recursive https://github.com/Lauryy06/Upsilon.git git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git
cd Upsilon cd Upsilon
git checkout upsilon-dev git checkout upsilon-dev
``` ```
<br> <br>
### 3. Choose the target ### 3. Choose the target
<details> <details>
<summary><b>Model n0100</b></summary> <summary><b>Model n0100</b></summary>
@@ -255,6 +263,7 @@ Now, run either:
```bash ```bash
make MODEL=n0100 epsilon_flash make MODEL=n0100 epsilon_flash
``` ```
to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in. to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
<br> <br>
@@ -264,14 +273,16 @@ or:
```bash ```bash
make MODEL=n0100 OMEGA_USERNAME="" binpack -j4 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. 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>
<details> <details>
<summary><b>Model n0110</b></summary> <details>
<summary><b>Model bootloader (N0110)</b></summary>
```bash ```bash
make clean make clean
@@ -281,9 +292,10 @@ make OMEGA_USERNAME="{Your name, max 15 characters}" -j4
Now, run either: Now, run either:
```bash ```bash
make epsilon_flash make epsilon.A_flash
``` ```
to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
to directly flash the calculator into the current slot, or thought bootloader's slot flasher with RESET, then 4 (flash), and 1 (flash slots) for other slots.
<br> <br>
@@ -292,6 +304,36 @@ or:
```bash ```bash
make OMEGA_USERNAME="" binpack -j4 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>Model N0110 legacy (deprecated, use bootloader instead, no Epsilon protection)</b></summary>
```bash
make MODEL=n0110 clean
make MODEL=n0110 OMEGA_USERNAME="{Your name, max 15 characters}" -j4
```
Now, run either:
```bash
make MODEL=n0110 epsilon_flash
```
to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
<br>
or:
```bash
make MODEL=n0110 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. 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>
@@ -305,8 +347,8 @@ First, install emsdk :
```bash ```bash
git clone https://github.com/emscripten-core/emsdk.git git clone https://github.com/emscripten-core/emsdk.git
cd emsdk cd emsdk
./emsdk install latest-fastcomp ./emsdk install 1.40.1
./emsdk activate latest-fastcomp ./emsdk activate 1.40.1
source emsdk_env.sh source emsdk_env.sh
``` ```
@@ -328,11 +370,12 @@ The simulator is now in `output/release/simulator/web/simulator.zip`
You need devkitPro and devkitARM installed and in your path (instructions [here](https://devkitpro.org/wiki/Getting_Started)) You need devkitPro and devkitARM installed and in your path (instructions [here](https://devkitpro.org/wiki/Getting_Started))
```bash ```bash
git clone --recursive https://github.com/Lauryy06/Upsilon.git git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git
cd Upsilon cd Upsilon
git checkout --recursive upsilon-dev git checkout --recursive upsilon-dev
make PLATFORM=simulator TARGET=3ds -j 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: 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 ```bash
@@ -349,13 +392,16 @@ Don't forget to put your pseudo instead of `{your pseudo, max 15 char}`. If you
<br> <br>
If you need help, you can join our Discord server here : https://discord.gg/NFvzdCBTQn 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> <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>
--- ---
## Useful links ## Useful links
* [Upsilon external (to install additional apps and wallpapers)](https://lauryy06.github.io/Upsilon-External/)
* [Ulab documentation](https://micropython-ulab.readthedocs.io/en/latest/) - [Upsilon external (to install additional apps and wallpapers)](https://upsilonnumworks.github.io/Upsilon-External/)
- [Ulab documentation](https://micropython-ulab.readthedocs.io/en/latest/)
## Contributing ## Contributing
@@ -365,14 +411,14 @@ To contribute, please refer to [Omega's Wiki](https://github.com/Omega-Numworks/
Here are the main links toward Omega's different websites and repositories, that have been used for the creation of Upsilon. Here are the main links toward Omega's different websites and repositories, that have been used for the creation of Upsilon.
* [Omega Themes](https://github.com/Omega-Numworks/Omega-Themes) - [Omega Themes](https://github.com/Omega-Numworks/Omega-Themes)
* [Omega Website](https://github.com/Omega-Numworks/Omega-Website) - [Omega Website](https://github.com/Omega-Numworks/Omega-Website)
* [Omega RPN `APP`](https://github.com/Omega-Numworks/Omega-RPN) - [Omega RPN `APP`](https://github.com/Omega-Numworks/Omega-RPN)
* [Omega Atomic `APP`](https://github.com/Omega-Numworks/Omega-Atomic) - [Omega Atomic `APP`](https://github.com/Omega-Numworks/Omega-Atomic)
* [Omega Design](https://github.com/Omega-Numworks/Omega-Design) - [Omega Design](https://github.com/Omega-Numworks/Omega-Design)
* [Omega Discord Bot](https://github.com/Omega-Numworks/Omega-Discord-Bot) - [Omega Discord Bot](https://github.com/Omega-Numworks/Omega-Discord-Bot)
* [Omega App Template `BETA`](https://github.com/Omega-Numworks/Omega-App-Template) - [Omega App Template `BETA`](https://github.com/Omega-Numworks/Omega-App-Template)
* [External Apps](https://github.com/Omega-Numworks/External-Apps) - [External Apps](https://github.com/Omega-Numworks/External-Apps)
## About Epsilon ## About Epsilon
@@ -388,6 +434,6 @@ NumWorks is a registered trademark of NumWorks SAS, 24 Rue Godot de Mauroy, 7500
Nintendo and Nintendo 3DS are registered trademarks of Nintendo of America Inc, 4600 150th Ave NE, Redmond, WA 98052, USA. Nintendo and Nintendo 3DS are registered trademarks of Nintendo of America Inc, 4600 150th Ave NE, Redmond, WA 98052, USA.
NumWorks SAS and Nintendo of America Inc aren't associated in any shape or form with this project. NumWorks SAS and Nintendo of America Inc aren't associated in any shape or form with this project.
* NumWorks Epsilon is released under a [CC BY-NC-SA License](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode). - 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). - 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). - Upsilon is released under a [CC BY-NC-SA License](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode).

2
build/platform.device.mak
View File

@@ -1,4 +1,4 @@
MODEL ?= n0110 MODEL ?= bootloader
USE_LIBA = 1 USE_LIBA = 1
EXE = elf EXE = elf