# MIX (abstract machine)

MIX is a hypothetical computer used in Donald Knuth's monograph, The Art of Computer Programming (TAOCP). MIX's model number is 1009, which was derived by combining the model numbers and names of several contemporaneous, commercial machines deemed significant by the author. Also, "MIX" read as a Roman numeral is 1009.
The 1960s-era MIX has since been superseded by a new (also hypothetical) computer architecture, MMIX, to be incorporated in forthcoming editions of TAOCP.
Software implementations for both the MIX and MMIX architectures have been developed by Knuth and made freely available (named "MIXware" and "MMIXware", respectively). Several derivatives of Knuth's MIX/MMIX emulators also exist. GNU MDK is one such software package; it is free and runs on a wide variety of platforms.
Their purpose for education is quite similar to John L. Hennessy's and David A. Patterson's DLX architecture, from Computer Organization and Design - The Hardware Software Interface.

## Architecture

MIX is a hybrid binary–decimal computer. When programmed in binary, each byte has 6 bits (values range from 0 to 63). In decimal, each byte has 2 decimal digits (values range from 0 to 99). Bytes are grouped into words of five bytes plus a sign. Most programs written for MIX will work in either binary or decimal, so long as they do not try to store a value greater than 63 in a single byte.
A word has the range −1,073,741,823 to 1,073,741,823 (inclusive) in binary mode, and −9,999,999,999 to 9,999,999,999 (inclusive) in decimal mode. The sign-and-magnitude representation of integers in the MIX architecture distinguishes between “−0” and “+0.” This contrasts with modern computers, whose two's-complement representation of integer quantities includes a single representation for zero, but whose range for a given number of bits includes one more negative integer than the number of representable positive integers.

### Registers

There are 9 registers in MIX:
* rA: Accumulator (full word, five bytes and a sign).
* rX: Extension (full word, five bytes and a sign).
* rI1, rI2, rI3, rI4, rI5, rI6: Index registers (two bytes and a sign).
* rJ: Jump address (two bytes, always positive).
A byte is assumed to be at least 6 bits. Most instructions can specify which of the "fields" (bytes) of a register are to be altered, using a suffix of the form (first:last). The zeroth field is the one-bit sign.
MIX also records whether the previous operation overflowed, and has a one-trit comparison indicator (less than, equal to, or greater than).

### Memory and input/output

The MIX machine has 4000 words of memory (each with 5 bytes and a sign), addressed from 0 to 3999. A variety of input and output devices are also included:
* Tape units (devices 0...7).
* Disk or drum units (devices 8...15).
* Card reader (device 16).
* Card punch (device 17).
* Line printer (device 18).
* Typewriter terminal (device 19).
* Paper tape (device 20).

### Instructions

