search

UpsilonNumworks / Upsilon

Upsilon, an OS forked from Omega for your Numworks calculator
https://getupsilon.web.app/
Other
209 stars 61 forks source link
hacktoberfest

readme

cc by-nc-sa 4.0 Issues
Discord

🇫🇷 Vous ne comprenez pas l'anglais ? Vous êtes francophone ? Regardez le LISEZ-MOI français ! 🇫🇷

About

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


Installation

Installer

Go to the Upsilon website to the "Install" section. If your calculator is recognized, contains a version of Epsilon lower than 16 and your browser accepts WebUSB, the page will suggest you to install Upsilon. Do not disconnect your calculator until the installation is complete.

Manual

You can refer to this website for the first step if you get errors.

1. Install SDK


1.1 Linux
Debian or Ubuntu
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!
Fedora
To install all dependencies: ```bash dnf install make automake gcc gcc-c++ kernel-devel git ImageMagick libX11-devel libXext-devel freetype-devel libpng-devel libjpeg-devel pkg-config arm-none-eabi-gcc-cs arm-none-eabi-gcc-cs-c++ ```
Nix or Nixos
To install all dependencies: ```bash nix-shell -p gcc libpng libjpeg xorg.libX11 pkg-config freetype xorg.libXext python3 imagemagick python310Packages.lz4 python310Packages.pypng python310Packages.pypng gcc-arm-embedded ```

1.2 Mac
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.
And there you can go to step 2!
1.3 Windows
With Msys2/Mingw (officialized by NumWorks but with a lot of bugs) [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. ```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: ```bash echo "export PATH=$PATH:$HOME/gcc-arm/bin" >> .bashrc ``` Just restart terminal and you can go to step 2!
With WSL 2 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. 6. Then install GCC cross compiler for ARM. ```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 ``` ### 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. #### 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 `` by your calculator's USB port id: ```powershell usbipd wsl attach --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!


2. Set up repo

Clone repo and use 'upsilon-dev' branch by pasting these two commands:

git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git
cd Upsilon
git checkout upsilon-dev


3. Choose the target

Model n0100 (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}" -j$(nproc) ``` Now, run either: ```bash make MODEL=n0100 epsilon_flash ``` to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
or: ```bash make MODEL=n0100 OMEGA_USERNAME="" binpack -j$(nproc) ``` 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 Upsilon to friends.
Model n0110 The bootloader allows you to install 2 firmwares in separated "slots". If so, external apps won't have all the space but half. Bootloader will allow use of all of the memory if only one slot is flashed. In legacy mode, external apps use all the space available.
Bootloader Your calculator must already have been flashed with [Upsilon](https://getupsilon.web.app)'s or [Omega](https://getomega.dev)'s bootloader. Then, build with: ```bash make clean make OMEGA_USERNAME="{Your name, max 15 characters}" -j$(nproc) ``` Now, run either: ```bash make epsilon.A_flash ``` 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.
or: ```bash make OMEGA_USERNAME="" binpack -j$(nproc) ``` to make binpack which you can flash to the calculator from [TI-Planet's webDFU](https://ti-planet.github.io/webdfu_numworks/n0110/). You'll find them at `output/release/device/bootloader/`. Binpacks are a great way to share a custom build of Upsilon to friends.
Model N0110 legacy (deprecated, use bootloader instead for Epsilon protection) ```bash make MODEL=n0110 clean make MODEL=n0110 OMEGA_USERNAME="{Your name, max 15 characters}" -j$(nproc) ``` Now, run either: ```bash make MODEL=n0110 epsilon_flash ``` to directly flash the calculator after pressing simultaneously `reset` and `6` buttons and plugging in.
or: ```bash make MODEL=n0110 OMEGA_USERNAME="" binpack -j$(nproc) ``` to make binpack which you can flash to the calculator from [Ti-Planet's WebDFU](https://ti-planet.github.io/webdfu_numworks/n0110/). You'll find them at `output/release/device/bootloader/`. Binpacks are a great way to share a custom build of Upsilon to friends.
Native simulator Run this command: ```bash make clean ``` You can either build using the following command that will automatically detect your platform: ```bash make PLATFORM=simulator ``` or, choose the command corresponding to your platform: ```bash make PLATFORM=simulator TARGET=android make PLATFORM=simulator TARGET=ios make PLATFORM=simulator TARGET=macos make PLATFORM=simulator TARGET=web make PLATFORM=simulator TARGET=windows make PLATFORM=simulator TARGET=3ds ``` You'll find simulator files in `output/release/simulator/`.
Web simulator First, install emsdk : ```bash git clone https://github.com/emscripten-core/emsdk.git cd emsdk ./emsdk install 1.40.1 ./emsdk activate 1.40.1 source emsdk_env.sh ``` Then, compile Upsilon : ```bash make clean make PLATFORM=simulator TARGET=web OMEGA_USERNAME="{Your name, max 15 characters}" -j$(nproc) ``` The simulator is now in `output/release/simulator/web/simulator.zip`
3DS Simulator 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/UpsilonNumworks/Upsilon.git cd Upsilon git checkout upsilon-dev make PLATFORM=simulator TARGET=3ds -j$(nproc) ``` 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> ```


Casio fx-CG-series Port First, install gint and fxsdk along with a cross compiler for the calculator. There are instructions for this (in French, but Google Translate works well enough) [here](https://www.planet-casio.com/Fr/forums/topic16614-last-giteapc-installer-et-mettre-a-jour-automatiquement-des-projets-gitea.html). Next: ```bash git clone --recursive https://github.com/UpsilonNumworks/Upsilon.git cd Omega git checkout upsilon-dev make PLATFORM=simulator TARGET=fxcg -j$(nproc) ``` Then copy the file at `./output/release/simulator/fxcg/epsilon.g3a` to the calculator over USB.

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.


If you need help, you can join our Discord server here : https://discord.gg/NFvzdCBTQn

Omega Banner Discord

Useful links

Contributing

To contribute, please refer to Omega's Wiki, the same rules apply here.

Related repositories

Here are the main links toward Omega's different websites and repositories, that have been used for the creation of Upsilon.

About Epsilon

Upsilon is a fork of Omega, after the project's discontinuation.

Omega is a fork of Epsilon, a high-performance graphing calculator operating system. It includes eight apps that cover the high school mathematics curriculum.

You can try Epsilon straight from your browser in the online simulator.

License

NumWorks is a registered trademark of NumWorks SAS, 24 Rue Godot de Mauroy, 75009 Paris, France. Nintendo and Nintendo 3DS are registered trademarks of Nintendo of America Inc, 4600 150th Ave NE, Redmond, WA 98052, USA. Casio is a registered trademark of Casio Computer Co., Ltd. CORPORATION JAPAN 6-2, Hon-machi 1-chome Shibuya-ku, Tokyo JAPAN 151-8543. NumWorks SAS, Nintendo of America Inc and Casio aren't associated in any shape or form with this project.