# Oricutron

Debugging

To access Oricutron's debugger you need to press the F2 key. This will show you this screen:

In the monitor, number arguments are decimal by default, or prefixed with $ for hex or % for binary. Pretty much everything is output in hex.

In most places where you can enter a number or address, you can pass a CPU or VIA register. (VIA registers are prefixed with V, e.g. VDDRA). Anywhere you can pass an address, you can also use a symbol.

Commands

To use Oricutron's debugger, you need to know some keys:

- F2: Return to the emulator
- F3: Toggle console/debug output/memwatch
- F4: Toggle VIA/AY information
- F9: Reset cycle count
- F10: Step over code
- F11: Step over code without tracing into subroutines.
- F12: Skip instruction

Advanced features

You also have some more advanced commands:

- ? - Help
- a - Assemble
- bc - Clear breakpoint
- bcm - Clear mem breakpoint
- bl - List breakpoints
- blm - List mem breakpoints
- bs - Set breakpoint
- bsm [rwc] - Set mem breakpoint
- bz - Zap breakpoints
- bzm - Zap mem breakpoints
- d - Disassemble
- df - Disassemble to file
- m - Dump memory
- mm - Modify memory
- mw - Memory watch at addr
- nl - Load snapshot
- ns - Save snapshot
- r - Set to
- q, x or qm - Quit monitor
- qe - Quit emulator
- sa - Add or move user symbol
- sk - Kill user symbol
- sc - Symbols not case-sensitive
- sC - Symbols case-sensitive
- sl - Load user symbols
- sx - Export user symbols
- sz - Zap user symbols
- wm - Write mem to disk

Historic

Here is the list of all releases with a short description of things that changed:

Version 1.2.4 (14-Feb-2021)

- Added Android target platform
- Updated BD500 for DOS70
- Added option to disable menu color scheme
- Updated BD500 support
- Fixed crash with visual keyboard on/off
- Added Byte Drive BD-500 support
- Added possibility to load more images from command line
- Fixed memory leaks and improvements in disk support
- Added monitor command 'fr' - fr addr file - Read BIN file to mem
- Changed monitor command 'df' to 'fd' for better consistency
- Changed monitor command 'wm' to 'fw' for better consistency
- Added new 'dcadjust' option in .cfg file - toggles on/off audio DC adjustment
- Added German translation of 'ReadMe.txt' - 'ReadMe-LiesMich_DE.txt'
- Fixed issue #116 no ACIA in Telestrat mode
- Added read-track and write-track support for FDC (assinie)
- Center windows on return from fullscreen mode (rzumer)
- Fixed Z-flag in BCD mode (iss)
- Fixed embedded assembler: BRK is a 2 bytes instruction
- Added 3rd button support with SDL Joystick
- Added Telestrat Joysticks support
- Fixed CSAVE/CLOAD with Sedoric
- Added missing chars (@,&) in monitor font
- Fixed typing upper case chars and syms in debugger window
- Added case insensitive file extensions for GTK file selector dialog
- Fixed loading of rom/pch files in Telestrat mode
- Added 'pravdiskautoboot' option in .cfg file
- Added 'printenable' option in .cfg file
- Added 'printfilter' option in .cfg file

Version 1.2 (01-Nov-2014)

- Fixed memory access breakpoints which were broken in (at least) v1.1.
- Added snapshot files to the filetype autodetection
- Added a virtual on-screen keyboard, and the ability to remap keys (torguet)
- Fixed autobooting of Jasmin disks (christian)
- ACIA 6551 serial port emulation, including a virtual modem which lets you connect over TCP/IP (iss)
- Fixed a bug in the V flag emulation for SBC/ADC (christian)
- Detects invalid .tap images (encoded length larger than tape image length)
- Added copy to clipboard (iss)

Version 1.1 (07-Dec-2013)

- Now possible to set scanline and fullscreen options when built without OpenGL support
- Includes patches and symbols for Pravetz 8D rom
- Disk and tape image autodetection. Oricutron will now attempt to detect the configuration required for any disk or tape inserted via commandline or menu.
- "Insert disk 0/1" menu items enabled even when no disk drive is enabled. Inserting a disk will use the autodetection routines to determine which drive type to enable.
- Autorun for Jasmin and Pravetz disks
- Fixed crash bug when switching between software and GL rendering on builds using SDL requesters.
- Various AY emulation improvements
- Simplified system timing