Each machine instruction in memory occupies one word, and consists of 4 parts: the address (2 bytes and the sign of the word) in memory to read or write; an index specification (1 byte, describing which rI index register to use) to add to the address; a modification (1 byte) that specifies which parts of the register or memory location will be read or altered; and the operation code (1 byte). All operation codes have an associated mnemonic.
| $^3$$_0$ | $^2$$_9$ | $^2$$_8$ | $^2$$_7$ | $^2$$_6$ | $^2$$_5$ | $^2$$_4$ | $^2$$_3$ | $^2$$_2$ | $^2$$_1$ | $^2$$_0$ | $^1$$_9$ | $^1$$_8$ | $^1$$_7$ | $^1$$_6$ | $^1$$_5$ | $^1$$_4$ | $^1$$_3$ | $^1$$_2$ | $^1$$_1$ | $^1$$_0$ | $^0$$_9$ | $^0$$_8$ | $^0$$_7$ | $^0$$_6$ | $^0$$_5$ | $^0$$_4$ | $^0$$_3$ | $^0$$_2$ | $^0$$_1$ | $^0$$_0$ |
| ± | Address | Address | Address | Address | Address | Address | Address | Address | Address | Address | Address | Address | Index | Index | Index | Index | Index | Index | Modification | Modification | Modification | Modification | Modification | Modification | Operation | Operation | Operation | Operation | Operation | Operation |
MIX programs frequently use self-modifying code, in particular to return from a subroutine, as MIX lacks an automatic subroutine return stack. Self-modifying code is facilitated by the modification byte, allowing the program to store data to, for example, the address part of the target instruction, leaving the rest of the instruction unmodified.
MIX programs are typically constructed using the MIXAL assembly language; for an example, see the list hello world programs page.
| LDA ADDR,i(0:5) | rA := memory[ADDR + rIi]; |
| LDX ADDR,i(0:5) | rX := memory[ADDR + rIi]; |
| LD? ADDR,i(0:5) | rI? := memory[ADDR + rIi]; |
| LDAN ADDR,i(0:5) | rA := - memory[ADDR + rIi]; |
| LDXN ADDR,i(0:5) | rX := - memory[ADDR + rIi]; |
| LD?N ADDR,i(0:5) | rI? := - memory[ADDR + rIi]; |
| STA ADDR,i(0:5) | memory[ADDR + rIi] := rA; |
| STX ADDR,i(0:5) | memory[ADDR + rIi] := rX; |
| ST? ADDR,i(0:5) | memory[ADDR + rIi] := rI?; |
| STJ ADDR,i(0:5) | memory[ADDR + rIi] := rJ; |
| STZ ADDR,i(0:5) | memory[ADDR + rIi] := 0; |
| ADD ADDR,i(0:5) | rA := rA + memory[ADDR + rIi]; |
| SUB ADDR,i(0:5) | rA := rA - memory[ADDR + rIi]; |
| MUL ADDR,i(0:5) | (rA,rX) := rA * memory[ADDR + rIi]; |
| DIV ADDR,i(0:5) | rA := int( (rA,rX) / memory[ADDR + rIi] ); rX := (rA,rX) % memory[ADDR + rIi]; |
| ENTA ADDR,i | rA := ADDR + rIi; |
| ENTX ADDR,i | rX := ADDR + rIi; |
| ENT? ADDR,i | rI? := ADDR + rIi; |
| ENNA ADDR,i | rA := - ADDR - rIi; |
| ENNX ADDR,i | rX := - ADDR - rIi; |
| ENN? ADDR,i | rI? := - ADDR - rIi; |
| INCA ADDR,i | rA := rA + ADDR + rIi; |
| INCX ADDR,i | rX := rX + ADDR + rIi; |
| INC? ADDR,i | rI? := rI? + ADDR + rIi; |
| DECA ADDR,i | rA := rA - ADDR - rIi; |
| DECX ADDR,i | rX := rX - ADDR - rIi; |
| DEC? ADDR,i | rI? := rI? - ADDR - rIi; |
| CMPA ADDR,i(0:5) | compare rA with memory[ADDR + rIi] and set comparison flag; |
| CMPX ADDR,i(0:5) | compare rX with memory[ADDR + rIi] and set comparison flag; |
| CMP? ADDR,i(0:5) | compare rI? with memory[ADDR + rIi] and set comparison flag; |
| JMP ADDR,i | rJ := address of next instruction; goto ADDR + rIi; |
| JSJ ADDR,i | goto ADDR + rIi; |
| JOV ADDR,i | if (overflow) then overflow := false; goto ADDR + rIi; |
| JNOV ADDR,i | if (no overflow) then goto ADDR + rIi; else overflow := false; |
| JL, JE, JG ADDR,i JGE, JNE, JLE ADDR,i | if (less, equal, greater) then goto ADDR + rIi; if (no less, unequal, no greater) then goto ADDR + rIi; |
| JAN/JAZ/JAP ADDR,i JANN/JANZ/JANP ADDR,i | if (rA<0 or rA==0 or rA>0) then goto ADDR + rIi; if (rA>=0 or rA!=0 or rA<=0) then goto ADDR + rIi; |
| JXN/JXZ/JXP ADDR,i JXNN/JXNZ/JXNP ADDR,i | if (rX<0 or rX==0 or rX>0) then goto ADDR + rIi; if (rX>=0 or rX!=0 or rX<=0) then goto ADDR + rIi; |
| J?N/J?Z/J?P ADDR,i J?NN/J?NZ/J?NP ADDR,i | if (rI?<0 or rI?==0 or rI?>0) then goto ADDR + rIi; if (rI?>=0 or rI?!=0 or rI?<=0) then goto ADDR + rIi; |
| MOVE ADDR,i(F) | for (n = 0; n < F; n++, rI1++) memory[rI1] := memory[ADDR+rIi+n]; |
| SLA/SRA ADDR,i SLAX/SRAX ADDR,i SLC/SRC ADDR,i | shift rA to the left/right by ADDR+rIi bytes shift (rA,rX) to the left/right by ADDR+rIi bytes rotate (rA,rX) to the left/right by ADDR+rIi bytes |
| NOP | do nothing; |
| HLT | halt execution; |
| IN ADDR,i(F) | read in one block from input unit F into memory[ADDR + rIi] onwards; |
| OUT ADDR,i(F) | output one block to unit F from memory[ADDR + rIi] onwards; |
| IOC ADDR,i(F) | send control instruction to i/o unit F; |
| JRED ADDR,i(F) | if (i/o unit F is ready) then goto ADDR + rIi; |
| JBUS ADDR,i(F) | if (i/o unit F is busy) then goto ADDR + rIi; |
| NUM | rA := numerical value of characters in (rA,rX); |
| CHAR | (rA,rX) := character codes representing value of rA; |

## Implementations

MIX has been implemented in software by:
* Knuth's MIXWare and the derived GNU MDK;
* 9front's mix(1); and
* Hardware::Simulator::MIX on CPAN.
An implementation of MIX was created for the iCE40HX8K FPGA board in 2021.