X-Git-Url: https://git.wirehaze.ovh/lifeboot.git/blobdiff_plain/9ed39df5a90be6cce8ee7948cefbf8e5fc7fe089..996bd9ab6f26e318e4b678f4b11d81bb8a8c5164:/lifeboot.asm?ds=inline

diff --git a/lifeboot.asm b/lifeboot.asm
index 8b530f9..8f11b87 100644
--- a/lifeboot.asm
+++ b/lifeboot.asm
@@ -1,94 +1,138 @@
 bits 16
-org 0x7c00
+org 7c00h
 
-%define ORG 0x7c00
-%define VGA 0xb8000
+; =============================================================================
+
+; settings --------------------------------------------------------------------
+
+%define DEAD ' '            ; char to represent a dead cell
+%define ALIVE '.'           ; char to represent an alive cell
+%define PRINT_COLOR 07h     ; grey on black
+
+%define WAIT_DELAY_CX 01h   ; cx:dx = delay in microseconds
+%define WAIT_DELAY_DX 00h
+
+; constants -------------------------------------------------------------------
 
 %define COLS 80
 %define ROWS 25
+%define VGAPGSZ 1000h
 
-%define DEAD ' '            ; char to represent a dead cell
-%define ALIVE '#'           ; char to represent an alive cell
-%define PRINT_COLOR 0x07    ; grey on black
+; memory layout ---------------------------------------------------------------
+
+%define ORG 7c00h
+%define VGA 0b8000h
+%define DAT ORG + 512
+
+; static variables ------------------------------------------------------------
 
-%define GRID        ORG + 512               ; current cell grid (80 * 25 bytes)
-%define NEXT_GRID   GRID + COLS * ROWS      ; next cell grid (80 * 25 bytes)
-%define XSS         NEXT_GRID + COLS * ROWS ; xs() state
+%define xss DAT             ; xs() state (word)
+%define currvgapg DAT + 2   ; current vga page near pointer (word)
+
+; =============================================================================
 
 ; entry point -----------------------------------------------------------------
 
 ; initialize segment registers
+mov ax, VGA >> 4
+mov es, ax
+
 xor ax, ax
 mov ds, ax
-mov es, ax
 mov ss, ax
 
 ; set stack pointers
-mov sp, ORG
 mov bp, ORG
+mov sp, bp
 
 ; clear direction flag
 cld
 
-; clear screen ----------------------------------------------------------------
-
 ; disable cursor
-mov ch, 0x3f
-mov ah, 0x01
-int 0x10
+mov ch, 3fh                 ; cursor start and options
+mov ah, 01h                 ; set text-mode cursor shape
+int 10h                     ; video services
 
-; clear video memory
-mov cx, COLS * ROWS
-mov ax, VGA >> 4
-mov es, ax
-xor di, di
-mov ax, (PRINT_COLOR << 8) | DEAD
+; initialize xss
 
-rep stosw                   ; fill cx words at es:di with ax
+set_xss_seed:
 
-; setup -----------------------------------------------------------------------
+mov ah, 00h                 ; get
+int 1ah                     ;  system time
 
-setup:
+cmp dx, 0
+je set_xss_seed             ; if seed is 0, xs wont work properly
 
-; initialize xss
-mov ah, 0x00                ; get
-int 0x1a                    ;  system time
-mov [XSS], dx               ; cx:dx = number of clock ticks since midnight
+mov [xss], dx               ; cx:dx = number of clock ticks since midnight
 
-; initialize grid
-mov cx, COLS * ROWS         ; for each cell
-xor ax, ax
-mov es, ax
-mov di, GRID                ; es:di -> GRID
+; initialize currvgapg
+mov word [currvgapg], 0
 
-.initgrid:                  ; do {
-    call xs                 ;     [XSS] = rand
-    mov al, DEAD            ;     al = DEAD (likely)
+; start simulation from random state ------------------------------------------
 
-    test [XSS], 0b11
+start:
 
-    jnz  .initgrid_nz       ;     if ([XSS] % 4 == 0)
-    mov al, ALIVE           ;         al = ALIVE
+call init_grid
 
-.initgrid_nz:
-    stosb                   ;     [es:(di++)] = al
+; apply game of life's rules to determine the next state ----------------------
 
-    loop .initgrid          ; } while (--cx)
+next_state:
 
