WebSVN – Kolibri OS – Diff – /kernel/branches/Kolibri-acpi/blkdev/cd_drv.inc

 ;; Copyright (C) KolibriOS team 2004-2011. All rights reserved. ;;
 ;; Distributed under terms of the GNU General Public License    ;;
 ;;                                                              ;;
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
-$Revision: 2465 $
+$Revision: 3555 $
 ;**********************************************************
-;  Íåïîñðåäñòâåííàÿ ðàáîòà ñ óñòðîéñòâîì ÑD (ATAPI)
+;  Непосредственная работа с устройством СD (ATAPI)
 ;**********************************************************
-; Àâòîð ÷àñòè èñõîäíîãî òåêñòà Êóëàêîâ Âëàäèìèð Ãåííàäüåâè÷
+; Автор части исходного текста Кулаков Владимир Геннадьевич
-; Àäàïòàöèÿ, äîðàáîòêà è ðàçðàáîòêà Mario79,
+; Адаптация, доработка и разработка Mario79,
-; Ìàêñèìàëüíîå êîëè÷åñòâî ïîâòîðåíèé îïåðàöèè ÷òåíèÿ
+; Максимальное количество повторений операции чтения
 MaxRetr equ 10
-; Ïðåäåëüíîå âðåìÿ îæèäàíèÿ ãîòîâíîñòè ê ïðèåìó êîìàíäû
+; Предельное время ожидания готовности к приему команды
-; (â òèêàõ)
+; (в тиках)
 BSYWaitTime equ 1000  ;2
 NoTickWaitTime equ 0xfffff
 CDBlockSize equ 2048
 ;********************************************
-;*        ×ÒÅÍÈÅ ÑÅÊÒÎÐÀ Ñ ÏÎÂÒÎÐÀÌÈ        *
+;*        ЧТЕНИЕ СЕКТОРА С ПОВТОРАМИ        *
-;* Ìíîãîêðàòíîå ïîâòîðåíèå ÷òåíèÿ ïðè ñáîÿõ *
+;* Многократное повторение чтения при сбоях *
 ;********************************************
-    ret
+        ret
 ReadCDWRetr_1:
         pushad
-; Öèêë, ïîêà êîìàíäà íå âûïîëíåíà óñïåøíî èëè íå
+; Цикл, пока команда не выполнена успешно или не
-; èñ÷åðïàíî êîëè÷åñòâî ïîïûòîê
+; исчерпано количество попыток
         mov     ECX, MaxRetr
 @@NextRetr:
-; Ïîäàòü êîìàíäó
+; Подать команду
 ;*************************************************
-;*      ÏÎËÍÎÅ ×ÒÅÍÈÅ ÑÅÊÒÎÐÀ ÊÎÌÏÀÊÒ-ÄÈÑÊÀ      *
+;*      ПОЛНОЕ ЧТЕНИЕ СЕКТОРА КОМПАКТ-ДИСКА      *
-;* Ñ÷èòûâàþòñÿ äàííûå ïîëüçîâàòåëÿ, èíôîðìàöèÿ   *
+;* Считываются данные пользователя, информация   *
-;* ñóáêàíàëà è êîíòðîëüíàÿ èíôîðìàöèÿ            *
+;* субканала и контрольная информация            *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå;           *
+;* DiskNumber - номер диска на канале;           *
-;* CDSectorAddress - àäðåñ ñ÷èòûâàåìîãî ñåêòîðà. *
+;* CDSectorAddress - адрес считываемого сектора. *
-;* Äàííûå ñ÷èòûâàåòñÿ â ìàññèâ CDDataBuf.        *
+;* Данные считывается в массив CDDataBuf.        *
 ;*************************************************
 ;ReadCD:
-	push	ecx
+        push    ecx
 ;        pusha
-; Çàäàòü ðàçìåð ñåêòîðà
+; Задать размер сектора
 ;        mov       [CDBlockSize],2048 ;2352
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Ñôîðìèðîâàòü ïàêåòíóþ êîìàíäó äëÿ ñ÷èòûâàíèÿ
+; Сформировать пакетную команду для считывания
-; ñåêòîðà äàííûõ
+; сектора данных
-; Çàäàòü êîä êîìàíäû Read CD
+; Задать код команды Read CD
         mov     [PacketCommand], byte 0x28;0xBE
-; Çàäàòü àäðåñ ñåêòîðà
+; Задать адрес сектора
         mov     AX, word [CDSectorAddress+2]
         xchg    AL, AH
         mov     word [PacketCommand+2], AX
         mov     AX, word [CDSectorAddress]
         xchg    AL, AH
         mov     word [PacketCommand+4], AX
 ;        mov   eax,[CDSectorAddress]
 ;        mov   [PacketCommand+2],eax
-; Çàäàòü êîëè÷åñòâî ñ÷èòûâàåìûõ ñåêòîðîâ
+; Задать количество считываемых секторов
         mov     [PacketCommand+8], byte 1
-; Çàäàòü ñ÷èòûâàíèå äàííûõ â ïîëíîì îáúåìå
+; Задать считывание данных в полном объеме
 ;        mov     [PacketCommand+9],byte 0xF8
-; Ïîäàòü êîìàíäó
+; Подать команду
-        call  SendPacketDatCommand
+        call    SendPacketDatCommand
-        pop   ecx
+        pop     ecx
-        dec   eax
+        dec     eax
 ;        test  eax,eax
