blob: 2640a1f537ee365c7d49da9ea038b96f56bbebdc [file] [log] [blame] [raw]
/* 3b2_cpu.h: AT&T 3B2 Model 400 CPU (WE32100) Header
Copyright (c) 2017, Seth J. Morabito
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.
Except as contained in this notice, the name of the author shall
not be used in advertising or otherwise to promote the sale, use or
other dealings in this Software without prior written authorization
from the author.
*/
#ifndef _3B2_CPU_H_
#define _3B2_CPU_H_
#include "3b2_defs.h"
#include "3b2_io.h"
/* Execution Modes */
#define EX_LVL_KERN 0
#define EX_LVL_EXEC 1
#define EX_LVL_SUPR 2
#define EX_LVL_USER 3
/* Processor Version Number */
#define WE32100_VER 0x1A
/*
*
* Mode Syntax Mode Reg. Bytes Notes
* ----------------------------------------------------------------------
* Absolute $expr 7 15 5
* Abs. Deferred *$expr 14 15 5
* Byte Disp. expr(%rn) 12 0-10,12-15 2
* Byte Disp. Def. *expr(%rn) 13 0-10,12-15 2
* Halfword Disp. expr(%rn) 10 0-10,12-15 3
* Halfword Disp. Def. *expr(%rn) 11 0-10,12-15 3
* Word Disp. expr(%rn) 8 0-10,12-15 5
* Word Disp. Def. *expr(%rn) 9 0-10,12-15 5
* AP Short Offset so(%ap) 7 0-14 1 1
* FP Short Offset so(%fp) 6 0-14 1 1
* Byte Immediate &imm8 6 15 2 2,3
* Halfword Immediate &imm16 5 15 3 2,3
* Word Immediate &imm32 4 15 5 2,3
* Positive Literal &lit 0-3 0-15 1 2,3
* Negative Literal &lit 15 0-15 1 2,3
* Register %rn 4 0-14 1 1,3
* Register Deferred (%rn) 5 0-10,12-14 1 1
* Expanded Op. Type {type}opnd 14 0-14 2-6 4
*
* Notes:
*
* 1. Mode field has special meaning if register field is 15; see
* absolute or immediate mode.
* 2. Mode may not be used for a destination operand.
* 3. Mode may not be used if the instruction takes effective address
* of the operand.
* 4. 'type' overrides instruction type; 'type' determines the operand
* type, except that it does not determine the length for immediate
* or literals or whether literals are signed or unsigned. 'opnd'
* determines actual address mode. For total bytes, add 1 to byte
* count for address mode determined by 'opnd'.
*
*/
/*
* Opcodes
*/
typedef enum {
HALT = 0x00, /* Undocumented instruction */
SPOPRD = 0x02,
SPOPD2 = 0x03,
MOVAW = 0x04,
SPOPRT = 0x06,
SPOPT2 = 0x07,
RET = 0x08,
MOVTRW = 0x0C,
SAVE = 0x10,
SPOPWD = 0x13,
EXTOP = 0x14,
SPOPWT = 0x17,
RESTORE = 0x18,
SWAPWI = 0x1C,
SWAPHI = 0x1E,
SWAPBI = 0x1F,
POPW = 0x20,
SPOPRS = 0x22,
SPOPS2 = 0x23,
JMP = 0x24,
CFLUSH = 0x27,
TSTW = 0x28,
TSTH = 0x2A,
TSTB = 0x2B,
CALL = 0x2C,
BPT = 0x2E,
WAIT = 0x2F,
EMB = 0x30, // Multi-byte
SPOP = 0x32,
SPOPWS = 0x33,
JSB = 0x34,
BSBH = 0x36,
BSBB = 0x37,
BITW = 0x38,
BITH = 0x3A,
BITB = 0x3B,
CMPW = 0x3C,
CMPH = 0x3E,
CMPB = 0x3F,
RGEQ = 0x40,
BGEH = 0x42,
BGEB = 0x43,
RGTR = 0x44,
BGH = 0x46,
BGB = 0x47,
RLSS = 0x48,
BLH = 0x4A,
BLB = 0x4B,
RLEQ = 0x4C,
BLEH = 0x4E,
BLEB = 0x4F,
RGEQU = 0x50,
BGEUH = 0x52, // Also BCCH
BGEUB = 0x53, // Also BCCB
RGTRU = 0x54,
BGUH = 0x56,
BGUB = 0x57,
BLSSU = 0x58, // Also BCS
BLUH = 0x5A, // Also BCSH
BLUB = 0x5B, // Also BCSB
RLEQU = 0x5C,
BLEUH = 0x5E,
BLEUB = 0x5F,
RVC = 0x60,
BVCH = 0x62,
BVCB = 0x63,
RNEQU = 0x64,
BNEH_D = 0x66, // Duplicate of 0x76
BNEB_D = 0x67, // Duplicate of 0x77
RVS = 0x68,
BVSH = 0x6A,
BVSB = 0x6B,
REQLU = 0x6C,
BEH_D = 0x6E, // Duplicate of 0x7E
BEB_D = 0x6F, // Duplicate of 0x7F
NOP = 0x70,
NOP3 = 0x72,
NOP2 = 0x73,
BNEQ = 0x74,
RNEQ = 0x74,
BNEH = 0x76,
BNEB = 0x77,
RSB = 0x78,
BRH = 0x7A,
BRB = 0x7B,
REQL = 0x7C,
BEH = 0x7E,
BEB = 0x7F,
CLRW = 0x80,
CLRH = 0x82,
CLRB = 0x83,
MOVW = 0x84, /* done */
MOVH = 0x86, /* done */
MOVB = 0x87, /* done */
MCOMW = 0x88,
MCOMH = 0x8A,
MCOMB = 0x8B,
MNEGW = 0x8C,
MNEGH = 0x8E,
MNEGB = 0x8F,
INCW = 0x90,
INCH = 0x92,
INCB = 0x93,
DECW = 0x94,
DECH = 0x96,
DECB = 0x97,
ADDW2 = 0x9C,
ADDH2 = 0x9E,
ADDB2 = 0x9F,
PUSHW = 0xA0,
MODW2 = 0xA4,
MODH2 = 0xA6,
MODB2 = 0xA7,
MULW2 = 0xA8,
MULH2 = 0xAA,
MULB2 = 0xAB,
DIVW2 = 0xAC,
DIVH2 = 0xAE,
DIVB2 = 0xAF,
ORW2 = 0xB0,
ORH2 = 0xB2,
ORB2 = 0xB3,
XORW2 = 0xB4,
XORH2 = 0xB6,
XORB2 = 0xB7,
ANDW2 = 0xB8,
ANDH2 = 0xBA,
ANDB2 = 0xBB,
SUBW2 = 0xBC,
SUBH2 = 0xBE,
SUBB2 = 0xBF,
ALSW3 = 0xC0,
ARSW3 = 0xC4,
ARSH3 = 0xC6,
ARSB3 = 0xC7,
INSFW = 0xC8,
INSFH = 0xCA,
INSFB = 0xCB,
EXTFW = 0xCC,
EXTFH = 0xCE,
EXTFB = 0xCF,
LLSW3 = 0xD0,
LLSH3 = 0xD2,
LLSB3 = 0xD3,
LRSW3 = 0xD4,
ROTW = 0xD8,
ADDW3 = 0xDC,
ADDH3 = 0xDE,
ADDB3 = 0xDF,
PUSHAW = 0xE0,
MODW3 = 0xE4,
MODH3 = 0xE6,
MODB3 = 0xE7,
MULW3 = 0xE8,
MULH3 = 0xEA,
MULB3 = 0xEB,
DIVW3 = 0xEC,
DIVH3 = 0xEE,
DIVB3 = 0xEF,
ORW3 = 0xF0,
ORH3 = 0xF2,
ORB3 = 0xF3,
XORW3 = 0xF4,
XORH3 = 0xF6,
XORB3 = 0xF7,
ANDW3 = 0xF8,
ANDH3 = 0xFA,
ANDB3 = 0xFB,
SUBW3 = 0xFC,
SUBH3 = 0xFE,
SUBB3 = 0xFF,
MVERNO = 0x3009,
ENBVJMP = 0x300d,
DISVJMP = 0x3013,
MOVBLW = 0x3019,
STREND = 0x301f,
INTACK = 0x302f,
STRCPY = 0x3035,
RETG = 0x3045,
GATE = 0x3061,
CALLPS = 0x30ac,
RETPS = 0x30c8
} opcode;
typedef enum {
DECODE_SUCCESS,
DECODE_ERROR
} decode_result;
/* Addressing Mode enum */
typedef enum {
ABS, // Absolute
ABS_DEF, // Absolute Deferred
BYTE_DISP, // Byte Displacement
BYTE_DISP_DEF, // Byte Displacement Deferred
HFWD_DISP, // Halfword Displacement
HFWD_DISP_DEF, // Halfword Displacement Deferred
WORD_DISP, // Word Displacement
WORD_DISP_DEF, // Word Displacement Deferred
AP_SHORT_OFF, // AP Short Offset
FP_SHORT_OFF, // FP Short Offset
BYTE_IMM, // Byte Immediate
HFWD_IMM, // Halfword Immediate
WORD_IMM, // Word Immediate
POS_LIT, // Positive Literal
NEG_LIT, // Negative Literal
REGISTER, // Register
REGISTER_DEF, // Register Deferred
EXP // Expanded-operand type
} addr_mode;
/*
* Each instruction expects operands of a certain type.
*
* The large majority of instructions expect operands that have a
* descriptor as the first byte. This descriptor carries all the
* information necessary to compute the addressing mode of the
* operand.
*
* e.g.:
*
* MOVB 6(%r1),%r0
* +------+------+------+------+
* | 0x87 | 0xc1 | 0x06 | 0x40 |
* +------+------+------+------+
* ^^^^^^
* Descriptor byte. mode = 13 (0x0c), register = 1 (0x01)
*
*
* Branch instructions have either an 8-bit or a 16-bit signed
* displacement value, and lack a descriptor byte.
*
* e.g.:
*
* BCCB 0x03
* +------+------+
* | 0x53 | 0x03 | 8-bit displacement
* +------+------+
*
* BCCH 0x01ff
* +------+------+------+
* | 0x52 | 0xff | 0x01 | 16-bit displacement
* +------+------+------+
*
*
* TODO: Describe coprocessor instructions
*
*/
typedef enum {
OP_NONE, /* NULL type */
OP_DESC, /* Descriptor byte */
OP_BYTE, /* 8-bit signed value */
OP_HALF, /* 16-bit signed value */
OP_COPR /* Coprocessor instruction */
} op_mode;
/* Describes a mnemonic */
typedef struct _mnemonic {
uint16 opcode;
int8 op_count; /* Number of operands */
op_mode mode; /* Dispatch mode */
int8 dtype; /* Default data type */
char mnemonic[8];
int8 src_op1;
int8 src_op2;
int8 src_op3;
int8 dst_op;
} mnemonic;
/*
* Structure that describes each operand in a decoded instruction
*/
typedef struct _operand {
uint8 mode; /* Embedded data addressing mode */
uint8 reg; /* Operand register (0-15) */
int8 dtype; /* Default type for the operand */
int8 etype; /* Expanded type (-1 if none) */
union {
uint32 w;
uint16 h;
uint8 b;
} embedded; /* Data consumed as part of the instruction
stream, i.e. literals, displacement,
etc. */
uint32 data; /* Data either read or written during
instruction execution */
} operand;
/*
* An inst is a combination of a decoded instruction and
* 0 to 4 operands. Also used for history record keeping.
*/
typedef struct _instr {
mnemonic *mn;
uint32 psw;
uint32 sp;
uint32 pc;
t_bool valid;
operand operands[4];
} instr;
/* Function prototypes */
t_stat cpu_svc(UNIT *uptr);
t_stat cpu_ex(t_value *vptr, t_addr addr, UNIT *uptr, int32 sw);
t_stat cpu_dep(t_value val, t_addr addr, UNIT *uptr, int32 sw);
t_stat cpu_reset(DEVICE *dptr);
t_stat cpu_set_size(UNIT *uptr, int32 val, CONST char *cptr, void *desc);
t_stat cpu_set_hist(UNIT *uptr, int32 val, CONST char *cptr, void *desc);
t_stat cpu_show_hist(FILE *st, UNIT *uptr, int32 val, CONST void *desc);
t_stat cpu_set_halt(UNIT *uptr, int32 val, char *cptr, void *desc);
t_stat cpu_clear_halt(UNIT *uptr, int32 val, char *cptr, void *desc);
t_stat cpu_boot(int32 unit_num, DEVICE *dptr);
t_bool cpu_is_pc_a_subroutine_call (t_addr **ret_addrs);
void cpu_register_name(uint8 reg, char *buf, size_t len);
void cpu_show_operand(FILE *st, operand *op);
void fprint_sym_m(FILE *st, instr *ip);
instr *cpu_next_instruction(void);
uint8 decode_instruction(instr *instr);
t_bool cpu_on_interrupt(uint8 ipl);
static uint32 cpu_effective_address(operand * op);
static uint32 cpu_read_op(operand * op);
static void cpu_write_op(operand * op, t_uint64 val);
static void cpu_set_nz_flags(t_uint64 data, operand * op);
static SIM_INLINE uint8 cpu_ipl();
static SIM_INLINE void cpu_on_normal_exception(uint8 isc);
static SIM_INLINE void cpu_on_stack_exception(uint8 isc);
static SIM_INLINE void cpu_on_process_exception(uint8 isc);
static SIM_INLINE void cpu_on_reset_exception(uint8 isc);
static SIM_INLINE void cpu_perform_gate(uint32 index1, uint32 index2);
static SIM_INLINE t_bool mem_exception();
static SIM_INLINE void clear_exceptions();
static SIM_INLINE void set_psw_tm(t_bool val);
static SIM_INLINE void clear_instruction(instr *inst);
static SIM_INLINE int8 op_type(operand *op);
static SIM_INLINE t_bool op_signed(operand *op);
static SIM_INLINE t_bool is_byte_immediate(operand * oper);
static SIM_INLINE t_bool is_halfword_immediate(operand * oper);
static SIM_INLINE t_bool is_word_immediate(operand * oper);
static SIM_INLINE t_bool is_positive_literal(operand * oper);
static SIM_INLINE t_bool is_negative_literal(operand * oper);
static SIM_INLINE t_bool invalid_destination(operand * oper);
static SIM_INLINE uint32 sign_extend_n(uint8 val);
static SIM_INLINE uint32 sign_extend_b(uint8 val);
static SIM_INLINE uint32 zero_extend_b(uint8 val);
static SIM_INLINE uint32 sign_extend_h(uint16 val);
static SIM_INLINE uint32 zero_extend_h(uint16 val);
static SIM_INLINE t_bool cpu_z_flag();
static SIM_INLINE t_bool cpu_n_flag();
static SIM_INLINE t_bool cpu_c_flag();
static SIM_INLINE t_bool cpu_v_flag();
static SIM_INLINE void cpu_set_z_flag(t_bool val);
static SIM_INLINE void cpu_set_n_flag(t_bool val);
static SIM_INLINE void cpu_set_c_flag(t_bool val);
static SIM_INLINE void cpu_set_v_flag(t_bool val);
static SIM_INLINE void cpu_set_v_flag_op(t_uint64 val, operand *op);
static SIM_INLINE uint8 cpu_execution_level();
static SIM_INLINE void cpu_set_execution_level(uint8 level);
static SIM_INLINE void cpu_push_word(uint32 val);
static SIM_INLINE uint32 cpu_pop_word();
static SIM_INLINE void irq_push_word(uint32 val);
static SIM_INLINE uint32 irq_pop_word();
static SIM_INLINE void cpu_context_switch_1(uint32 pcbp);
static SIM_INLINE void cpu_context_switch_2(uint32 pcbp);
static SIM_INLINE void cpu_context_switch_3(uint32 pcbp);
static SIM_INLINE t_bool op_is_psw(operand *op);
static SIM_INLINE t_bool op_is_sp(operand *op);
static SIM_INLINE uint32 cpu_next_pc();
static SIM_INLINE void add(t_uint64 a, t_uint64 b, operand *dst);
static SIM_INLINE void sub(t_uint64 a, t_uint64 b, operand *dst);
/* Helper macros */
#define MOD(A,B,OP1,OP2,SZ) { \
if (op_signed(OP1) && !op_signed(OP2)) { \
result = (SZ)(B) % (A); \
} else if (!op_signed(OP1) && op_signed(OP2)) { \
result = (B) % (SZ)(A); \
} else if (op_signed(OP1) && op_signed(OP2)) { \
result = (SZ)(B) % (SZ)(A); \
} else { \
result = (B) % (A); \
} \
}
#define DIV(A,B,OP1,OP2,SZ) { \
if (op_signed(OP1) && !op_signed(OP2)) { \
result = (SZ)(B) / (A); \
} else if (!op_signed(OP1) && op_signed(OP2)) { \
result = (B) / (SZ)(A); \
} else if (op_signed(OP1) && op_signed(OP2)) { \
result = (SZ)(B) / (SZ)(A); \
} else { \
result = (B) / (A); \
} \
}
#endif