src/main/java/com/loomcom/symon/devices/Device.java

/*
 * Copyright (c) 2016 Seth J. Morabito <web@loomcom.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining
 * a copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

package com.loomcom.symon.devices;

import com.loomcom.symon.Bus;
import com.loomcom.symon.MemoryRange;
import li.cil.oc.api.machine.Signal;
import net.minecraft.nbt.NBTTagCompound;

/**
 * A memory-mapped IO Device.
 */

public abstract class Device implements Comparable<Device> {

	/**
	 * Size of the device in memory
	 */
	int size;

	/**
	 * The memory range for this device.
	 */
	private MemoryRange memoryRange;

	/**
	 * The name of the device.
	 */
	private String name;

	/**
	 * Short name for debugging.
	 */
	private String shortname;

	/**
	 * Reference to the bus where this Device is attached.
	 */
	private Bus bus;

	public Device(int startAddress, int deviceLength, String name) {
		this.memoryRange = new MemoryRange(startAddress, startAddress + deviceLength - 1);
		this.size = deviceLength;
		this.name = name;
		this.shortname = name.replaceAll("\\s+", "");
	}

	/* Methods required to be implemented by inheriting classes. */
	public abstract int read(int address);

	public abstract void write(int address, int data);

	@Override
	public String toString() {
		return String.format("%s@$%04X", shortname, memoryRange.startAddress());
	}

	public Bus getBus() {
		return this.bus;
	}

	public void setBus(Bus bus) {
		this.bus = bus;
	}

	public MemoryRange getMemoryRange() {
		return memoryRange;
	}

	public int endAddress() {
		return memoryRange.endAddress();
	}

	public int startAddress() {
		return memoryRange.startAddress();
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
		this.shortname = name.replaceAll("\\s+", "");
	}

	public int getSize() {
		return size;
	}

	public void onSignal(Signal signal) {
	}

	public void load(NBTTagCompound nbt) {
	}

	public void save(NBTTagCompound nbt) {
	}

	/**
	 * Compares two devices.  The sort order is defined by the sort
	 * order of the device's memory ranges.
	 */
	@Override
	public int compareTo(Device other) {
		if (other == null) {
			throw new NullPointerException("Cannot compare to null.");
		}
		if (this == other) {
			return 0;
		}
		return getMemoryRange().compareTo(other.getMemoryRange());
	}
}