-        jz    @@NextRetr
+        jz      @@NextRetr
-        jmp       .wait
+        jmp     .wait
 @@:
-; Çàäåðæêà íà 2,5 ñåêóíäû
+; Задержка на 2,5 секунды
 ;       mov     EAX,[timer_ticks]
 ;       add     EAX,50  ;250
 ;@@Wait:
 ;       call    change_task
 ;       cmp     EAX,[timer_ticks]
         mov     dword [DevErrorCode], eax
         popad
         ret
-; Óíèâåðñàëüíûå ïðîöåäóðû, îáåñïå÷èâàþùèå âûïîëíåíèå
+; Универсальные процедуры, обеспечивающие выполнение
-;             ïàêåòíûõ êîìàíä â ðåæèìå PIO
+;             пакетных команд в режиме PIO
-; Ìàêñèìàëüíî äîïóñòèìîå âðåìÿ îæèäàíèÿ ðåàêöèè
+; Максимально допустимое время ожидания реакции
-; óñòðîéñòâà íà ïàêåòíóþ êîìàíäó (â òèêàõ)
+; устройства на пакетную команду (в тиках)
-MaxCDWaitTime equ 1000 ;200 ;10 ñåêóíä
+MaxCDWaitTime equ 1000 ;200 ;10 секунд
 uglobal
-; Îáëàñòü ïàìÿòè äëÿ ôîðìèðîâàíèÿ ïàêåòíîé êîìàíäû
+; Область памяти для формирования пакетной команды
 PacketCommand:
                  rb 12  ;DB 12 DUP (?)
-; Îáëàñòü ïàìÿòè äëÿ ïðèåìà äàííûõ îò äèñêîâîäà
+; Область памяти для приема данных от дисковода
 ;CDDataBuf       DB 4096 DUP (0)
-; Ðàçìåð ïðèíèìàåìîãî áëîêà äàííûõ â áàéòàõ
+; Размер принимаемого блока данных в байтах
 ;CDBlockSize     DW ?
-; Àäðåñ ñ÷èòûâàåìîãî ñåêòîðà äàííûõ
+; Адрес считываемого сектора данных
 CDSectorAddress:
                  DD ?
-; Âðåìÿ íà÷àëà î÷åðåäíîé îïåðàöèè ñ äèñêîì
+; Время начала очередной операции с диском
 TickCounter_1 DD 0
-; Âðåìÿ íà÷àëà îæèäàíèÿ ãîòîâíîñòè óñòðîéñòâà
+; Время начала ожидания готовности устройства
 WURStartTime DD 0
-; óêàçàòåëü áóôåðà äëÿ ñ÷èòûâàíèÿ
+; указатель буфера для считывания
 CDDataBuf_pointer dd 0
 endg
 ;****************************************************
-;*    ÏÎÑËÀÒÜ ÓÑÒÐÎÉÑÒÂÓ ATAPI ÏÀÊÅÒÍÓÞ ÊÎÌÀÍÄÓ,    *
+;*    ПОСЛАТЬ УСТРОЙСТВУ ATAPI ПАКЕТНУЮ КОМАНДУ,    *
-;* ÏÐÅÄÓÑÌÀÒÐÈÂÀÞÙÓÞ ÏÅÐÅÄÀ×Ó ÎÄÍÎÃÎ ÑÅÊÒÎÐÀ ÄÀÍÍÛÕ *
+;* ПРЕДУСМАТРИВАЮЩУЮ ПЕРЕДАЧУ ОДНОГО СЕКТОРА ДАННЫХ *
-;*     ÐÀÇÌÅÐÎÌ 2048 ÁÀÉÒ ÎÒ ÓÑÒÐÎÉÑÒÂÀ Ê ÕÎÑÒÓ     *
+;*     РАЗМЕРОМ 2048 БАЙТ ОТ УСТРОЙСТВА К ХОСТУ     *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå    *
+;* Входные параметры передаются через глобальные    *
-;* ïåðìåííûå:                                       *
+;* перменные:                                       *
-;* ChannelNumber - íîìåð êàíàëà;                    *
+;* ChannelNumber - номер канала;                    *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå;              *
+;* DiskNumber - номер диска на канале;              *
-;* PacketCommand - 12-áàéòíûé êîìàíäíûé ïàêåò;      *
+;* PacketCommand - 12-байтный командный пакет;      *
-;* CDBlockSize - ðàçìåð ïðèíèìàåìîãî áëîêà äàííûõ.  *
+;* CDBlockSize - размер принимаемого блока данных.  *
 ; return eax DevErrorCode
 ;****************************************************
 SendPacketDatCommand:
         xor     eax, eax
-;        mov	byte [DevErrorCode],al
+;        mov    byte [DevErrorCode],al
-; Çàäàòü ðåæèì CHS
+; Задать режим CHS
         mov     byte [ATAAddressMode], al
-; Ïîñëàòü ATA-êîìàíäó ïåðåäà÷è ïàêåòíîé êîìàíäû
+; Послать ATA-команду передачи пакетной команды
         mov     byte [ATAFeatures], al
         mov     byte [ATASectorCount], al
         mov     byte [ATASectorNumber], al
