1
0
mirror of https://github.com/fadden/6502bench.git synced 2024-05-31 22:41:37 +00:00
6502bench/Asm65/Helper.cs
Andy McFadden cd23580cc5 Add junk/align directives
Sometimes there's a bunch of junk in the binary that isn't used for
anything.  Often it's there to make things line up at the start of
a page boundary.

This adds a ".junk" directive that tells the disassembler that it
can safely disregard the contents of a region.  If the region ends
on a power-of-two boundary, an alignment value can be specified.

The assembly source generators will output an alignment directive
when possible, a .fill directive when appropriate, and a .dense
directive when all else fails.  Because we're required to regenerate
the original data file, it's not always possible to avoid generating
a hex dump.
2019-10-18 21:00:28 -07:00

81 lines
3.3 KiB
C#

/*
* Copyright 2018 faddenSoft
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
using System;
using System.Diagnostics;
namespace Asm65 {
/// <summary>
/// Small utility functions.
/// </summary>
public static class Helper {
/// <summary>
/// Computes the target address of an 8-bit relative branch instruction.
/// </summary>
/// <param name="addr">24-bit address of branch instruction opcode.</param>
/// <param name="branchOffset">Branch operand.</param>
/// <returns>Target address.</returns>
public static int RelOffset8(int addr, sbyte branchOffset) {
// Branch is relative to the start of the following instruction, so add 2.
// Branches wrap around the current bank (in both directions), and the target
// is in the same bank as source addr.
Debug.Assert(addr >= 0 && addr <= 0xffffff);
int target = (addr + 2 + branchOffset) & 0xffff;
target |= addr & 0x7fff0000;
return target;
}
/// <summary>
/// Computes the target address of a 16-bit relative branch instruction.
/// </summary>
/// <param name="addr">24-bit address of branch instruction opcode.</param>
/// <param name="branchOffset">Branch operand.</param>
/// <returns>Target address.</returns>
public static int RelOffset16(int addr, short branchOffset) {
// Branch is relative to the start of the following instruction, so add 3.
// Branches wrap around the current bank (in both directions), and the target
// is in the same bank as source addr.
Debug.Assert(addr >= 0 && addr <= 0xffffff);
int target = (addr + 3 + branchOffset) & 0xffff;
target |= addr & 0x7fff0000;
return target;
}
/// <summary>
/// Determines whether a range of bytes is composed of a single value. If so, the
/// value is returned.
/// </summary>
/// <param name="data">Bytes to examine.</param>
/// <param name="offset">Start offset.</param>
/// <param name="length">Number of bytes. Must be greater than zero.</param>
/// <returns>The value found, or -1 if multiple values were found.</returns>
public static int CheckRangeHoldsSingleValue(byte[] data, int offset, int length) {
Debug.Assert(data != null);
Debug.Assert(offset >= 0 && offset < data.Length);
Debug.Assert(length >= 0 && offset + length <= data.Length);
if (length < 0) {
return -1;
}
byte testVal = data[offset++];
while (--length > 0) {
if (data[offset++] != testVal) {
return -1;
}
}
return testVal;
}
}
}