zardam / nw-external-apps

External application installer for N110 calculators

Epsilon

The base firmware image is a fork of https://github.com/numworks/epsilon including the "external" application and an API for accessing base functionality of epsilon.

The modified sources can be found here : https://github.com/Delta-NumWorks/delta/tree/external

If something goes wrong

Do an official firmware upgrade. Follow the instructions on https://workshop.numworks.com/devices/upgrade. You can always restore the calculator using this method.

I'm not affiliated with NumWorks. If your calculator is buggy when using this firmware, please restore the official one.

Included applications

KhiCAS

The port included here is a port from the delta firmware : https://github.com/Delta-NumWorks/delta/tree/delta

Periodic

This is a port of https://github.com/M4xi1m3/nw-atom

Nofrendo

This is a port of Nofrendo from https://www.baisoku.org/

Developer info

Technical concepts

• The firmware part is just a regular application called "External", looking for a tar archive at address 0x90200000. If found, each file is displayed in a menu.
• To launch a file, the external application fetches the firsts 4 bytes of the file, and use it as a function pointer to the address of the entrypoint. The entrypoint is then called with an array of function pointers as en API, and a pointer to a pre-allocated heap.
• Each application is totally independent (and needs to bring its own libc, ...). data and bss sections are allocated in ITCM RAM, and the heap is pre-allocated from epsilon. The state of the application is totally reset upon entry.
• To build a usable tar archive, relocation needs to be done to account the real adresses in flash of the binaries. There is a script called "archive" in this repository, which calls the linker on partially linked elf, to build final correctly relocated elf files (then added to the tar archive).
• The file in the tar must be marked as executable to be executable.

nw-external-apps's Issues

Compatibility with the N0100

Yop,

Any way to add compatibility to the N0100 ?

Can't flash on n0100

The link (
)
make that

Licensing?

So, after digging deeper in that repository, I found one massive issue : no license is provided for the code you wrote yourself. Plus, this repository being a mixed mess of different licenses (GNU GPLv2, MIT, CC-BY-SA-NC, etc...) you should consider creating either a section in your README listing every license of every software you use, or creating a dedicated LICENSE file with everything.

I'mm willing to do that as a PR, if you don't have time to do it. Just tell which license you want on your code? (MIT would be a good option, as it's permissive and simple).

How to delete an installed external app

I installed Omega on my numworks calculator and installed external app "Periodic" and "KhiCAS" via web. But I found no matter how I re-flash the Omega image, these 2 apps always exist.
I tried flash back to factory image and re-flash Omega, these 2 apps are still there.
Is there a way to get rid of them?

WebUsb not detected on chromium on mac

WebUsb is not detected on chromium on mac. It is on Linux Debian.
It says "'Your browser doesn't support WebUsb, please install Chromium", but the official Numworks website has no problem to transfert scripts so I think this issue come from this page.

[API] Add LZ4 for external

Epsilon has LZ4 in its source, but the API doesn't export its functions, so some apps re-implement it externaly (like peanut gb), loosing some ROM...

How can I automate the install of external package and file ?

Hi !

I want to use my tty to flash and build external packages and files :). Do you have a solution ?

Thanks!

How do I install ROMs on Nofrendo?

How do I install ROMs on Nofrendo? There is absolutely NO documentation provided anywhere.