-jmp halt
+call vsync_wait
+call write_next_vga_page
+call delay
+call flip_vga_page
+
+jmp next_state
+
+; =============================================================================
 
 ; functions -------------------------------------------------------------------
 
+; delay() - suspend program execution temporarily -----------------------------
+
+; clobbers ah, cx, dx
+
+delay:
+
+mov cx, WAIT_DELAY_CX
+mov dx, WAIT_DELAY_DX
+
+mov ah, 86h
+int 15h                     ; wait
+
+ret
+
+; vsync_wait() - wait for display to enter the next VBlank cycle --------------
+
+; clobbers ax, dx
+
+vsync_wait:
+
+mov dx, 3dah                ; input status #1 register
+
+.wait_on:
+    in al, dx
+    test al, 08h            ; vertical retrace bit
+    jnz .wait_on
+
+.wait_off:
+    in al, dx
+    test al, 08h
+    jz .wait_off
+
+ret
+
 ; xs() - xorshift pseudorandom number generator -------------------------------
 
 ; output:
-; [XSS]     = updated state
+; [xss]     = updated state
 
 ; clobbers bx, dx
 
 xs:
 
-mov bx, [XSS]
+mov bx, [xss]
 mov dx, bx
 
 shl dx, 1                   ; dx = xss << 1
@@ -101,43 +145,217 @@ mov dx, bx
 
 shl dx, 10                  ; dx = xss'' << 10
 xor bx, dx                  ; bx = xss'' ^ (xss'' << 10)
