WebSVN – Kolibri OS – Diff – /kernel/branches/Kolibri-acpi/boot/bootcode.inc

 ;;  KolibriOS 16-bit loader,                                    ;;
 ;;                        based on bootcode for MenuetOS        ;;
 ;;                                                              ;;
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-$Revision: 3725 $
+$Revision: 3908 $
         test    al, al
         jnz     @b
         popa
         ret
-getkey:
+getkey:                         ; Use BIOS INT 16h to read a key from the keyboard
 ; get number in range [bl,bh] (bl,bh in ['0'..'9'])
 ; in: bx=range
 ; out: ax=digit (1..9, 10 for 0)
-        mov     ah, 0
+        mov     ah, 0           ; If 'int 16h' is called with 'ah' equal to zero, the BIOS will not return control
-        int     16h
+        int     16h             ; to the caller until a key is available in the system type ahead buffer. On return,
-        cmp     al, bl
+        cmp     al, bl          ; 'al' contains the ASCII code for the key read from the buffer and 'ah' contains
-        jb      getkey
+        jb      getkey          ; the keyboard scan code. Here we compare 'al' with the range of accepted characters.
-        cmp     al, bh
+        cmp     al, bh          ; If the key pressed is not in the range, continue waiting for another key.
         ja      getkey
-        push    ax
+        push    ax              ; If the pressed key is in the accepted range, save it on the stack and echo to screen.
         call    putchar
         pop     ax
-        and     ax, 0Fh
+        and     ax, 0Fh         ; ASCII code for '0' is 48 (110000b). 0F4=1111b. (110000b AND 1111b) = 0
-        jnz     @f
+        jnz     @f              ; So if key '0' was entered, return 10 in 'ax'
         mov     al, 10
 @@:
         ret
         mov     ecx, 1*10000h + 1*100h + 0x8A
         mov     [es:BOOT_IDE_PI_16], cx
         xor     si, si  ; device index = 0
         int     0x1A
         jnc     .found_1 ; Parallel IDE Controller
+; Controller not found!
+        xor     ax, ax
+        mov     [es:BOOT_IDE_PI_16], ax
         jmp     .nopci
+;--------------------------------------
 .found_1:
 ; get memory base BAR4
         mov     ax, 0xB10A
         mov     di, 0x20        ; memory base is config register at 0x20
         push    cx
         int     0x1A
         jc      .no_BAR4        ;.nopci
-        and     cx, 0xFFF0      ; clear address decode type
+        and     cx, 0xFFFC      ; clear address decode type
         mov     [es:BOOT_IDE_BASE_ADDR], cx
 .no_BAR4:
         pop     cx
+;--------------------------------------
 .found:
+; get Interrupt Line
+        mov     ax, 0xB10A
+        mov     di, 0x3c        ; memory base is config register at 0x3c
+        push    cx
+        int     0x1A
+        jc      .no_Interrupt        ;.nopci
+        mov     [es:BOOT_IDE_INTERR_16], cx
+.no_Interrupt:
+        pop     cx
+;--------------------------------------
 ; get memory base BAR0
         mov     ax, 0xB10A
         mov     di, 0x10        ; memory base is config register at 0x10
         push    cx
         int     0x1A
         jc      .no_BAR0        ;.nopci
         mov     [es:BOOT_IDE_BAR0_16], cx
 .no_BAR0:
         pop     cx
+;--------------------------------------
 ; get memory base BAR1
         mov     ax, 0xB10A
         mov     di, 0x14        ; memory base is config register at 0x14
         push    cx
         int     0x1A
         jc      .no_BAR1        ;.nopci
         mov     [es:BOOT_IDE_BAR1_16], cx
 .no_BAR1:
         pop     cx
+;--------------------------------------
 ; get memory base BAR2
         mov     ax, 0xB10A
         mov     di, 0x18        ; memory base is config register at 0x18
         push    cx
         int     0x1A
         jc      .no_BAR2        ;.nopci
         mov     [es:BOOT_IDE_BAR2_16], cx
 .no_BAR2:
         pop     cx
