Cosmos/source/Cosmos.Core/IOPort.cs

using System;
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.

        public readonly UInt16 Port;

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

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

        //TODO: Reads and writes can use this to get port instead of argument
        [PlugMethod(PlugRequired = true)]
        static protected void Write8(UInt16 aPort, byte aData) {
        } // Plugged

        [PlugMethod(PlugRequired = true)]
        static protected void Write16(UInt16 aPort, UInt16 aData) {
        } // Plugged

        [PlugMethod(PlugRequired = true)]
        static protected void Write32(UInt16 aPort, UInt32 aData) {
        } // Plugged

        [PlugMethod(PlugRequired = true)]
        static protected byte Read8(UInt16 aPort) {
            return 0;
        } // Plugged

        [PlugMethod(PlugRequired = true)]
        static protected UInt16 Read16(UInt16 aPort) {
            return 0;
        } // Plugged

        [PlugMethod(PlugRequired = true)]
        static protected UInt32 Read32(UInt16 aPort) {
            return 0;
        } // Plugged

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

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

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

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

        public IOPort(UInt16 aBase, UInt16 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 {
                return Read8(Port);
            }
            set {
                Write8(Port, value);
            }
        }

        public UInt16 Word {
            get {
                return Read16(Port);
            }
            set {
                Write16(Port, value);
            }
        }

        public UInt32 DWord {
            get {
                return 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(UInt16 aPort) : base(aPort) {
        }

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

        public byte Byte {
            get {
                return Read8(Port);
            }
        }

        public UInt16 Word {
            get {
                return Read16(Port);
            }
        }

        public UInt32 DWord {
            get {
                return Read32(Port);
            }
        }
    }

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

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

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

        public UInt16 Word {
            set {
                Write16(Port, value);
            }
        }

        public UInt32 DWord {
            set {
                Write32(Port, value);
            }
        }
    }
}