-        ; Çàãðóçèòü ðàçìåð ïåðåäàâàåìîãî áëîêà
+        ; Загрузить размер передаваемого блока
         mov     [ATAHead], al
 ;        mov     AX,[CDBlockSize]
         mov     [ATACylinder], CDBlockSize
         mov     [ATACommand], 0A0h
         call    SendCommandToHDD_1
         test    eax, eax
-;        cmp     [DevErrorCode],0 ;ïðîâåðèòü êîä îøèáêè
+;        cmp     [DevErrorCode],0 ;проверить код ошибки
-        jnz     @@End_8    ;çàêîí÷èòü, ñîõðàíèâ êîä îøèáêè
+        jnz     @@End_8    ;закончить, сохранив код ошибки
-; Îæèäàíèå ãîòîâíîñòè äèñêîâîäà ê ïðèåìó
+; Ожидание готовности дисковода к приему
-; ïàêåòíîé êîìàíäû
+; пакетной команды
         mov     DX, [ATABasePortAddr]
-        add     DX, 7    ;ïîðò 1õ7h
+        add     DX, 7    ;порт 1х7h
         mov     ecx, NoTickWaitTime
 @@WaitDevice0:
         cmp     [timer_ticks_enable], 0
         jne     @f
         dec     ecx
 ;        test    ecx,ecx
         jz      @@Err1_1
         jmp     .test
 @@:
         call    change_task
-        ; Ïðîâåðèòü âðåìÿ âûïîëíåíèÿ êîìàíäû
+        ; Проверить время выполнения команды
         mov     EAX, [timer_ticks]
         sub     EAX, [TickCounter_1]
         cmp     EAX, BSYWaitTime
-        ja      @@Err1_1   ;îøèáêà òàéì-àóòà
+        ja      @@Err1_1   ;ошибка тайм-аута
-        ; Ïðîâåðèòü ãîòîâíîñòü
+        ; Проверить готовность
 .test:
         in      AL, DX
-        test    AL, 80h  ;ñîñòîÿíèå ñèãíàëà BSY
+        test    AL, 80h  ;состояние сигнала BSY
         jnz     @@WaitDevice0
-        test    AL, 1    ;ñîñòîÿíèå ñèãíàëà ERR
+        test    AL, 1    ;состояние сигнала ERR
         jnz     @@Err6
-        test    AL, 08h  ;ñîñòîÿíèå ñèãíàëà DRQ
+        test    AL, 08h  ;состояние сигнала DRQ
         jz      @@WaitDevice0
-; Ïîñëàòü ïàêåòíóþ êîìàíäó
+; Послать пакетную команду
         mov     AX, [PacketCommand+8]
         out     DX, AX
         mov     AX, [PacketCommand+10]
         out     DX, AX
         sti
-; Îæèäàíèå ãîòîâíîñòè äàííûõ
+; Ожидание готовности данных
         mov     DX, [ATABasePortAddr]
-        add     DX, 7  ;ïîðò 1õ7h
+        add     DX, 7  ;порт 1х7h
         mov     ecx, NoTickWaitTime
 @@WaitDevice1:
         cmp     [timer_ticks_enable], 0
         jne     @f
         dec     ecx
 ;        test    ecx,ecx
         jz      @@Err1_1
         jmp     .test_1
 @@:
         call    change_task
-        ; Ïðîâåðèòü âðåìÿ âûïîëíåíèÿ êîìàíäû
+        ; Проверить время выполнения команды
         mov     EAX, [timer_ticks]
         sub     EAX, [TickCounter_1]
         cmp     EAX, MaxCDWaitTime
-        ja      @@Err1_1   ;îøèáêà òàéì-àóòà
+        ja      @@Err1_1   ;ошибка тайм-аута
-        ; Ïðîâåðèòü ãîòîâíîñòü
+        ; Проверить готовность
 .test_1:
         in      AL, DX
-        test    AL, 80h  ;ñîñòîÿíèå ñèãíàëà BSY
+        test    AL, 80h  ;состояние сигнала BSY
         jnz     @@WaitDevice1
-        test    AL, 1    ;ñîñòîÿíèå ñèãíàëà ERR
+        test    AL, 1    ;состояние сигнала ERR
         jnz     @@Err6_temp
-        test    AL, 08h  ;ñîñòîÿíèå ñèãíàëà DRQ
+        test    AL, 08h  ;состояние сигнала DRQ
         jz      @@WaitDevice1
-; Ïðèíÿòü áëîê äàííûõ îò êîíòðîëëåðà
+; Принять блок данных от контроллера
         mov     EDI, [CDDataBuf_pointer];0x7000  ;CDDataBuf
-        ; Çàãðóçèòü àäðåñ ðåãèñòðà äàííûõ êîíòðîëëåðà
+        ; Загрузить адрес регистра данных контроллера
-        mov     DX, [ATABasePortAddr];ïîðò 1x0h
+        mov     DX, [ATABasePortAddr];порт 1x0h
-        ; Çàãðóçèòü â ñ÷åò÷èê ðàçìåð áëîêà â áàéòàõ
+        ; Загрузить в счетчик размер блока в байтах
         xor     ecx, ecx
         mov     CX, CDBlockSize
