Skip to content

Commit

Permalink
update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
beckadamtheinventor committed Oct 11, 2024
1 parent c5b40d7 commit 5ca4208
Showing 1 changed file with 22 additions and 9 deletions.
31 changes: 22 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ If you do not get a formatting screen, but get an "invalid OS" error or the like


# Building
BOS requires the CE C toolchain version 9.2 or higher and the BOS toolchain extension.
BOS requires the CE C toolchain version 12.0 or higher and the BOS toolchain extension.
Python 3.7 or higher is required to build includes and documentation.

Link to CE C toolchain:
Expand All @@ -50,11 +50,30 @@ https://github.com/beckadamtheinventor/toolchain-bos

Once both toolchains are installed, run `make` from your system's command line while in the repo's root directory.

# Transferring programs
There are a few ways that programs can be transferred.
Programs can be packaged with the ROM image for use with CEmu, [https://ce-programming.github.io/CEmu/], transferred from a FAT32 formatted USB drive, or sent via serial-connect.
If the program is written for BOS, read the README file that came with the program, (chances are the author has provided one) and look for install instructions.


## FAT32 USB drive

You will need a USB-mini male to USB female OTG adapter (or equivalent) to connect a USB drive to the calc.
Once you have the drive, run the program titled "msd" (path on-calc: `/opt/bin/msd`), plug it in, and use enter to select files.


## serial-connect

You will need the cable that came with the calculator (or equivalent) to use serial-connect, as well as the PySerial Python module on your PC.
Run the program titled "srl" (path on-calc: `/opt/bin/srl`), plug the cable into your PC and calc, then run (with python) the file titled `serial-connect.py` in the BOS source folder.
From there, you should get an interactive prompt PC-side, with instructions.


# Updating BOS
In order to update BOS at this time you will need to either reinstall TIOS, or install the update via a FAT32 formatted USB flash drive.
In order to update BOS, you will need to either reinstall TIOS, transfer the updater via a FAT32 formatted USB flash drive, or using the serial-connect.
Updating by USB is over 3x faster than doing a fresh install however, and should be preferred if possible.
To uninstall, press the reset button found on the back of the calculator, open the recovery menu by pressing F1/y= and press del.
To uninstall, press the reset button found on the back of the calculator, (quickly) open the recovery menu by pressing F1/y= and press del.
The update files are BOSUPDTR.BIN and BOSOSPT2.BIN, the install files are BOSOS.8xp and BOSOSpt2.8xv.


# BOS Recovery Options
Expand All @@ -76,12 +95,6 @@ Additionally, if you make a program for BOS that you feel should be included in
Made an enhancement? Optimized some code? Fixed a clerical error? Improved the UI? Make a pull request and I'll take a look.


# Installing programs on BOS
There are a few ways that BOS programs can be installed.
Programs written for BOS can be packaged with the ROM image for use with CEmu, [https://ce-programming.github.io/CEmu/], via BOS Package manager, (COMING SOON) or transferred from a FAT32 formatted USB drive.
In any case, read the README file that came with the program, (chances are the author has provided one) and look for install instructions.


# Documentation for developers

## BOS OS Call Documentation
Expand Down

0 comments on commit 5ca4208

Please sign in to comment.