mirror of
https://github.com/fadden/6502bench.git
synced 2024-11-04 15:05:03 +00:00
7c5a0dfdb8
A bit of Javascript was used to remove the hamburger icon when a page doesn't have a #sidenav. This worked when sidenav-incl was being loaded with jQuery load(), because that mechanism works asynchronously, and #sidenav was part of the DOM before it ran. Once we started merging HTML fragments directly into the pages, the script got called before #sidenav was defined, so the icon was always being removed. One solution would be to move the script to footer-incl.html, to follow the preferred practice of placing scripts at the bottom of the <body>. The better solution was to move the "no-sidenav" class from #main to <body>, so that all components can see it. This lets us use CSS rules to hide the icon.
204 lines
9.2 KiB
HTML
204 lines
9.2 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8"/>
|
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
|
|
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js"
|
|
integrity="sha384-vtXRMe3mGCbOeY7l30aIg8H9p3GdeSe4IFlP6G8JMa7o7lXvnz3GFKzPxzJdPfGK" crossorigin="anonymous"></script>
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"/>
|
|
<link rel="stylesheet" href="/main.css"/>
|
|
|
|
<style>
|
|
img {
|
|
/* add a border so image thumbnails look clickable */
|
|
border: 2px solid;
|
|
}
|
|
</style>
|
|
|
|
<title>6502bench Tools</title>
|
|
</head>
|
|
|
|
<body class="no-sidenav">
|
|
|
|
<div id="masthead">
|
|
<!-- START: /masthead-incl.html -->
|
|
<!--<div class="masthead-title" style="background-image: url('images/screenshot-mainwin.png');">-->
|
|
<div class="masthead-title">
|
|
6502bench
|
|
</div>
|
|
<!-- END: /masthead-incl.html -->
|
|
</div>
|
|
|
|
<div id="topnav">
|
|
<!-- START: /topnav-incl.html active:#topnav-home -->
|
|
<!-- top navigation bar contents -->
|
|
<nav>
|
|
<a id="topnav-home" class="active" href="/">HOME</a>
|
|
<a id="topnav-sgtutorial" href="/sgtutorial">SourceGen Tutorial</a>
|
|
<a id="topnav-menuicon" href="javascript:void(0);" class="icon" onclick="toggleSidenav()">
|
|
<i class="fa fa-bars"></i>
|
|
</a>
|
|
</nav>
|
|
<script>
|
|
// Sidenav toggle function.
|
|
//
|
|
// Use a jQuery function to toggle the sidenav bar. The initial state
|
|
// is undefined / inherited, so it will pop in and out as the screen
|
|
// resizes around the "large" breakpoint.
|
|
function toggleSidenav() {
|
|
$("#sidenav").toggle("fast");
|
|
}
|
|
</script>
|
|
<!-- END: /topnav-incl.html -->
|
|
</div>
|
|
|
|
<div id="main">
|
|
|
|
<p>6502bench is a code development "workbench" for the 65xx family
|
|
of processors, including the 6502, 65C02, and 65802/65816. It currently
|
|
features one tool, the SourceGen disassembler.</p>
|
|
|
|
<p><strong>SourceGen</strong> is an industrial-strength disassembler for 6502,
|
|
65C02, and 65816 programs. It runs on Windows 7 or later.</p>
|
|
|
|
<p>Demos and information:</p>
|
|
<ul>
|
|
<li>Watch a 9-minute
|
|
<a href="https://youtu.be/dalISyBPQq8">product introduction video</a> (from v1.0).</li>
|
|
<li>See an 8-minute
|
|
<a href="https://youtu.be/lSvEr5nCHbY">demonstration of visualizers</a>
|
|
in a disassembly of the Apple II game <i>Space Eggs</i>.</li>
|
|
<li>SourceGen has been used to disassemble software for the Apple II,
|
|
NES (Nintendo Entertainment System), Atari 2600 VCS, and coin-op arcade
|
|
systems. Visit 6502disassembly.com to see examples of
|
|
<a href="https://6502disassembly.com/">completed disassembly projects</a>.</li>
|
|
</ul>
|
|
|
|
<p>Check out the
|
|
<a href="https://github.com/fadden/6502bench/">GitHub project</a>,
|
|
where you can download source & binaries for the latest version from the
|
|
<a href="https://github.com/fadden/6502bench/releases/">Releases page</a>.
|
|
</p>
|
|
|
|
<p>Key features include:</p>
|
|
<ul>
|
|
<li>Fully interactive point-and-click GUI. Define labels, set addresses,
|
|
add comments, and see the results immediately. Add multi-line comments
|
|
and have them word-wrapped automatically. Create inline visualizations of
|
|
embedded bitmaps and wireframe data, and define animated sequences.</li>
|
|
<li>Sophisticated static analysis. The disassembly engine traces code
|
|
execution, automatically finding all instructions reachable from a given
|
|
starting point. Changes to the processor status flags are tracked,
|
|
allowing identification of branches that are always/never taken,
|
|
accurate cycle count listings, and easier analysis of 65816 code with
|
|
variable-width registers.</li>
|
|
<li>Easy generation of assembly source code in popular formats (currently
|
|
64tass, ACME, cc65, and Merlin 32). Cross-assemblers can be invoked from the GUI to
|
|
verify correctness.</li>
|
|
<li>Symbols and constants are provided for ROM and operating system entry
|
|
points on several popular systems (Apple, Atari, Commodore, others).</li>
|
|
<li>Project files are designed for sharing and collaboration.</li>
|
|
</ul>
|
|
|
|
<p>
|
|
<a href="images/screenshot-15-mainwin.png"><img src="images/screenshot-15-mainwin-small.png" alt="Main Window Screenshot" width="320" height="180"/></a>
|
|
<a href="images/screenshot-15-asmwin.png"><img src="images/screenshot-15-asmwin-small.png" alt="Gen/Asm Dialog Screenshot" width="320" height="180"/></a>
|
|
<a href="images/screenshot-15-vis.png"><img src="images/screenshot-15-vis-small.png" alt="Gen/Asm Dialog Screenshot" width="320" height="180"/></a>
|
|
</p>
|
|
|
|
<h4>Features in Detail:</h4>
|
|
<ul>
|
|
<li>Analyzer:
|
|
<ul>
|
|
<li>Support for 6502, 65C02, and 65816, including undocumented
|
|
opcodes and the W65C02 extensions.</li>
|
|
<li>Code tagging mechanism allows manual identification of code start/stop
|
|
points and inline data.</li>
|
|
<li>Editable labels are generated for every branch destination and data
|
|
target.</li>
|
|
<li>Automatic detection and classification of character strings and runs
|
|
of identical bytes.</li>
|
|
<li>Symbol files for ROM entry points, operating system constants, and
|
|
other platform-specific data are stored in plain text files loaded at runtime.</li>
|
|
<li>Extension scripts can be defined that automatically reformat code and
|
|
identify inline data that follows a JSR, JSL, or BRK.</li>
|
|
</ul></li>
|
|
<li>User interface:
|
|
<ul>
|
|
<li>"Infinite" undo/redo of all operations.</li>
|
|
<li>Cross-reference tables are generated for every branch and data target
|
|
address, as well as for external platform symbols.</li>
|
|
<li>Instruction operand formats (hex, decimal, binary, character, symbol) can
|
|
be set for individual instructions. References to nearby symbols are
|
|
offset, allowing simple expressions like "addr + 1".</li>
|
|
<li>Data areas can be formatted in various formats, including individual
|
|
bytes, 16-bit and 24-bit words, addresses, or strings.
|
|
Multiple character encodings are supported, including ASCII, high ASCII,
|
|
C64 PETSCII, and C64 screen codes.</li>
|
|
<li>Zero-page variables can be given different labels at different points
|
|
in the program.</li>
|
|
<li>Multi-line comments can be "boxed" for an authentic retro feel.</li>
|
|
<li>Notes can be added that aren't included in generated output. These
|
|
also function as color-coded bookmarks. Very useful for marking up a
|
|
work in progress. Similarly, symbols can be marked as uncertain by
|
|
adding a '?' that is automatically stripped away during code generation.</li>
|
|
<li>Instruction reference data, such as CPU cycles and flags modified, are
|
|
shown along with a description of the opcode's function. Very useful when
|
|
encountering rarely-used undocumented instructions.</li>
|
|
<li>Various aspects of the code display can be reconfigured, including
|
|
upper/lower case, pseudo-opcode naming, and expression formats. These
|
|
choices are not part of the project definition, so everyone can view a
|
|
project according to their own personal preferences.</li>
|
|
</ul></li>
|
|
<li>Code generation:
|
|
<ul>
|
|
<li>Labels can be global or local. Use non-unique labels like "@Loop"
|
|
for clarity. Labels will be promoted from local to global or renamed to
|
|
be unique as required by each assembler.</li>
|
|
<li>Symbols may be exported from one project and imported into another
|
|
to facilitate multi-binary disassembly.</li>
|
|
<li>Listings can be generated in HTML form for publication on the web. Many
|
|
aspects of the output format can be configured. Inline visualizations
|
|
are exported as GIF or animated GIF.</li>
|
|
</ul></li>
|
|
<li>Miscellaneous:
|
|
<ul>
|
|
<li>All project data is stored in text formats (primarily JSON).</li>
|
|
<li>The project file includes nothing from the data file but a CRC. This
|
|
may allow the project to be shared without violating copyrights (subject
|
|
to local laws).</li>
|
|
<li>Handy tools: file slicer, file concatenator, CPU instruction reference
|
|
chart, ASCII chart, file hex dump.</li>
|
|
<li>The OMF converter tool can be used to disassemble Apple IIgs executables.</li>
|
|
</ul></li>
|
|
</ul>
|
|
|
|
<h4>Open Source</h4>
|
|
|
|
<p>6502bench is written in C# .NET, using the (free to download) Visual
|
|
Studio Community 2019 IDE as the primary development environment.
|
|
The user interface uses the Windows Presentation Foundation (WPF) API.
|
|
6502bench is an open-source project, licensed under Apache 2.0.
|
|
The full source code is available on
|
|
<a href="https://github.com/fadden/6502bench/">GitHub</a>.</p>
|
|
|
|
</div>
|
|
|
|
<div id="footer">
|
|
<!-- START: /footer-incl.html -->
|
|
<hr/>
|
|
<p>Copyright 2021 faddenSoft</p>
|
|
<!-- <p id="screen-size"></p>
|
|
<script>
|
|
var w = window.innerWidth;
|
|
var h = window.innerHeight;
|
|
var x = document.getElementById("screen-size");
|
|
x.innerHTML = "DEBUG: initial window size " + w + "x" + h;
|
|
</script> -->
|
|
<!-- END: /footer-incl.html -->
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|