-        ; Âû÷èñëèòü ðàçìåð áëîêà â 16-ðàçðÿäíûõ ñëîâàõ
+        ; Вычислить размер блока в 16-разрядных словах
-        shr     CX, 1;ðàçäåëèòü ðàçìåð áëîêà íà 2
+        shr     CX, 1;разделить размер блока на 2
-        ; Ïðèíÿòü áëîê äàííûõ
+        ; Принять блок данных
         cli
         cld
-        rep     insw
+        rep insw
         sti
-; Óñïåøíîå çàâåðøåíèå ïðèåìà äàííûõ
+; Успешное завершение приема данных
 @@End_8:
         xor     eax, eax
         ret
-; Çàïèñàòü êîä îøèáêè
+; Записать код ошибки
 @@Err1_1:
         xor     eax, eax
-	inc	eax
+        inc     eax
-	ret
+        ret
 ;        ret
 ;***********************************************
-;*  ÏÎÑËÀÒÜ ÓÑÒÐÎÉÑÒÂÓ ATAPI ÏÀÊÅÒÍÓÞ ÊÎÌÀÍÄÓ, *
+;*  ПОСЛАТЬ УСТРОЙСТВУ ATAPI ПАКЕТНУЮ КОМАНДУ, *
-;*     ÍÅ ÏÐÅÄÓÑÌÀÒÐÈÂÀÞÙÓÞ ÏÅÐÅÄÀ×È ÄÀÍÍÛÕ    *
+;*     НЕ ПРЕДУСМАТРИВАЮЩУЮ ПЕРЕДАЧИ ДАННЫХ    *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç          *
+;* Входные параметры передаются через          *
-;* ãëîáàëüíûå ïåðìåííûå:                       *
+;* глобальные перменные:                       *
-;* ChannelNumber - íîìåð êàíàëà;               *
+;* ChannelNumber - номер канала;               *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå;         *
+;* DiskNumber - номер диска на канале;         *
-;* PacketCommand - 12-áàéòíûé êîìàíäíûé ïàêåò. *
+;* PacketCommand - 12-байтный командный пакет. *
 ;***********************************************
 SendPacketNoDatCommand:
         pushad
         xor     eax, eax
 ;        mov     byte [DevErrorCode],al
-; Çàäàòü ðåæèì CHS
+; Задать режим CHS
         mov     byte [ATAAddressMode], al
-; Ïîñëàòü ATA-êîìàíäó ïåðåäà÷è ïàêåòíîé êîìàíäû
+; Послать ATA-команду передачи пакетной команды
         mov     byte [ATAFeatures], al
         mov     byte [ATASectorCount], al
         mov     byte [ATASectorNumber], al
         mov     word [ATACylinder], ax
         mov     byte [ATAHead], al
         mov     [ATACommand], 0A0h
         call    SendCommandToHDD_1
-;        cmp     [DevErrorCode],0 ;ïðîâåðèòü êîä îøèáêè
+;        cmp     [DevErrorCode],0 ;проверить код ошибки
         test    eax, eax
-        jnz     @@End_9  ;çàêîí÷èòü, ñîõðàíèâ êîä îøèáêè
+        jnz     @@End_9  ;закончить, сохранив код ошибки
-; Îæèäàíèå ãîòîâíîñòè äèñêîâîäà ê ïðèåìó
+; Ожидание готовности дисковода к приему
-; ïàêåòíîé êîìàíäû
+; пакетной команды
         mov     DX, [ATABasePortAddr]
-        add     DX, 7  ;ïîðò 1õ7h
+        add     DX, 7  ;порт 1х7h
 @@WaitDevice0_1:
         call    change_task
-        ; Ïðîâåðèòü âðåìÿ îæèäàíèÿ
+        ; Проверить время ожидания
         mov     EAX, [timer_ticks]
         sub     EAX, [TickCounter_1]
         cmp     EAX, BSYWaitTime
-        ja      @@Err1_3   ;îøèáêà òàéì-àóòà
+        ja      @@Err1_3   ;ошибка тайм-аута
-        ; Ïðîâåðèòü ãîòîâíîñòü
+        ; Проверить готовность
         in      AL, DX
-        test    AL, 80h  ;ñîñòîÿíèå ñèãíàëà BSY
+        test    AL, 80h  ;состояние сигнала BSY
         jnz     @@WaitDevice0_1
-        test    AL, 1    ;ñîñòîÿíèå ñèãíàëà ERR
+        test    AL, 1    ;состояние сигнала ERR
         jnz     @@Err6_1
-        test    AL, 08h  ;ñîñòîÿíèå ñèãíàëà DRQ
+        test    AL, 08h  ;состояние сигнала DRQ
         jz      @@WaitDevice0_1
-; Ïîñëàòü ïàêåòíóþ êîìàíäó
+; Послать пакетную команду
 ;        cli
         mov     DX, [ATABasePortAddr]
         mov     AX, word [PacketCommand+10]
         out     DX, AX
 ;        sti
         cmp     [ignore_CD_eject_wait], 1
-	je  @@clear_DEC
+        je      @@clear_DEC
-; Îæèäàíèå ïîäòâåðæäåíèÿ ïðèåìà êîìàíäû
+; Ожидание подтверждения приема команды
         mov     DX, [ATABasePortAddr]
-        add     DX, 7  ;ïîðò 1õ7h
+        add     DX, 7  ;порт 1х7h
 @@WaitDevice1_1:
         call    change_task
