68000 Assembly programming for the Sharp x68000

The X68000 is the Japanese exclusive PC type computer... with hardware virtually identical to the capcom CPS hardware, it has great arcade ports, to the extent that many arcade games were developed on it!

Released in 1987, it had hadrware sprites and FM sound long before the IBM PC, however it's DOS-like Human68k is easy for someone used to the PC to pick up.

The X6800 is instantly reconginsable by it's 'Twin Tower' (manhattan) design, unfortunately, its continuing popularity means it's expensive to buy, and it's power supply is prone to failure... it also needs a special keyboard and mouse - and cannot use PS2, which adds to the cost of ownership... it can however use MSX joypads!
Lets take a look at the X68000 specs!

x68000 base model
Cpu 10mhz
Ram 1MB
Vram 1MB
Resolution 768x512... 512x512... 256,256
Bitmap planes 4 @ 512x512 16 color
Max Sprites 128 sprites 16 color  (16x16 px 32 per line)
Sound chip MIDI + ADPCM

GamesX - Great source of English x68000 info
X68000 technical data book - It's in Japanese, but I've needed it many times in my programming, so what can you do?
YM2151 details - Full details on the X68000 FM sound Chip

The Xfile format
Executable files on the X68000 are in 'Xfile' format...

Vasm's linker cannot make this file, so we'll hhave to build it ourselves, fortunately it's easy to create a simple xfile

we just need to add 64 bytes to the start of our program code, &4855 ("HU" in ascii) at byte &00 and a 32 bit length in BIG ENDIAN at byte 12

it sounds strage, but our code is considered the 'Text segment'... we don't really need the other segments for our hello world type example.

The Data segment follows the code in the text segment, it's start is denoted by the '.data' command in our asm code

After our 'Data Segment' there is a 'Relocation Table'... because we don't know where our program will end up in memory, if we try to load the address of part of the data we have, we don't know where it will be...

If we use LEA (Load effective address) then we will get the correct address, however if we do not use this command, then the address our command uses will need to be corrected by the operating system, and this is what the Address relocation table does... it stores all the addresses of the code that need to be fixed with the correct address of the data as it appears after the xfile is loaded

The Symbol table is our debugging infomation, it stores the addresses of the labels in our code - we don't need it if we just want to run a program

the latest builds of VASM (since 1.8e) can output directly to XFIle with the -Fxfile switch
addr bytes value notes
$000000 2 $4855 Xfile id
$000002 2 $0000 Reserved area
$000004 4 Base Addr Linker's Base address
$000008 4 Start addr Start address from Base addr
$00000C 4 Text size Text segment size
$000010 4 Data Size Data segment size
$000014 4 Heap Size BSS+Stack
$000018 4 RelocTblSz Address Relocation Table size
$00001C 4 SymbTblSz Symbol table size
$000020 32 $00 Reserved area
$000040 TextSz
Text Segment
Offset1 DataSz
Data Segment
Offset2 RelocTblSz
Address Relocation Table
Offset3 SymbTblSz
Symbol Table


The Xfile format - broken down
We're going to use the official x68000 assembler (on an emulator) to compile an ASM file, and see the result in the binary Xfile...

The example to the right doesn't really do anything, it's just got some different contents, which should be easy to see in the resulting output.

There is a code (text) segment, a data segment, and some symbols

We'll compile it with AS, and look what happens!
The Assembler will produce this output if we use the -p option to output the listing... we've also included -d to tell it to output the symbols to the binary file.
Once we've used LK to convert the object file to a X file, we can see the result.

The binary file is shown to the right, we can see the following sections...
The Header is at the start of the file
The Code (text) segment - it's size can be seen in the header
The Data segment - it's size is also in the header
The Symbol table - it's size is also in the header.
The Relocation table has the addresses of code which needs it's addresses altering - it's size is also in the header

The Symbol table
The symbol table is made up of a series of entries in the format shown below.
Address Bytes Function
$00 2 Type (see table to right)
$02 4 value
$06 ?? Zero Terminated String (rounded to even byte)
Type Format of symbol
$0003 common rcommon rlcommon
$0200 absolute rdata rbss rstack rldata rlbss rlstack
$0201 text
$0202 data
$0203 bss
$0204 stack

Using the Sharp/Hudson x68k assembler