+;--------------------------------------
 ; get memory base BAR3
         mov     ax, 0xB10A
         mov     di, 0x1C        ; memory base is config register at 0x1c
         push    cx
         int     0x1A
         jc      .no_BAR3        ;.nopci
         mov     [es:BOOT_IDE_BAR3_16], cx
 .no_BAR3:
         pop     cx
+;--------------------------------------
 .nopci:
 ; \end{Mario79}
         mov     al, 0xf6        ; Сброс клавиатуры, разрешить сканирование
 ; \begin{diamond}[30.11.2005]
 cfgmanager:
 ; settings:
 ; a) preboot_graph = graphical mode
 ;    preboot_gprobe = probe this mode?
-; b) preboot_dma  = use DMA access?
+; b) preboot_biosdisk  = use BIOS disks through V86 emulation? // (earlier was: preboot_dma  = use DMA access?)
-; c) preboot_vrrm = use VRR?
+; c) preboot_debug = duplicates kernel debug output to the screen // (earlier was: preboot_vrrm = use VRR?)
+;    // VRR is an obsolete functionality, used only with CRT monitors: increase display frequency by reducing screen resolution
+; d) preboot_launcher = start the first app (right now it's LAUNCHER) after kernel is loaded?
-; d) preboot_device = from what boot?
+; e) preboot_device = from where to boot?
 ; determine default settings
 if ~ defined extended_primary_loader
         mov     [.bSettingsChanged], 0
 end if
 .preboot_device_inited:
 ; following 4 lines set variables to 1 if its current value is 0
         cmp     byte [di+preboot_dma-preboot_device], 1
         adc     byte [di+preboot_dma-preboot_device], 0
+        cmp     byte [di+preboot_launcher-preboot_device], 1        ; Start LAUNCHER by default
+        adc     byte [di+preboot_launcher-preboot_device], 0
 ;        cmp     byte [di+preboot_biosdisk-preboot_device], 1
 ;        adc     byte [di+preboot_biosdisk-preboot_device], 0
 ;; default value for VRR is OFF
 ;        cmp     byte [di+preboot_vrrm-preboot_device], 0
-;        jnz	@f
+;        jnz    @f
         cmp     [preboot_biosdisk], 1
         call    .say_on_off
 ;        mov     si, vrrm_msg
 ;        cmp     [preboot_vrrm], 1
 ;        call    .say_on_off
+        mov     si, debug_mode_msg
+        cmp     [preboot_debug], 1
+        call    .say_on_off
+        mov     si, launcher_msg
+        cmp     [preboot_launcher], 1
+        call    .say_on_off
         mov     si, preboot_device_msg
         call    print
         mov     al, [preboot_device]
 if defined extended_primary_loader
         and     eax, 3
         pop     ax
 ; switch on key
         cmp     al, 13
         jz      .continue
         or      al, 20h
-        cmp     al, 'a'
+        cmp     al, 'a'         ; select graphical mode
         jz      .change_a
+        cmp     al, 'q'         ; Trick to make 'A' key on azerty keyboard work
-        cmp     al, 'b'
+        je      .change_a
+        cmp     al, 'b'         ; use BIOS disks? // (selecting YES will make BIOS disks visible as /bd)
         jz      .change_b
+        cmp     al, 'c'         ; load kernel in debug mode?  // (earlier was: use VRR?)
-;        cmp     al, 'c'
+        jz      .change_c
+        cmp     al, 'd'         ; start launcher after kernel is loaded?
-;        jz      .change_c
+        jz      .change_d
-        cmp     al, 'c'		; 'd'
+        cmp     al, 'e'         ; select boot origin
         jnz     .show_remarks
+; e) preboot_device = from where to boot?
-        _setcursor 15,0
+        _setcursor 16,0
         mov     si, bdev
         call    print
 if defined extended_primary_loader
-        mov     bx, '12'
+        mov     bx, '12'        ; range accepted for answer: 1-2
 else
-        mov     bx, '14'
+        mov     bx, '14'        ; range accepted for answer: 1-4
 end if
         call    getkey
         mov     [preboot_device], al