-        ; Ïðîâåðèòü âðåìÿ âûïîëíåíèÿ êîìàíäû
+        ; Проверить время выполнения команды
         mov     EAX, [timer_ticks]
         sub     EAX, [TickCounter_1]
         cmp     EAX, MaxCDWaitTime
-        ja      @@Err1_3   ;îøèáêà òàéì-àóòà
+        ja      @@Err1_3   ;ошибка тайм-аута
-        ; Îæèäàòü îñâîáîæäåíèÿ óñòðîéñòâà
+        ; Ожидать освобождения устройства
         in      AL, DX
-        test    AL, 80h  ;ñîñòîÿíèå ñèãíàëà BSY
+        test    AL, 80h  ;состояние сигнала BSY
         jnz     @@WaitDevice1_1
-        test    AL, 1    ;ñîñòîÿíèå ñèãíàëà ERR
+        test    AL, 1    ;состояние сигнала ERR
         jnz     @@Err6_1
-        test    AL, 40h  ;ñîñòîÿíèå ñèãíàëà DRDY
+        test    AL, 40h  ;состояние сигнала DRDY
         jz      @@WaitDevice1_1
 @@clear_DEC:
         and     [DevErrorCode], 0
         popad
         ret
-; Çàïèñàòü êîä îøèáêè
+; Записать код ошибки
 @@Err1_3:
         xor     eax, eax
-	inc	eax
+        inc     eax
-        jmp @@End_9
+        jmp     @@End_9
 @@Err6_1:
         mov     [DevErrorCode], eax
         popad
         ret
 ;****************************************************
-;*          ÏÎÑËÀÒÜ ÊÎÌÀÍÄÓ ÇÀÄÀÍÍÎÌÓ ÄÈÑÊÓ         *
+;*          ПОСЛАТЬ КОМАНДУ ЗАДАННОМУ ДИСКУ         *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå    *
+;* Входные параметры передаются через глобальные    *
-;* ïåðåìåííûå:                                      *
+;* переменные:                                      *
-;* ChannelNumber - íîìåð êàíàëà (1 èëè 2);          *
+;* ChannelNumber - номер канала (1 или 2);          *
-;* DiskNumber - íîìåð äèñêà (0 èëè 1);              *
+;* DiskNumber - номер диска (0 или 1);              *
-;* ATAFeatures - "îñîáåííîñòè";                     *
+;* ATAFeatures - "особенности";                     *
-;* ATASectorCount - êîëè÷åñòâî ñåêòîðîâ;            *
+;* ATASectorCount - количество секторов;            *
-;* ATASectorNumber - íîìåð íà÷àëüíîãî ñåêòîðà;      *
+;* ATASectorNumber - номер начального сектора;      *
-;* ATACylinder - íîìåð íà÷àëüíîãî öèëèíäðà;         *
+;* ATACylinder - номер начального цилиндра;         *
-;* ATAHead - íîìåð íà÷àëüíîé ãîëîâêè;               *
+;* ATAHead - номер начальной головки;               *
-;* ATAAddressMode - ðåæèì àäðåñàöèè (0-CHS, 1-LBA); *
+;* ATAAddressMode - режим адресации (0-CHS, 1-LBA); *
-;* ATACommand - êîä êîìàíäû.                        *
+;* ATACommand - код команды.                        *
-;* Ïîñëå óñïåøíîãî âûïîëíåíèÿ ôóíêöèè:              *
+;* После успешного выполнения функции:              *
-;* â ATABasePortAddr - áàçîâûé àäðåñ HDD;           *
+;* в ATABasePortAddr - базовый адрес HDD;           *
-;* â DevErrorCode - íîëü.                           *
+;* в DevErrorCode - ноль.                           *
-;* Ïðè âîçíèêíîâåíèè îøèáêè â DevErrorCode áóäåò    *
+;* При возникновении ошибки в DevErrorCode будет    *
-;* âîçâðàùåí êîä îøèáêè â eax                       *
+;* возвращен код ошибки в eax                       *
 ;****************************************************
 SendCommandToHDD_1:
 ;        pushad
-;        mov   	[DevErrorCode],0	not need
+;        mov    [DevErrorCode],0        not need
-; Ïðîâåðèòü çíà÷åíèå êîäà ðåæèìà
+; Проверить значение кода режима
         cmp     [ATAAddressMode], 1
         ja      @@Err2_4
-; Ïðîâåðèòü êîððåêòíîñòü íîìåðà êàíàëà
+; Проверить корректность номера канала
         mov     BX, [ChannelNumber]
         cmp     BX, 1
         jb      @@Err3_4
         cmp     BX, 2
         ja      @@Err3_4
-; Óñòàíîâèòü áàçîâûé àäðåñ
+; Установить базовый адрес
         dec     BX
         shl     BX, 1
         movzx   ebx, bx
         mov     AX, [ebx+StandardATABases]
         mov     [ATABasePortAddr], AX
-; Îæèäàíèå ãîòîâíîñòè HDD ê ïðèåìó êîìàíäû
+; Ожидание готовности HDD к приему команды
-        ; Âûáðàòü íóæíûé äèñê
+        ; Выбрать нужный диск
         mov     DX, [ATABasePortAddr]