The X68000's assembler is pretty easy to use, in fact it may be easier than the PC ones! to compile prog.asm we just type:
    AS prog.asm
    LK prog.o
This will output an file prog.x ... which you can run from the command line

A more advanced use of AS is:
    AS -p prog.lst -d prog.asm

-p file.name will save the listing to a text file
-d will include debugging symbols in the output

Using ED.X - the x68k text editor
You may wish to do your assembly programming on the x68 itself, but even if you don't you may need to edit batch files and settings files on your x68 emulator.

Fortunately, the x68 has a built in editor called ED.X - it's pretty easy to use, but you'll need to know the basic keypresses to save and load your work. the most useful keypresses are show to the right.
Keypress Command
ESC-E Save All files and Exit
ESC-T Rename file
ESC-X Save and exit
ESC-Q Dont't save and Quit
ESC-O Reset to last save

Hello World for the X68000
We can build Hello World with VASM, or the official assembler.

If we build with VASM we should output in binary, and add our own Xfile header so we can run the program

the Sharp/Hudson assembler and linker will output a complete xfile for us!
VASM version Sharp/Hudson x68 assembler
    pea mes            ;Push message addres
    dc.w $ff09        ;show string
    addq.l #4,SP    ;skip over pushed message
    dc.w $FF00        ;return
mes:    dc.b 'Hello World',$0D,$0A,0
    pea mes
    .dc.w $ff09
    addq.l #4,sp
    .dc.w $ff00
mes:    .dc.b 'hello',$0d,$0a,0

Setting Graphics Modes

Rather than using system calls, We can select a graphics mode by writing the correct values to registers $e80000-$e8002e
Here are some sample values for a 16 color screen ... you will need to change the values in the dark section if you want 256 colors.

High Resolution Low Resolution
RegNum 768x512 512x512 512x256 256x256 512x512 512x256 256x256 Register Purpose
E80000 $89 $5B $5B $2B $4B $4B $25  R00 Horizontal total
E80002 $0E $09 $09 $04 $03 $03 $01  R01 Horizontal synchronization end position timing
E80004 $1C $11 $11 $06 $04 $05 $00  R02 Horizontal display start position
E80006 $7C $51 $51 $26 $45 $45 $20  R03 Horizontal display end position
E80008 $237 $237 $237 $237 $103 $103 $103  R04 Vertical total
E8000A $05 $05 $05 $05 $02 $02 $02  R05 Vertical synchronization end position timing
E8000C $28 $28 $28 $28 $10 $10 $10  R06 Vertical display start position
E8000E $228 $228 $228 $228 $100 $100 $100  R07 Vertical display end position
E80010 $1B $1B $1B $1B $44 $44 $24  R08 External synchronization horizontal adjust: Horizontal position tuning 

$05 $01 $00  R20 Memory mode/Display mode control

$00 $00 $00  R0 (Screen mode initialization) - Detail

$2E4 $2E4 $2E4  R1 (Priority control) - Priority (Sprites foreground)

$C1 $C1 $C1  R2 (Special priority/screen display) - Screen On / Sprites On
EB0808 $200 $200 $200 $200 $200 $200 $200  BG Control (Sprites Visible, slow writing)
$FF $FF $FF $FF $FF $25  Sprite H Total
$15 $15 $0A $09 $09 $04  Sprite H Disp
$28 $28 $28 $10 $10 $10  Sprite V Disp
$15 $11 $10 $05 $01 $00  Sprite Res %---FVVHH

Palette Definitions
Graphics mode palettes are defined by the registers from $e82000... each takes 2 bytes, so color 0 is at $e82000, and color 1 is at $e82002... there are up to 256 depending on screen mode.

Each color is defined by 5 bits per channel in the format shown to the right

Text palettes are in the same format from $e82200 - there are 16

Sprite palettes are in the same format from $e82200 - there are 240
 F  E  D  C  B  A  9  8    7  6  5  4  3  2  1  0
G4 G3 G2 G1 G0 R4 R3 R2 R1 R0 B4 B3 B2 B1 B0 -