-mov [XSS], bx
+mov [xss], bx
+
+ret
+
+; init_grid() - initialize grid cells randomly --------------------------------
+
+; clobbers ax, bx, cx, dx, di
+
+init_grid:
+
+mov ah, PRINT_COLOR         ; ah = color attribute
+mov di, [currvgapg]         ; es:di -> grid start
+mov cx, COLS * ROWS         ; for each cell
+
+.write_cell:                ; do {
+    call xs                 ;     [xss] = rand
+    mov al, DEAD            ;     al = DEAD (likely)
+
+    test word [xss], 0b11
+
+    jnz  .nz                ;     if ([xss] % 4 == 0)
+    mov al, ALIVE           ;         al = ALIVE
+
+.nz:
+    stosw                   ;     [es:di] = ax ; di += 2
+
+    loop .write_cell        ; } while (--cx)
+
+ret
+
+; flip_vga_page() - flip active display page ----------------------------------
+
+; clobbers ax, dx
+
+flip_vga_page:
+
+call vsync_wait
+
+xor word [currvgapg], VGAPGSZ   ; flip currvgapg
+setnz al                        ; al = !(currvgapg == 0)
+
+mov ah, 05h                 ; select active display page
+int 10h                     ; video services
+
+ret
+
+; alive_neighbours() ----------------------------------------------------------
+
+; input:
+; es:si     -> current grid
+; cx        -> cell index
+
+; output:
+; ax = # alive neighbours
+
+; clobbers ax, bx, dx
+
+alive_neighbours:
+enter 5, 0
+
+; [bp - 1]: row
+; [bp - 2]: col
+; [bp - 3]: neighbours
+; [bp - 4]: i
+; [bp - 5]: j
+
+mov ax, cx                  ; ax = idx
+mov bl, COLS                ; bl = COLS
+div bl                      ; al = idx / COLS ; ah = idx % COLS
+
+mov [bp - 1], al            ; row = idx / COLS
+mov [bp - 2], ah            ; row = idx % COLS
+mov byte [bp - 3], 0        ; neighbours = 0
+
+mov byte [bp - 4], -1       ; i = -1
+.i:                         ; do {
+
+    mov byte [bp - 5], -1           ; j = -1
+.j:                                 ; do {
+
+        mov al, [bp - 4]
+        or al, [bp - 5]
+        jz .continue                    ; if (!i && !j) continue
+
+        mov al, [bp - 1]
+        add al, [bp - 4]                ; al = row + i
+
+        cmp al, 0
+        jl .continue                    ; if (row + i < 0) continue
+
+        cmp al, ROWS
+        jge .continue                   ; if (row + i >= ROWS) continue
+
+        mov ah, [bp - 2]
+        add ah, [bp - 5]                ; ah = col + j
+
+        cmp ah, 0
+        jl .continue                    ; if (col + j < 0) continue
+
+        cmp ah, COLS
+        jge .continue                   ; if (col + j >= COLS) continue
+
+        movzx bx, ah                    ; bx = col + j
+
+        mov ah, COLS
+        mul ah                          ; ax = (row + i) * COLS
+
+        add bx, ax                      ; bx = cell index
+        shl bx, 1                       ; bx = grid offset
+
+        mov dx, [es:si + bx]            ; dl = cell state
+
+        cmp dl, ALIVE                   ; if (!ALIVE) continue
+        jne .continue
+
+        inc byte [bp - 3]               ; neighbours++
+
+.continue:
+        inc byte [bp - 5]
+        cmp byte [bp - 5], 1
+        jle .j                      ; } while (++j <= 1)
+
+    inc byte [bp - 4]
+    cmp byte [bp - 4], 1
+    jle .i                  ; } while (++i <= 1)
+
+movzx ax, byte [bp - 3]     ; ax = # alive neighbours
+
+leave
+ret
+
+; write_next_cell_state() -----------------------------------------------------
+
+; input:
+; es:si     -> current grid
+; es:di     -> next grid
+; cx        -> cell index
+
+; output:
+; [es:di + cx * 2] = updated cell state
+
+; clobbers ax, bx, dx
+
+write_next_cell_state:
+
+call alive_neighbours       ; ax = # alive neighbours
+
+mov bx, cx
+shl bx, 1
+
+mov dx, [es:si + bx]        ; dl = cell current state
+
+cmp dl, ALIVE               ; if (ALIVE) {
+jne .else
+
+cmp ax, 2                   ;     if (n < 2)
+jl .dead                    ;         return DEAD
+
+cmp ax, 3                   ;     if (n > 3)
+jg .dead                    ;         return DEAD
+
+jmp .alive                  ;     return ALIVE
+
+.else:                      ; }
+
+cmp ax, 3                   ; if (n != 3)
+jne .dead                   ;     return DEAD
+
+.alive:                     ; return ALIVE
+mov dl, ALIVE
+jmp .write
+
+.dead:
+mov dl, DEAD
+
+.write:
+mov [es:di + bx], dx
 
 ret
 
-; errors ----------------------------------------------------------------------
+; write_next_vga_page() -------------------------------------------------------
+
+; clobbers di, si, ax, bx, cx, dx
 
-hello:
-mov si, str.hello
+write_next_vga_page:
 
-; print the error message string in si and halt
-; note: we assume es = VGA_SEG and ds = 0
-printerr:
-xor di, di
-mov ah, PRINT_COLOR
+mov si, [currvgapg]         ; es:si -> current page
 
-; es:di = video memory
-; ds:si = error message
-; al = current char
-; ah = color attribute
+mov di, VGAPGSZ
+xor di, si                  ; es:di -> next page
 
-write_char:
-lodsb                   ; al = [ds:si], si += 1
-or  al, al              ; on null terminator,
-jz  halt                ;  halt
-stosw                   ; [es:di] = ax, di += 2
-jmp write_char
+xor cx, cx                  ; i = 0
+
+.update_loop:
+call write_next_cell_state
+
+inc cx
+cmp cx, COLS * ROWS
+jl .update_loop             ; for i in [0 .. COLS * ROWS - 1]
+
+ret
+
+; halt() - stop program execution ---------------------------------------------
 
 halt:
-cli                     ; disable interrupts
+
+cli                         ; disable interrupts
 hlt
 jmp halt
 
-; data ------------------------------------------------------------------------
-
-str:
-.hello:
-    db "lifeboot", 0
+; =============================================================================
 
 times 510 - ($ - $$) db 0   ; fill remaining bytes with zeroes
-dw 0xaa55                   ; mbr magic byte
+dw 0aa55h                   ; mbr magic byte