-        add     DX, 6   ;àäðåñ ðåãèñòðà ãîëîâîê
+        add     DX, 6   ;адрес регистра головок
         mov     AL, [DiskNumber]
-        cmp     AL, 1   ;ïðîâåðèòü íîìåðà äèñêà
+        cmp     AL, 1   ;проверить номера диска
         ja      @@Err4_4
         shl     AL, 4
         or      AL, 10100000b
         out     DX, AL
-        ; Îæèäàòü, ïîêà äèñê íå áóäåò ãîòîâ
+        ; Ожидать, пока диск не будет готов
         inc     DX
         mov     eax, [timer_ticks]
         mov     [TickCounter_1], eax
         mov     ecx, NoTickWaitTime
 ;        test   ecx,ecx
-        jz     @@Err1_4
+        jz      @@Err1_4
-        jmp    .test
+        jmp     .test
 @@:
         call    change_task
-        ; Ïðîâåðèòü âðåìÿ îæèäàíèÿ
+        ; Проверить время ожидания
         mov     eax, [timer_ticks]
         sub     eax, [TickCounter_1]
-        cmp     eax, BSYWaitTime;300    ;îæèäàòü 3 ñåê.
+        cmp     eax, BSYWaitTime;300    ;ожидать 3 сек.
-        ja      @@Err1_4   ;îøèáêà òàéì-àóòà
+        ja      @@Err1_4   ;ошибка тайм-аута
-        ; Ïðî÷èòàòü ðåãèñòð ñîñòîÿíèÿ
+        ; Прочитать регистр состояния
 .test:
         in      AL, DX
-        ; Ïðîâåðèòü ñîñòîÿíèå ñèãíàëà BSY
+        ; Проверить состояние сигнала BSY
         test    AL, 80h
         jnz     @@WaitHDReady_2
-        ; Ïðîâåðèòü ñîñòîÿíèå ñèãíàëà DRQ
+        ; Проверить состояние сигнала DRQ
         test    AL, 08h
         jnz     @@WaitHDReady_2
-; Çàãðóçèòü êîìàíäó â ðåãèñòðû êîíòðîëëåðà
+; Загрузить команду в регистры контроллера
         cli
         mov     DX, [ATABasePortAddr]
-        inc     DX      ;ðåãèñòð "îñîáåííîñòåé"
+        inc     DX      ;регистр "особенностей"
         mov     AL, [ATAFeatures]
         out     DX, AL
-        inc     DX      ;ñ÷åò÷èê ñåêòîðîâ
+        inc     DX      ;счетчик секторов
         mov     AL, [ATASectorCount]
         out     DX, AL
-        inc     DX      ;ðåãèñòð íîìåðà ñåêòîðà
+        inc     DX      ;регистр номера сектора
         mov     AL, [ATASectorNumber]
         out     DX, AL
-        inc     DX      ;íîìåð öèëèíäðà (ìëàäøèé áàéò)
+        inc     DX      ;номер цилиндра (младший байт)
         mov     AX, [ATACylinder]
         out     DX, AL
-        inc     DX      ;íîìåð öèëèíäðà (ñòàðøèé áàéò)
+        inc     DX      ;номер цилиндра (старший байт)
         mov     AL, AH
         out     DX, AL
-        inc     DX      ;íîìåð ãîëîâêè/íîìåð äèñêà
+        inc     DX      ;номер головки/номер диска
         mov     AL, [DiskNumber]
         shl     AL, 4
-        cmp     [ATAHead], 0Fh;ïðîâåðèòü íîìåð ãîëîâêè
+        cmp     [ATAHead], 0Fh;проверить номер головки
         ja      @@Err5_4
         or      AL, [ATAHead]
         or      AL, 10100000b
         mov     AH, [ATAAddressMode]
         shl     AH, 6
         or      AL, AH
         out     DX, AL
-; Ïîñëàòü êîìàíäó
+; Послать команду
         mov     AL, [ATACommand]
-        inc     DX      ;ðåãèñòð êîìàíä
+        inc     DX      ;регистр команд
         out     DX, AL
         sti
-; Ñáðîñèòü ïðèçíàê îøèáêè
+; Сбросить признак ошибки
 ;        mov     [DevErrorCode],0
 @@End_10:
         xor     eax, eax
-	ret
+        ret
-; Çàïèñàòü êîä îøèáêè
+; Записать код ошибки
 @@Err1_4:
         xor     eax, eax
-	inc	eax
+        inc     eax
 ;        mov     [DevErrorCode],1
 ;        mov     [DevErrorCode],4
-	ret
+        ret
 @@Err5_4:
         mov     eax, 5
 ;        mov     [DevErrorCode],5
-; Çàâåðøåíèå ðàáîòû ïðîãðàììû
+; Завершение работы программы
-	ret
+        ret
 ;        sti
 ;        popad
 ;*************************************************
-;*    ÎÆÈÄÀÍÈÅ ÃÎÒÎÂÍÎÑÒÈ ÓÑÒÐÎÉÑÒÂÀ Ê ÐÀÁÎÒÅ    *
+;*    ОЖИДАНИЕ ГОТОВНОСТИ УСТРОЙСТВА К РАБОТЕ    *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 WaitUnitReady:
         pusha