Memory Map and Hardware Registers
address vector Function
$000000 $00 SSP after reset
$000004 $01 PC after reset
$000008 $02 Bus error
$00000c $03 Address error
$000010 $04 Unknown instruction
$000014 $05 Division by 0
$000018 $06 CHK instruction
$00001c $07 TRAPV instruction, FTRAPcc instruction
$000020 $08 Privilege violation
$000024 $09 Trace exception
$000028 $0a Unsupported instruction line 1010 emulator (SX call)
$00002c $0b 〃 line 1111 emulator (DOS call, floating point operation)
$000030 $0c Unused
$000034 $0d FPU プロトコルバイオレーション例外処理
$000038 $0e 〃 フォーマットエラー例外処理
$000034 $0d FPU Protocol violation exception handling
$000038 $0e '' Formatting error exception handling
$00003c $0f Uninitialized Interrupt
$000040 $10 Unused
$000044 $11
$000048 $12
$00004c $13
$000050 $14
$000054 $15
$000058 $16
$00005c $17
$000060 $18 Spurious Interrupt
$000064 $19 Level 1 Interrupt (auto vector)
$000068 $1a
$00006c $1b
$000070 $1c
$000074 $1d
$000078 $1e
$00007c $1f
$000080 $20 trap #0
$000084 $21 〃 #1
$000088 $22 〃 #2
$00008c $23 〃 #3
$000090 $24 〃 #4
$000094 $25 〃 #5
$000098 $26 〃 #6
$00009c $27 〃 #7
$0000a0 $28 〃 #8 (reserved for system)
$0000a4 $29 〃 #9 (OS debugger)
$0000a8 $2a 〃 #10 (reset & power off)
$0000ac $2b 〃 #11 (BREAK key)
$0000b0 $2c 〃 #12 (COPY key)
$0000b4 $2d 〃 #13 (CTRL+C)
$0000b8 $2e 〃 #14 (error processing)
$0000bc $2f 〃 #15 (IOCS call)
$0000c0 $30 FPU BSUN
$0000c0 $30 FPU BSUN
$0000c4 $31 〃 INEX1,INEX2
$0000c8 $32 〃 DZ
$0000cc $33 〃 UNFL
$0000d0 $34 〃 OPERR
$0000d4 $35 〃 OVFL
$0000d8 $36 〃 SNAN
$0000dc $37 未使用
$0000dc $37 Unused
$0000e0 $38 MMU
$0000e4 $39
$0000e8 $3a
$0000ec $3b Unused
$0000fc $3f Unused
$000100 $40 MFP RTC Alarm/1Hz
$000104 $41 MFP External power OFF
$000118 $42 MFP Front switch OFF
$00010c $43 MFP FM Audio source
$000110 $44 MFP Timer-D (Used with BG processing)
$000114 $45 MFP Timer-C (Mouse/cursor/FDD control, etc.)
$000118 $46 MFP V-DISP
$00011c $47 MFP RTC Clock
$000120 $48 MFP Timer-B
$000124 $49 MFP Key serial output error
$000128 $4a MFP Key serial output empty
$00012c $4b MFP Key serial input error
$000130 $4c MFP Key serial input
$000134 $4d MFP Timer-A
$000138 $4e MFP CRTC*IRQ
$00013c $4f MFP H-SYNC
$000140 $50 SCC(B) Transmission buffer empty
$000144 $51 SCC(B) ''
$000148 $52 SCC(B) External/status changes
$00014c $53 SCC(B) ''
$000150 $54 SCC(B) Incoming character validity (Mouse 1 byte input)
$000154 $55 SCC(B) ''
$000158 $56 SCC(B) Special Rx condition
$00015c $57 SCC(B) ''
$000160 $58 SCC(A) Transmission buffer empty
$000164 $59 SCC(A) ''
$000168 $5a SCC(A) External status changes
$00016c $5b SCC(A) ''
$000170 $5c SCC(A) Incoming character validity (RS-232C 1 byte input)
$000174 $5d SCC(A) ''
$000178 $5e SCC(A) Special Rx Condition
$00017c $5f SCC(A) ''
$000180 $60 I/O FDC status interruption
$000184 $61 I/O FDC insertion/discharge interruption
$000188 $62 I/O HDC status interruption
$00018c $63 I/O Printer ready interruption
$000190 $64 DMAC #0 End (FDD)
$000194 $65 DMAC #0 Error ('')
$000198 $66 DMAC #1 End (SASI)
$00019c $67 DMAC #1 Error ('')
$0001a4 $69 DMAC #2 Error ('')
$0001a8 $6a DMAC #3 End (ADPCM)
$0001ac $6b DMAC #3 Error ('')
$000200 $6c SPC SCSI interruption (Internal SCSI)
$000204 $6d Unused
$0003d4 $f5 Unused
$0003d8 $f6 SPC SCSI interruption (SCSI board)
$0003dc $f7 Unused
$0003fc $ff Unused
RAM area
Graphics Vram – Page 0
Graphics Vram – Page 1
Graphics Vram – Page 2
Graphics Vram – Page 3
Text Vram – Page 0
Text Vram – Page 1
Text Vram – Page 2
Text Vram – Page 3
$e80000 1.w R00 Horizontal total
$e80002 1.w R01 Horizontal synchronization end position timing
$e80004 1.w R02 Horizontal display start position
$e80006 1.w R03 Horizontal display end position
$e80008 1.w R04 Vertical total
$e8000a 1.w R05 Vertical synchronization end position timing
$e8000c 1.w R06 Vertical display start position
$e8000e 1.w R07 Vertical display end position
$e80010 1.w R08 External synchronization horizontal adjust: Horizontal position tuning
$e80012 1.w R09 Raster number: Used for raster interruption
$e80014 1.w R10 Text Screen X coordinate
$e80016 1.w R11 Text Screen Y coordinate
$e80018 1.w R12 Graphics screen Scroll X0
$e8001a 1.w R13 Graphics screen Scroll Y0
$e8001c 1.w R14 Graphics screen Scroll X1
$e8001e 1.w R15 Graphics screen Scroll Y1
$e80020 1.w R16 Graphics screen Scroll X2
$e80022 1.w R17 Graphics screen Scroll Y2
$e80024 1.w R18 Graphics screen Scroll X3
$e80026 1.w R19 Graphics screen Scroll Y3
$e80028 1.w R20 Memory mode/Display mode control
$e8002a 1.w R21 Simultaneous access/Raster copy/Quick clear plane select
$e8002c 1.w R22 Raster copy action: Raster number
$e8002e 1.w R23 Text screen access mask pattern
$e80481 1.b Active Image capture/Quick clear/Raster copy control
$e82000 256.w Graphics palette
$e82200 16.w Text palette (Palette block 0)
$e82220 240.w Sprite palette ('' 1-15)
$e82400 1.w R0 (Screen mode initialization)
$e82500 1.w R1 (Priority control)
$e82600 1.w R2 (Special priority/screen display)
DMAC (HD63450)
Memory controller privileged access settings (OHM/ASA)
MFP (MC68901)
RTC (RP5C15)
Printer port
#1 Contrast
#2 Display/3D scope
#3 Color image unit (bit 4-0)
#4 Keyboard/NMI/dot clock
#5 ROM/DRAM Wait
#6 MPU Classification/Operation clock
#7 SRAM Write
#8 Unit power OFF
FM Synthesizer (YM2151) - Register Address Write port
$E90003 FM Synthesizer (YM2151) - Data R/W port
Floppy disk controller (FDC) (uPD72065)
Floppy drive monitor (IOSC)
ESCC (Z8530)
PPI (82C55)
I/O selector (IOSC)
I/O expansion area (Sharp reserved)
Sprite register (CYNTHIA)
Sprite VRAM
I/O expansion area (User)
$ed0072 2.b SX-Window environment flag (While in use with "SX")
$ed0074 1.b Standard double-click time / 10
$ed0075 1.b Mouse speed / 2
$ed0076 1.b Text palette hue (HSV)
$ed0077 1.b
$ed0078 1.b Brightness palette 0-3 5bit???
$ed007b 1.b Printer drive (PRTD) ID
$ed007c 1.b SRAM info version#, screen status storage, start screen storage
$ed007d 1.b Desktop background (PICT) ID
$ed007e 1.b Screen mode
$ed007f 17.b Reserved for system use (X68030)
$ed0090 1.b Standard cache status (bit=0: off 1:on)
$ed0091 1.b OPM music during startup (0: OFF -1: ON)
$ed0092 1.b 10MHz Proper wait value
$ed0093 1.b 16MHz ''
$ed0094 108.b Reserved for system use
$ed0100 768.b Head SRAM program address
$ed0400 15KB Head SRAMDISK address
End of SRAM
Backup (64KB)
Unused (128KB)
ROM Debugger

