https://github.com/hkzlab/rosim_loader
Companion software for the ROsiM ROM emulator/simulator
https://github.com/hkzlab/rosim_loader
client eprom eprom-emulator
Last synced: 10 months ago
JSON representation
Companion software for the ROsiM ROM emulator/simulator
- Host: GitHub
- URL: https://github.com/hkzlab/rosim_loader
- Owner: hkzlab
- License: gpl-3.0
- Created: 2020-11-16T06:50:09.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-12-14T12:20:17.000Z (over 5 years ago)
- Last Synced: 2025-03-30T06:28:55.996Z (about 1 year ago)
- Topics: client, eprom, eprom-emulator
- Language: Java
- Homepage:
- Size: 92.8 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ROsiM Loader
## Introduction
The ROsiM Loader is the companion application for the [ROsiM ROM simulator](https://github.com/hkzlab/ROsiM) and it's used to upload ROM dumps into the board's memory and automatically control the line drivers.
## How to build
It's a Maven Java project, and can be used on both Windows and Linux without issues. If you have Maven and a JDK >= 1.8, it should be sufficient to go in the base directory of this project and run
```sh
mvn package -f pom.xml
```
You'll then get your generated JARs in the `target` directory.
## Command line
Command syntax for this tool is pretty simple:
```sh
java -jar loader.jar
```
Where `` is the serial device on Linux (e.g. `/dev/ttyUSB0`) or the COM port on windows (e.g. `COM4`) and `` is the file to be uploaded.
`` can be one of the following:
- `BIN_8`: The file will be treated as a binary dump from an 8 bit ROM
- `BIN_16`: The file will be treated as a binary dump from a 16 bit ROM. ODD bytes in the file will end up in the high byte of the output, EVEN bytes will end up in the low byte.
- `BIN_16S`: The file will be treated like in `BIN_16`, but each two bytes will be swapped.
## Upload procedure
Once the upload starts, the board will assert its external RESET line. This line is meant to be connected to the reset circuitry of the target board.
While the upload is ongoing the SRAMs are isolated from the target's circuitrey, they will be connected only after the upload completes, immediately followed by the RESET line being disabled.
Once the upload completes and the RESET line is deasserted, the program will remain running, periodically pinging the ROSiM board to check the connection.
If the user wishes to quit, press CTRL-C and the board will be reset to defaults and disconnected.