-; Çàïîìíèòü âðåìÿ íà÷àëà îïåðàöèè
+; Запомнить время начала операции
         mov     EAX, [timer_ticks]
         mov     [WURStartTime], EAX
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Ñôîðìèðîâàòü êîìàíäó TEST UNIT READY
+; Сформировать команду TEST UNIT READY
         mov     [PacketCommand], word 00h
-; ÖÈÊË ÎÆÈÄÀÍÈß ÃÎÒÎÂÍÎÑÒÈ ÓÑÒÐÎÉÑÒÂÀ
+; ЦИКЛ ОЖИДАНИЯ ГОТОВНОСТИ УСТРОЙСТВА
         mov     ecx, NoTickWaitTime
 @@SendCommand:
-        ; Ïîäàòü êîìàíäó ïðîâåðêè ãîòîâíîñòè
+        ; Подать команду проверки готовности
         call    SendPacketNoDatCommand
         cmp     [timer_ticks_enable], 0
         jne     @f
         cmp     [DevErrorCode], 0
 ;        cmp     ecx,0
         jz      .Error
         jmp     @@SendCommand
 @@:
         call    change_task
-        ; Ïðîâåðèòü êîä îøèáêè
+        ; Проверить код ошибки
         cmp     [DevErrorCode], 0
         je      @@End_11
-        ; Ïðîâåðèòü âðåìÿ îæèäàíèÿ ãîòîâíîñòè
+        ; Проверить время ожидания готовности
         mov     EAX, [timer_ticks]
         sub     EAX, [WURStartTime]
         cmp     EAX, MaxCDWaitTime
         jb      @@SendCommand
 .Error:
-        ; Îøèáêà òàéì-àóòà
+        ; Ошибка тайм-аута
         mov     [DevErrorCode], 1
 @@End_11:
         popa
         ret
 ;*************************************************
-;*            ÇÀÏÐÅÒÈÒÜ ÑÌÅÍÓ ÄÈÑÊÀ              *
+;*            ЗАПРЕТИТЬ СМЕНУ ДИСКА              *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 prevent_medium_removal:
         pusha
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Çàäàòü êîä êîìàíäû
+; Задать код команды
         mov     [PacketCommand], byte 0x1E
-; Çàäàòü êîä çàïðåòà
+; Задать код запрета
         mov     [PacketCommand+4], byte 11b
-; Ïîäàòü êîìàíäó
+; Подать команду
-        call SendPacketNoDatCommand
+        call    SendPacketNoDatCommand
         mov     eax, ATAPI_IDE0_lock
         add     eax, [cdpos]
-        dec  eax
+        dec     eax
         mov     [eax], byte 1
         popa
         ret
 ;*************************************************
-;*            ÐÀÇÐÅØÈÒÜ ÑÌÅÍÓ ÄÈÑÊÀ              *
+;*            РАЗРЕШИТЬ СМЕНУ ДИСКА              *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 allow_medium_removal:
         pusha
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Çàäàòü êîä êîìàíäû
+; Задать код команды
         mov     [PacketCommand], byte 0x1E
-; Çàäàòü êîä çàïðåòà
+; Задать код запрета
         mov     [PacketCommand+4], byte 00b
-; Ïîäàòü êîìàíäó
+; Подать команду
-        call SendPacketNoDatCommand
+        call    SendPacketNoDatCommand
         mov     eax, ATAPI_IDE0_lock
         add     eax, [cdpos]
-        dec  eax
+        dec     eax
         mov     [eax], byte 0
         popa
         ret
 ;*************************************************
-;*         ÇÀÃÐÓÇÈÒÜ ÍÎÑÈÒÅËÜ Â ÄÈÑÊÎÂÎÄ         *
+;*         ЗАГРУЗИТЬ НОСИТЕЛЬ В ДИСКОВОД         *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 LoadMedium:
         pusha
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Ñôîðìèðîâàòü êîìàíäó START/STOP UNIT
+; Сформировать команду START/STOP UNIT
-        ; Çàäàòü êîä êîìàíäû
+        ; Задать код команды
         mov     [PacketCommand], word 1Bh
-        ; Çàäàòü îïåðàöèþ çàãðóçêè íîñèòåëÿ
+        ; Задать операцию загрузки носителя
         mov     [PacketCommand+4], word 00000011b
-; Ïîäàòü êîìàíäó
+; Подать команду
         call    SendPacketNoDatCommand
         popa
         ret
 ;*************************************************
-;*         ÈÇÂËÅ×Ü ÍÎÑÈÒÅËÜ ÈÇ ÄÈÑÊÎÂÎÄÀ         *
+;*         ИЗВЛЕЧЬ НОСИТЕЛЬ ИЗ ДИСКОВОДА         *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðìåííûå:                                    *
+;* перменные:                                    *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 EjectMedium:
         pusha
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Ñôîðìèðîâàòü êîìàíäó START/STOP UNIT
+; Сформировать команду START/STOP UNIT
-        ; Çàäàòü êîä êîìàíäû
+        ; Задать код команды
         mov     [PacketCommand], word 1Bh
-        ; Çàäàòü îïåðàöèþ èçâëå÷åíèÿ íîñèòåëÿ
+        ; Задать операцию извлечения носителя
         mov     [PacketCommand+4], word 00000010b
-; Ïîäàòü êîìàíäó
+; Подать команду
         call    SendPacketNoDatCommand
         popa
         ret
 ;*************************************************
