Cosmos/source/Cosmos.Core/IOPort.cs

using IL2CPU.API.Attribs;

namespace Cosmos.Core
{
    public abstract class IOPortBase
    {
        //TODO Make it that IO port classes are exclusive to each port. For example
        // only one IOPort class can be created per port number. This will prevent
        // two instances of an IOPort from using the same port.
        // A locking mechanism is not necessary as the creator can control access
        // to the instance.
        // We are not threaded yet anyways, but when we are will assume the caller
        // or owner handles any concurrency issues so as to minimize overhead in this
        // class. Or maybe some base support can be added to this class, but its functionality
        // is optional and only used by classes that need concurrency control like ATA.

        protected readonly ushort Port;

        // all ctors are internal - Only Core ring can create it.. but hardware ring can use it.
        protected IOPortBase(ushort aPort)
        {
            Port = aPort;
        }

        protected IOPortBase(ushort aBase, ushort aOffset)
        {
            // C# math promotes things to integers, so we have this constructor
            // to relieve the use from having to do so many casts
            Port = (ushort)(aBase + aOffset);
        }

        //TODO: Reads and writes can use this to get port instead of argument
        [PlugMethod(PlugRequired = true)]
        static protected void Write8(ushort aPort, byte aData) => throw null;

        [PlugMethod(PlugRequired = true)]
        static protected void Write16(ushort aPort, ushort aData) => throw null;

        [PlugMethod(PlugRequired = true)]
        static protected void Write32(ushort aPort, uint aData) => throw null;

        [PlugMethod(PlugRequired = true)]
        static protected byte Read8(ushort aPort) => throw null;

        [PlugMethod(PlugRequired = true)]
        static protected ushort Read16(ushort aPort) => throw null;

        [PlugMethod(PlugRequired = true)]
        static protected uint Read32(ushort aPort) => throw null;

        //TODO: Plug these Reads with asm to read directly to RAM
        // REP INSW
        public void Read8(byte[] aData)
        {
            for (int i = 0; i < aData.Length / 2; i++)
            {
                var xValue = Read16(Port);
                aData[i * 2] = (byte)xValue;
                aData[i * 2 + 1] = (byte)(xValue >> 8);
            }
        }

        public void Read16(ushort[] aData)
        {
            for (int i = 0; i < aData.Length; i++)
            {
                aData[i] = Read16(Port);
            }
        }

        public void Read32(uint[] aData)
        {
            for (int i = 0; i < aData.Length; i++)
            {
                aData[i] = Read32(Port);
            }
        }
    }

    public class IOPort : IOPortBase
    {
        public IOPort(ushort aPort)
            : base(aPort)
        {
        }

        public IOPort(ushort aBase, ushort aOffset)
            : base(aBase, aOffset)
        {
        }

        static public void Wait()
        {
            // Write to an unused port. This assures whatever we were waiting on for a previous
            // IO read/write has completed.
            // Port 0x80 is unused after BIOS POST.
            // 0x22 is just a random byte.
            // Since IO is slow - its just a dummy sleep to wait long enough for the previous operation
            // to have effect on the target.
            Write8(0x80, 0x22);
        }

        public byte Byte
        {
            get => Read8(Port);
            set => Write8(Port, value);
        }

        public ushort Word
        {
            get => Read16(Port);
            set => Write16(Port, value);
        }

        public uint DWord
        {
            get => Read32(Port);
            set => Write32(Port, value);
        }
    }

    // I split these instead of adding CanRead/CanWrite because this enforces
    // at build time, and its also faster at runtime. Finally it allows future optimizations better
    // than checking at runtime.
    public class IOPortRead : IOPortBase
    {
        public IOPortRead(ushort aPort)
            : base(aPort)
        {
        }

        public IOPortRead(ushort aBase, ushort aOffset)
            : base(aBase, aOffset)
        {
        }

        public byte Byte => Read8(Port);

        public ushort Word => Read16(Port);

        public uint DWord => Read32(Port);
    }

    public class IOPortWrite : IOPortBase
    {
        public IOPortWrite(ushort aPort) : base(aPort)
        {
        }

        public IOPortWrite(ushort aBase, ushort aOffset) : base(aBase, aOffset)
        {
        }

        public byte Byte
        {
            set => Write8(Port, value);
        }

        public ushort Word
        {
            set => Write16(Port, value);
        }

        public uint DWord
        {
            set => Write32(Port, value);
        }
    }
}