-        _setcursor 13,0
+        _setcursor 14,0
 .d:
 if ~ defined extended_primary_loader
         mov     [.bSettingsChanged], 1
 end if
         call    clear_vmodes_table             ;clear vmodes_table
-        jmp    .printcfg
+        jmp     .printcfg
 .change_a:
+        call    clear_vmodes_table             ;clear vmodes_table
 .loops:
         call    draw_vmodes_table
         _setcursor 25,0         ; out of screen
         xor     ax, ax
         int     0x16
         pop     word [number_vm]
         mov     word [preboot_graph], bp          ;save choose
-        jmp    .d
+        jmp     .d
-.change_b:
+.change_b:                      ; b) preboot_biosdisk  = use BIOS disks through V86 emulation?
-        _setcursor 15,0
+        _setcursor 16,0
-;        mov     si, ask_dma
+;        mov     si, ask_dma    // (earlier was: preboot_dma  = use DMA access?)
 ;        call    print
-;        mov     bx, '13'
+;        mov     bx, '13'       ; range accepted for answer: 1-3
 ;        call    getkey
 ;        mov     [preboot_dma], al
         mov     si, ask_bd
         call    print
-        mov     bx, '12'
+        mov     bx, '12'        ; range accepted for answer: 1-2
         call    getkey
         mov     [preboot_biosdisk], al
         _setcursor 11,0
         jmp     .d
-;.change_c:
+;.change_c:                     ; //  VRR is an obsolete functionality, used only with CRT monitors
-;        _setcursor 15,0
+;        _setcursor 16,0
 ;        mov     si, vrrmprint
 ;        call    print
-;        mov     bx, '12'
+;        mov     bx, '12'       ; range accepted for answer: 1-2
 ;        call    getkey
 ;        mov     [preboot_vrrm], al
+;        _setcursor 12,0
+;        jmp     .d
+.change_c:                      ; c) preboot_debug = duplicates kernel debug output to the screen
+        _setcursor 16,0
+        mov     si, ask_debug
+        call    print
+        mov     bx, '12'        ; range accepted for answer: 1-2
+        call    getkey
+        mov     [preboot_debug], al
+        _setcursor 12,0
+        jmp     .d
+.change_d:                      ; d) preboot_launcher = start the first app (right now it's LAUNCHER) after kernel is loaded?
+        _setcursor 16,0
+        mov     si, ask_launcher
+        call    print
+        mov     bx, '12'        ; range accepted for answer: 1-2
+        call    getkey
+        mov     [preboot_launcher], al
-;        _setcursor 12,0
+        _setcursor 13,0
-;        jmp     .d
+        jmp     .d
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 .say_on_off:
         pushf
         call    printplain
         call    printplain
         _setcursor 6,0
         mov     si, loading_msg
         call    print
-        _setcursor 15,0
+        _setcursor 16,0
 if ~ defined extended_primary_loader
         cmp     [.bSettingsChanged], 0
         jz      .load
         cmp     [.loader_block], -1
         jz      .load
 .cont:
         push    cs
         pop     ds
         mov     si, space_msg
         mov     byte [si+80], 0
-        _setcursor 15,0
+        _setcursor 16,0
         call    printplain
-        _setcursor 15,0
+        _setcursor 16,0
 .load:
 end if
 ; \end{diamond}[02.12.2005]
         mov     [es:BOOT_DMA], al
 ;; VRR_M USE
+;
+;        mov     al,[preboot_vrrm]
+;        mov     [es:BOOT_VRR], al              ;// 0x9030
-;        mov     al,[preboot_vrrm]
+; Set kernel DEBUG mode - if nonzero, duplicates debug output to the screen.
+        mov     al, [preboot_debug]
+        mov     [es:BOOT_DEBUG_PRINT], al       ;// 0x901E
+; Start the first app (right now it's LAUNCHER) after kernel is loaded?
+        mov     al, [preboot_launcher]
-;        mov     [es:0x9030], al
+        mov     [es:BOOT_LAUNCHER_START], al    ;// 0x901D
 ; BOOT DEVICE

Subversion Repositories Kolibri OS

(root)/kernel/branches/Kolibri-acpi/boot/bootcode.inc – Rev 3725 → 3908