Dos Calls
You can use Dos calls to do basic tasks, they are performed with dc.w $FFxx ... where xx is the command number:

Code Shortname Meaning Example                        Example function
$FF00 _EXIT Program end dc.w $FF00
$FF01 _GETCHAR Get keyboard input (with echo)
$FF02 _PUTCHAR Put character
$FF03 _COMINP RS-232C 1 byte input
$FF04 _COMOUT RS-232C 1 byte output
$FF05 _PRNOUT Printer 1 character output
$FF06 _INPOUT Character I/O
$FF07 _INKEY Get one character from the keyboard (no break check)
$FF08 _GETC Get one character from the keyboard (with break check)
$FF09 _PRINT Print string pea mes
dc.w $ff09
mes:dc.b 'Hello World',$0D,$0A,0
Print 0 terminated 'mes' to screen
$FF0A _GETS Get character string (with break check)
$FF0B _KEYSNS Key input state check
$FF0C _KFLUSH Keyboard input after buffer flush
$FF0D _FFLUSH Disk reset
$FF0E _CHGDRV Current drive setting
$FF0F _DRVCTRL Drive status check/setting
$FF10 _CONSNS Screen output check
$FF11 _PRNSNS Printer output check
$FF12 _CINSNS RS-232C input check
$FF13 _COUTSNS RS-232C output check
$FF17 _FATCHK File concatenation state check
$FF18 _HENDSP Kanji conversion control
$FF19 _CURDRV Get current drive
$FF1A _GETSS Get character string (no break check)
$FF1B _FGETC Get character from file
$FF1C _FGETS Get string from file
$FF1D _FPUTC Write one character to file
$FF1E _FPUTS Write string to file
$FF1F _ALLCLOSE Close all files
$FF20 _SUPER Supervisor/user mode setting
$FF21 _FNCKEY Get/set redefinable key
$FF22 _KNJCTRL Kana-to-kanji conversion
$FF23 _CONCTRL Console control/direct output move.w #1,d2
move.w d2,-(sp)
move.w #2,d2
move.w d2,-(sp)
dc.w $ff23
Set console color to #1
$FF24 _KEYCTRL Console state check/direct input
$FF25 _INTVCS Set vector processing address
$FF26 _PSPSET Create process management pointer
$FF27 _GETTIM2 Get time (longword)
$FF28 _SETTIM2 Set time (longword)
$FF29 _NAMESTS Filename expansion
$FF2A _GETDATE Get date
$FF2B _SETDATE Set date
$FF2C _GETTIME Get time
$FF2D _SETTIME Set time
$FF2E _VERIFY Set verify flag
$FF2F _DUP0 Force file handle copy
$FF30 _VERNUM Get OS version
$FF31 _KEEPPR Terminate and stay resident
$FF32 _GETDPB Get drive parameter block
$FF33 _BREAKCK Set break check
$FF34 _DRVXCHG Replace drive
$FF35 _INTVCG Get vector processing address
$FF36 _DSKFRE Get disk space remaining
$FF37 _NAMECK Filename expansion
$FF39 _MKDIR Create subdirectory
$FF3A _RMDIR Remove subdirectory
$FF3B _CHDIR Change current directory
$FF3C _CREATE Create file
$FF3D _OPEN Open file
$FF3E _CLOSE Close file
$FF3F _READ Read file
$FF40 _WRITE Write file
$FF41 _DELETE Delete file
$FF42 _SEEK Seek file
$FF43 _CHMOD Set/get file modes
$FF44 _IOCTRL Device driver ioctrl direct I/O
$FF45 _DUP Copy file handle
$FF46 _DUP2 Force copy file handle
$FF47 _CURDIR Get current directory
$FF48 _MALLOC Allocate memory
$FF49 _MFREE Free memory
$FF4A _SETBLOCK Change memory block
$FF4B _EXEC Load/execute program
$FF4C _EXIT2 Exit with return code move.w #1,-(sp)
dc.w $FF4C
$FF4D _WAIT Get process end return code
$FF4E _FILES Search files
$FF4F _NFILES Search next files
$FF80 _SETPDB Change process information
$FF81 _GETPDB Get process information
$FF82 _SETENV Set environment variable
$FF83 _GETENV Get environment variable
$FF84 _VERIFYG Get verify flag
$FF85 _COMMON COMMON area control
$FF86 _RENAME Rename/move file
$FF87 _FILEDATE Get/set file date
$FF88 _MALLOC2 Alloc memory
$FF8A _MAKETMP Create temporary file
$FF8B _NEWFILE Create new file
$FF8C _LOCK Lock file
$FF8F _ASSIGN Get/set/cancel virtual drive/directory assignment
$FFAA FFLUSH Set FFLUSH mode (undocumented)
$FFAB _OS_PATCH Hook OS internal function (undocumented)
$FFAC _GETFCB Get FCB pointer (undocumented)
$FFAD _S_MALLOC Alloc memory using main memory management
$FFAE _S_MFREE Free memory using main memory management
$FFAF _S_PROCESS Sub memory management setting
$FFF0 _EXITVC (program end execution address)
$FFF1 _CTRLVC (CTRL+C execution address at abort)
$FFF2 _ERRJVC (Error abort execution address)
$FFF3 _DISKRED Block device direct input
$FFF4 _DISKWRT Block device direct output
$FFF5 _INDOSFLG Get OS work pointer
$FFF6 _SUPER_JSR Supervisor subroutine call
$FFF7 _BUS_ERR Check for bus error
$FFF8 _OPEN_PR Register background task
$FFF9 _KILL_PR Remove background task
$FFFA _GET_PR Get thread management information
$FFFB _SUSPEND_PR Force thread to sleep
$FFFC _SLEEP_PR Sleep thread
$FFFD _SEND_PR Transmit thread command/data
$FFFE _TIME_PR Get timer counter value
$FFFF _CHANGE_PR Yield execution time
Human68k is generally DOS like, however while it is based around 8.3 filenames, the files can be 18.3 - but please note, the extra 10 letters are not 'really counted' the first 8 must make the filename unique!
Human68k also supports lowercase files... but your disks will no longer be compatible with MS-DOS