-;* Ïðîâåðèòü ñîáûòèå íàæàòèÿ êíîïêè èçâëå÷åíèÿ   *
+;* Проверить событие нажатия кнопки извлечения   *
-;*                     äèñêà                     *
+;*                     диска                     *
+;* Входные параметры передаются через глобальные *
+;* переменные:                                   *
+;* ChannelNumber - номер канала;                 *
+;* DiskNumber - номер диска на канале.           *
+;*************************************************
+proc check_ATAPI_device_event_has_work?
+        mov     eax, [timer_ticks]
+        sub     eax, [timer_ATAPI_check]
+        cmp     eax, 100
+        jb      .no
+.yes:
+        xor     eax, eax
+        inc     eax
+        ret
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+.no:
-;* ïåðåìåííûå:                                   *
+        xor     eax, eax
-;* ChannelNumber - íîìåð êàíàëà;                 *
+        ret
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+endp
 ;*************************************************
 ATAPI_IDE2_lock db 0
 ATAPI_IDE3_lock db 0
 ignore_CD_eject_wait db 0
 endg
 ;*************************************************
-;* Ïîëó÷èòü ñîîáùåíèå î ñîáûòèè èëè ñîñòîÿíèè    *
+;* Получить сообщение о событии или состоянии    *
-;*                  óñòðîéñòâà                   *
+;*                  устройства                   *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðåìåííûå:                                   *
+;* переменные:                                   *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 GetEvent_StatusNotification:
         pusha
         mov     [CDDataBuf_pointer], CDDataBuf
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Çàäàòü êîä êîìàíäû
+; Задать код команды
         mov     [PacketCommand], byte 4Ah
         mov     [PacketCommand+1], byte 00000001b
-; Çàäàòü çàïðîñ êëàññà ñîîáùåíèé
+; Задать запрос класса сообщений
         mov     [PacketCommand+4], byte 00010000b
-; Ðàçìåð âûäåëåííîé îáëàñòè
+; Размер выделенной области
         mov     [PacketCommand+7], byte 8h
         mov     [PacketCommand+8], byte 0h
-; Ïîäàòü êîìàíäó
+; Подать команду
         call    SendPacketDatCommand
         popa
         ret
 ;*************************************************
-; ïðî÷èòàòü èíôîðìàöèþ èç TOC
+; прочитать информацию из TOC
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðåìåííûå:                                   *
+;* переменные:                                   *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 Read_TOC:
         pusha
         mov     [CDDataBuf_pointer], CDDataBuf
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
-        call  clear_packet_buffer
+        call    clear_packet_buffer
-; Ñôîðìèðîâàòü ïàêåòíóþ êîìàíäó äëÿ ñ÷èòûâàíèÿ
+; Сформировать пакетную команду для считывания
-; ñåêòîðà äàííûõ
+; сектора данных
         mov     [PacketCommand], byte 0x43
-        ; Çàäàòü ôîðìàò
+        ; Задать формат
         mov     [PacketCommand+2], byte 1
-; Ðàçìåð âûäåëåííîé îáëàñòè
+; Размер выделенной области
         mov     [PacketCommand+7], byte 0xFF
         mov     [PacketCommand+8], byte 0h
-; Ïîäàòü êîìàíäó
+; Подать команду
-        call  SendPacketDatCommand
+        call    SendPacketDatCommand
         popa
         ret
 ;*************************************************
-;* ÎÏÐÅÄÅËÈÒÜ ÎÁÙÅÅ ÊÎËÈ×ÅÑÒÂÎ ÑÅÊÒÎÐÎÂ ÍÀ ÄÈÑÊÅ *
+;* ОПРЕДЕЛИТЬ ОБЩЕЕ КОЛИЧЕСТВО СЕКТОРОВ НА ДИСКЕ *
-;* Âõîäíûå ïàðàìåòðû ïåðåäàþòñÿ ÷åðåç ãëîáàëüíûå *
+;* Входные параметры передаются через глобальные *
-;* ïåðåìåííûå:                                   *
+;* переменные:                                   *
-;* ChannelNumber - íîìåð êàíàëà;                 *
+;* ChannelNumber - номер канала;                 *
-;* DiskNumber - íîìåð äèñêà íà êàíàëå.           *
+;* DiskNumber - номер диска на канале.           *
 ;*************************************************
 ;ReadCapacity:
 ;       pusha
-;; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+;; Очистить буфер пакетной команды
 ;       call  clear_packet_buffer
-;; Çàäàòü ðàçìåð áóôåðà â áàéòàõ
+;; Задать размер буфера в байтах
 ;       mov     [CDBlockSize],8
-;; Ñôîðìèðîâàòü êîìàíäó READ CAPACITY
+;; Сформировать команду READ CAPACITY
 ;       mov     [PacketCommand],word 25h
-;; Ïîäàòü êîìàíäó
+;; Подать команду
 ;       call    SendPacketDatCommand
 ;       popa
 ;       ret
 clear_packet_buffer:
-; Î÷èñòèòü áóôåð ïàêåòíîé êîìàíäû
+; Очистить буфер пакетной команды
         and     [PacketCommand], dword 0

Subversion Repositories Kolibri OS

(root)/kernel/branches/Kolibri-acpi/blkdev/cd_drv.inc – Rev 2465 → 3555