31 lines
1.2 KiB
Markdown
31 lines
1.2 KiB
Markdown
# mesen-binary-monitor
|
|
|
|
This is a monitor for Mesen-X, intended to mimic [VICE's binary monitor](https://vice-emu.sourceforge.io/vice_13.html).
|
|
It is currently in an alpha state, and some commands are not functional or behave
|
|
incorrectly. I originally wrote this to support debugging in my [VS65 Debugger](https://github.com/empathicqubit/vscode-cc65-vice-debug).
|
|
To use it, make sure your script timeout is set as high as possible (2147483647)
|
|
and start up Mesen-X as such:
|
|
|
|
Linux:
|
|
|
|
```sh
|
|
MESEN_REMOTE_HOST=127.0.0.1 MESEN_REMOTE_WAIT=1 MESEN_REMOTE_PORT=9355 MESEN_REMOTE_BASEDIR=/path/to/mesen-binary-monitor mono Mesen.exe /path/to/mesen-binary-monitor/mesen_binary_monitor.lua romfile.nes
|
|
```
|
|
|
|
Windows (CMD):
|
|
|
|
```sh
|
|
set MESEN_REMOTE_HOST=127.0.0.1
|
|
set MESEN_REMOTE_WAIT=1
|
|
set MESEN_REMOTE_PORT=9355
|
|
set MESEN_REMOTE_BASEDIR=/path/to/mesen-binary-monitor
|
|
Mesen.exe /path/to/mesen-binary-monitor/mesen_binary_monitor.lua romfile.nes
|
|
```
|
|
|
|
The options:
|
|
|
|
* `MESEN_REMOTE_HOST`: The host to listen to
|
|
* `MESEN_REMOTE_PORT`: The port to listen to
|
|
* `MESEN_REMOTE_WAIT`: If set to `1`, pause the emulator immediately and wait
|
|
for a connection.
|
|
* `MESEN_REMOTE_BASEDIR`: Must always be the base path of the script.
|