Most commands like CD, DIR and EXIT work the same as normal DOS, but many do not, and some work differently ... here are a few commands beyond the basics you may want to remember...
Command Meaning
CUSTOM Reconfigure config.sys and autoexec.bat
DISKCOPY A: B: Copy Disk A to B
DUMP file.name Dump file.name as Hex/Ascii
FORMAT B: erase Disk B
SWITCH change bios settings (including installed memory)
TYPE file.txt Type the contents of file.txt to the command line
ED file.txt Edit file.txxt (see above section for usage)

FM Sound - YM2151 Chip

For full details of the YM2151 can be found in the  YM2151 PDF

The FM sound chip has 8 channels....
Each channel's sound can be built up with 4 different 'slots'... meaning there are a total of 32 slots... these slots are turned on or off when the sound is triggered

Setting a register is easy,  we write the register number to  $E90001 , then we write the 8 bit value to $E90003
Setting a register on the X68000

move.b #$20,$E90001     
move.b #%11000000,$E90003

The YM2151 is controlled by 255 registers, that are summarized below:

   Address      7     6     5     4     3     2     1     0   Summary Bit Meanings
$01 T T T T T T T T Test T=Test
$08 - S S S S C C C Key On (Play Sound) C=Channel S=Slot (C2 – M2 – C1 – M1)
$0F E - - F F F F F Noise E=noise enable F=Frequency
$10 C C C C C C C C CLKA1
$11 - - - - - - C C CLKA2
$12 C C C C C C C C CLKB
$14 C - F F I I L L
$1B C C - - - - W W
C=CT W=Waveform
$20-$27 L R F F F C C C Chn1-7… F=Feedback, C=Connection
$28-$2F - O O O N N N N Chn1-7… KeyCode O=Octive, N=Note
$30-$37 F F F F F F - - Chn1-7… Key Fraction F=Fraction
$38-$3F - P P P - A A A Chn1-7… PMS / AMS P=PMS , A=AMS
$40-$5F - D D D M M M M Slot1-32. Decay/Mult D=Decay D1T, M=Mult
$60-$7F - V V V V V V V Slot1-32. Volume V=Volume (TL)
$80-$9F K K - A A A A A Slot1-32. Keyscale / Attack K=Keycale, A=attack
$A0-$BF A - - D D D D D Slot1-32. AMS / Decay A=AMS-EN, D=Decay D1R
$C0-$DF T T - D D D D D Slot1-32. DeTune / Decay T=Detune DT2, D=Decay D2R
$E0-$FF D D D D R R R R Slot1-32. Decay / Release D=Decay D1L, R=Release Rate

