6502/6502bench
1
0
Fork 0
mirror of https://github.com/fadden/6502bench.git synced 2024-12-04 11:49:58 +00:00
Code Issues Projects Releases Wiki Activity
d2326c389f
6502bench/SourceGen/RuntimeData/Help/tools.html

160 lines
6.9 KiB
HTML
Raw Normal View History

Initial file commit
2018-09-28 17:05:11 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link href="main.css" rel="stylesheet" type="text/css" />
<title>Tools - 6502bench SourceGen</title>
</head>
<body>
Clean up HTML in manual
2018-10-09 17:04:10 +00:00
<div id="content">
Initial file commit
2018-09-28 17:05:11 +00:00
<h1>6502bench SourceGen: Tools</h1>
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
<h2><a name="instruction-chart">Instruction Chart</a></h2>
Use relocation data to format instruction operands This was a relatively lightweight change to confirm the usefulness of relocation data. The results were very positive. The relatively superficial integration of the data into the data analysis process causes some problems, e.g. the cross-reference table entries show an offset because the code analyzer's computed operand offset doesn't match the value of the label. The feature should be considered experimental The feature can be enabled or disabled with a project property. The results were sufficiently useful and non-annoying to make the setting enabled by default.
2020-07-04 00:37:04 +00:00
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
<p>This opens a window with a summary of all 256 opcodes. The CPU can
Improve CPU instruction chart Added "show undocumented opcodes" checkbox, so you can choose whether or not to see them at all. (Issue #60) Added formatter call for the instruction mnemonics so they get capitalized when the app is configured for upper-case opcodes. (Issue #59) Fix a bug where the instruction chart and ASCII chart were writing their modes to the same setting, stomping each other. Also, pluralized a button in the file concatenator.
2020-02-18 21:25:20 +00:00
be chosen from the pop-up list at the bottom. Undocumented opcodes for
6502/65C02 are shown in italics, and can be excluded from the list
by unchecking the box at the bottom.</p>
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
<p>The status flags affected by each instruction reflect their behavior
on the 65816. The only significant difference between 65816 and
6502/65C02 is the way the BRK instruction affects the D and B/X flags.</p>
<h2><a name="ascii-chart">ASCII Chart</a></h2>
<p>This opens a window with the ASCII character set. Each character is
displayed next to its numeric value in decimal and hexadecimal. The
pop-up list at the bottom allows you to flip between standard and "high"
ASCII.</p>
Add Apple II screen memory chart Show mapping between lines on the text and hi-res screens and locations in memory.
2020-08-20 20:18:46 +00:00
<h2><a name="apple2-screen-chart">Apple II Screen Chart</a></h2>
<p>The Apple II text and hi-res screens are mapped to memory in a way
that makes sense to computers but is a little confusing for humans. This
chart maps line numbers to addresses and vice-versa. Select different
screens and sort orders from the list at the bottom.</p>
Initial file commit
2018-09-28 17:05:11 +00:00
<h2><a name="hexdump">Hex Dump Viewer</a></h2>
<p>You can use this to view the contents of the project data file
by double-clicking the "bytes" column, or with Actions &gt; Show Hex Dump.
The viewer is displayed in a "modeless" dialog that does not
prevent you from continuing to work with the project. If you
double-click a different line in the project, the viewer will automatically
highlight those bytes.</p>
<p>You can also use this to view the contents of arbitrary files by
using Tools &gt; Hex Dump. There is no fixed limit on the number of
viewers you can have open simultaneously. (Be aware that the viewer
currently loads the entire file into memory, and you will run out of room
eventually. Not coincidentally, the viewer has a size limit of 16MiB
per file.)</p>
<p>You can select lines with the mouse as you would in any other list
view. Ctrl+A selects all lines. Ctrl+C copies the selected lines to
the system clipboard.</p>
Update documentation PETSCII, ACME, and other improvements.
2019-08-18 23:42:40 +00:00
<p>The "character conversion" selector allows you to choose how the
bytes are converted to characters for the Text column. Choose from
the usual set of encodings.</p>
Initial file commit
2018-09-28 17:05:11 +00:00
<p>If "ASCII-only dump" is not checked, non-printable bytes are shown in
the ASCII dump as a middle dot ('&#183;'). If the box is checked,
non-printable bytes are represented by a period ('.') instead. The
use of non-ASCII characters makes the dump unambiguous when unprintable
characters are mixed with periods, but the lines may be unsuitable for
Update documentation PETSCII, ACME, and other improvements.
2019-08-18 23:42:40 +00:00
pasting in some forums.</p>
Initial file commit
2018-09-28 17:05:11 +00:00
<p>If "always on top" is checked, the window will stay above all other
windows that don't also declare that they should always be on top. By
Revise documentation
2018-10-04 01:03:04 +00:00
default this box is checked when displaying project data, and not checked for
Initial file commit
2018-09-28 17:05:11 +00:00
external files.</p>
Add file concatenation tool Select a list of files and save it. File lengths and CRCs are shown for reference.
2019-12-29 01:14:29 +00:00
<h2><a name="file-concat">File Concatenator</a></h2>
<p>The File Concatenator combines multiple files into a single file.
Select the files to add, arrange them in the proper order, then hit
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
"Save". CRC-32 values are shown for reference.</p>
Add file concatenation tool Select a list of files and save it. File lengths and CRCs are shown for reference.
2019-12-29 01:14:29 +00:00
Initial file commit
2018-09-28 17:05:11 +00:00
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
<h2><a name="file-slicer">File Slicer</a></h2>
Initial file commit
2018-09-28 17:05:11 +00:00
Add file slicer tool The tool allows you to cut a piece out of a file by specifying an offset and a length. A pair of hex dumps helps you verify that the positions are correct. Also, minor cleanups elsewhere.
2019-12-30 01:59:35 +00:00
<p>The File Slicer allows you to "slice" a piece out of a file, saving
it to a new file. Specify the start and length in decimal or hex. If
you leave a field blank, they will default to offset 0 and the remaining
length of the file, respectively.</p>
<p>The hex dumps show the area just before and after the chunk to be
sliced, allowing you to confirm the placement.</p>
Add instruction chart This adds a window that displays all of the instructions for a given CPU in a summary grid. Undocumented instructions are included, but shown in grey italics. Also, tweaked AppSettings to not mark itself as dirty if a "set" operation doesn't actually change anything.
2019-10-21 22:15:09 +00:00
Use relocation data to format instruction operands This was a relatively lightweight change to confirm the usefulness of relocation data. The results were very positive. The relatively superficial integration of the data into the data analysis process causes some problems, e.g. the cross-reference table entries show an offset because the code analyzer's computed operand offset doesn't match the value of the label. The feature should be considered experimental The feature can be enabled or disabled with a project property. The results were sufficiently useful and non-annoying to make the setting enabled by default.
2020-07-04 00:37:04 +00:00
<h2><a name="omf-converter">OMF Converter</a></h2>
Fix bank for AbsInd and AbsIndLong addressing The Absolute Indirect and Absolute Indirect Long addressing modes (e.g. "JMP (addr)" and "JMP [addr]") are 16-bit values in bank 0. The code analyzer was placing them in the program bank, which meant the wrong symbol was being used. Also, tweak some docs.
2020-07-04 22:03:23 +00:00
<p>This tool allows you to view Apple IIgs Object Module Format (OMF)
executables, and convert them for disassembly.</p>
<p>OMF executables have multiple segments with relocatable code. References
to addresses aren't filled in until the program is loaded into memory,
which makes it difficult to disassemble the file. The conversion tool
loads the OMF file in roughly the same way the GS/OS System Loader would,
placing each segment at the start of a bank unless otherwise directed.
The loaded image is saved to a new file, and a SourceGen project file is
created with some basic attributes filled in.</p>
<p>Only "Load" files (S16, PIF, TOL, etc) may be converted. Compiler object
Improve OMF feature docs
2021-06-15 15:57:00 +00:00
files and libraries contain references that must be resolved by
a IIgs linker, and are not supported.</p>
Use relocation data to format instruction operands This was a relatively lightweight change to confirm the usefulness of relocation data. The results were very positive. The relatively superficial integration of the data into the data analysis process causes some problems, e.g. the cross-reference table entries show an offset because the code analyzer's computed operand offset doesn't match the value of the label. The feature should be considered experimental The feature can be enabled or disabled with a project property. The results were sufficiently useful and non-annoying to make the setting enabled by default.
2020-07-04 00:37:04 +00:00
Improve OMF feature docs
2021-06-15 15:57:00 +00:00
<p>Before you can examine or convert a file, you must first extract
it from the Apple II disk image, using a mode that does not modify the
original (e.g. extract with "configure to preserve Apple II formats"
in CiderPress). Then, open it with the "Tools &gt; Convert OMF".</p>
<p>The initial view shows all of the OMF segments in the file. Double-clicking
on an entry opens a detailed view that shows the segment header and a
list of all the OMF records. For load files, the relocation dictionary is
also shown.</p>
<p>To convert the file, click "Generate" to create a modified binary and a
Add two options to OMF converter First, make the per-segment comments and notes optional. Second, add an "offset segment by $0100" feature that tries to shift each segment forward 256 bytes. Doing so avoids potential ambiguity with direct page locations. The 20212-reloc-data test no longer has the per-segment comments.
2020-07-20 20:47:19 +00:00
SourceGen project file.</p>
<p>If "offset segment start by $0100" is checked, the converter will try
to shift the segment's load address from <code>$xx/0000</code> to
<code>$xx/0100</code>. This can make the generated code a little nicer
to work with because it removes potential ambiguity with direct page
addresses. For example, <code>LDA $56</code> and <code>LDA $0056</code>
may be interpreted as the same thing by the assembler, requiring
generation of operand width disambiguators. By shifting the initial
address we avoid the potential ambiguity.</p>
<p>Check "add comments and notes for each segment" to add a long comment
and a note at the start of each segment. The comments include the
segment name, type, and optional flags. The notes just provide a quick
way to jump to a segment.</p>
Fix bank for AbsInd and AbsIndLong addressing The Absolute Indirect and Absolute Indirect Long addressing modes (e.g. "JMP (addr)" and "JMP [addr]") are 16-bit values in bank 0. The code analyzer was placing them in the program bank, which meant the wrong symbol was being used. Also, tweak some docs.
2020-07-04 22:03:23 +00:00
<p>The binary generated by the tool is not in OMF format and will not
Improve OMF feature docs
2021-06-15 15:57:00 +00:00
execute on an Apple IIgs. To be functional, the generated sources must be
Fix bank for AbsInd and AbsIndLong addressing The Absolute Indirect and Absolute Indirect Long addressing modes (e.g. "JMP (addr)" and "JMP [addr]") are 16-bit values in bank 0. The code analyzer was placing them in the program bank, which meant the wrong symbol was being used. Also, tweak some docs.
2020-07-04 22:03:23 +00:00
assembled by a program capable of generating OMF output, such as Merlin.</p>
Data Bank Register management, part 5 Update documentation. Add some information about OMF relocation data as well. Fix bug in B=K handling.
2020-07-10 20:29:36 +00:00
<p>The <a href="advanced.html#reloc-data">relocation dictionaries</a> from
the executable are included in the project file, and can be used to guide
the disassembler's analysis. The "use reloc data" setting in the project
properties controls this feature.</p>
Fix bank for AbsInd and AbsIndLong addressing The Absolute Indirect and Absolute Indirect Long addressing modes (e.g. "JMP (addr)" and "JMP [addr]") are 16-bit values in bank 0. The code analyzer was placing them in the program bank, which meant the wrong symbol was being used. Also, tweak some docs.
2020-07-04 22:03:23 +00:00
<p>A full explanation of the structure of OMF is beyond the scope of this
manual. For more information on OMF, see Appendix F of the GS/OS Reference
Manual.</p>
Use relocation data to format instruction operands This was a relatively lightweight change to confirm the usefulness of relocation data. The results were very positive. The relatively superficial integration of the data into the data analysis process causes some problems, e.g. the cross-reference table entries show an offset because the code analyzer's computed operand offset doesn't match the value of the label. The feature should be considered experimental The feature can be enabled or disabled with a project property. The results were sufficiently useful and non-annoying to make the setting enabled by default.
2020-07-04 00:37:04 +00:00
Initial file commit
2018-09-28 17:05:11 +00:00
</div>
Clean up HTML in manual
2018-10-09 17:04:10 +00:00
<div id="footer">
Initial file commit
2018-09-28 17:05:11 +00:00
<p><a href="index.html">Back to index</a></p>
</div>
</body>
<!-- Copyright 2018 faddenSoft -->
</html>
Reference in New Issue Copy Permalink