I had a lot of trouble finding documentation on how to wait for Vblank,  so I though I'd mark it clearly here!

Vblank can be detected by the MFP (MC68901)... By testing memory address $e88001 - bit 4

The sample code I used for Grime68000 is shown to the right...
    move.w $e88000,d0
    and.w #%00010000,d0            ;Wait for vblank to start
    beq waitVBlank

    move.w $e88000,d0
    and.w #%00010000,d0            ;Wait for Vblank to end
    bne waitVBlank2

Sprite Init
We need to set up some registers to get our sprites working - otherwise they just won't show!

We have to set up our layering correctly, so the sprites are in the foreground, we do this by setting $E80500 to $2E4
We have to enable the sprite layer, we do this by setting $E80600 to $C1
We also need to set the "Background Control"... we're going to make the sprites visible, this slows down writing, but means we can change the sprites while showing them... we do this by writing  $200 to $EB0808

We also need to set Registers $EB080A-$EB0810 to the values shown in the 'Setting Graphics Modes' Table
            move.w #%0000001000000000,$eB0808
;Disp/CPU 1=sprites on (slow writing)

            move.w #%0000001011100100,$e82500
;R1 (Priority control) - Priority

            move.w #%0000000011000001,$e82600
;R2 (Special priority/screen display) - Screen On - sprites on

            move.w #%0000001000000000,$eB0808
;Disp/CPU 1=sprites on (slow writing)

            move.w #$25,$EB080A        ; Sprite H Total
            move.w #$04,$EB080C        ; Sprite H Disp
            move.w #$10,$EB080E        ; Sprite V Disp
            move.w #$00,$EB0810        ; Sprite Res %---FVVHH

Sprite Settings
Each Sprite has 4 Words defining the settings of the sprite... these start at $EB0000 for sprite 0.... $EB0008 for sprite 1, through to $EB03F8 for sprite 127
Address F E D C B A 9 8
7 6 5 4 3 2 1 0
$EB0000 - - - - - - X X
X X X X X X X X   X=Xpos
$EB0002 - - - - - - Y Y
Y Y Y Y Y Y Y Y   Y=Ypos
$EB0004 V H - - C C C C
S S S S S S S S   V=Vflip, H=Hflip, C=color, S=sprite
$EB0006 - - - - - - - -
- - - - - - P P   P=Priority (00=off... 01=back...  11=front)  

Sprite Bitmap Data Settings
Sprites are split into four 8x8 chunks, these are stored in 4 different memory addresses to make up the 16x16 sprite,

The byte data for these sprites uses 1 nibble for each pixel, and selects a color from the chosen palette for that pixel

Sprite Pixel Data:
Address F E D C B A 9 8 7 6 5 4 3 2 1 0
EB8000 Color Color Color Color
EB8002 Color Color Color Color

EBBFFE Color Color Color Color

8x8 Chunk layout:

16 pixels
16 pixels TopLeft
Bottom Left
8x8 chunks position in ram:
SpriteNum 8x8 chunk Address
0 TopLeft $EB8000
BottomLeft $EB8020
TopRight $EB8040
BottomRight $EB8060
1 TopLeft $EB8080
BottomLeft $EB80A0
TopRight $EB80C0
BottomRight $EB80E0
2 TopLeft $EB8100

127 TopLeft $EBBF80
BottomLeft $EBBFA0
TopRight $EBBFC0
BottomRight $EBBFE0

X68000 Links!
Replacing an x68000 powersupply - The power supply breaks a lot, but can easilly be replaced with a PC Pico-ATX psu!
Connecting a HxC to the x68000 - Note, while this somewhat works, there are problems due to the extra control lines not being connected
External floppy pinout - I used this to connect my HxC to my x68000 and create disks from images
Connecting SCSI2SD to the x68000 - a cheap SD emulator for the SCSI/SASI hard drive