source: xtideuniversalbios/trunk/XTIDE_Universal_BIOS/Src/Device/Serial/SerialCommand.asm @ 376

Last change on this file since 376 was 376, checked in by gregli@…, 12 years ago

WIDE checkin... Added copyright and license information to sorce files, as per the GPL instructions for usage.

File size: 7.7 KB
Line 
1; Project name  :   XTIDE Universal BIOS
2; Description   :   Serial Device Command functions.
3
4;
5; XTIDE Universal BIOS and Associated Tools 
6; Copyright (C) 2009-2010 by Tomi Tilli, 2011-2012 by XTIDE Universal BIOS Team.
7;
8; This program is free software; you can redistribute it and/or modify
9; it under the terms of the GNU General Public License as published by
10; the Free Software Foundation; either version 2 of the License, or
11; (at your option) any later version.
12; 
13; This program is distributed in the hope that it will be useful,
14; but WITHOUT ANY WARRANTY; without even the implied warranty of
15; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16; GNU General Public License for more details.     
17; Visit http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
18;       
19
20; Section containing code
21SECTION .text
22
23%define SERIALSERVER_AH_ALREADY_HAS_COMMAND_BYTE
24%define SERIALSERVER_NO_ZERO_SECTOR_COUNTS     
25
26;--------------------------------------------------------------------
27; SerialCommand_OutputWithParameters
28;   Parameters:
29;       BH:     Non-zero if 48-bit addressing used
30;               (ignored at present as 48-bit addressing is not supported)
31;       BL:     IDE Status Register bit to poll after command
32;               (ignored at present, since there is no IDE status register to poll)
33;       ES:SI:  Ptr to buffer (for data transfer commands)
34;       DS:DI:  Ptr to DPT (in RAMVARS segment)
35;       SS:BP:  Ptr to IDEREGS_AND_INTPACK
36;   Returns:
37;       AH:     INT 13h Error Code
38;       CX:     Number of successfully transferred sectors (for transfer commands)
39;       CF:     Cleared if success, Set if error
40;   Corrupts registers:
41;       AL, BX, CX, DX, (ES:SI for data transfer commands)
42;--------------------------------------------------------------------
43ALIGN JUMP_ALIGN
44SerialCommand_OutputWithParameters:
45
46        mov     ah,SerialServer_Command_Read
47
48        mov     al,[bp+IDEPACK.bCommand]
49
50        cmp     al,20h          ; Read Sectors IDE command
51        jz      .readOrWrite
52        inc     ah              ; now SerialServer_Protocol_Write
53        cmp     al,30h          ; Write Sectors IDE command
54        jz      .readOrWrite
55
56;  all other commands return success
57;  including function 0ech which should return drive information, this is handled with the identify functions
58;
59        xor     ah,ah           ;  also clears carry
60        ret
61
62.readOrWrite:
63        mov     [bp+IDEPACK.bFeatures],ah       ; store protocol command
64               
65        mov     dx, [di+DPT_SERIAL.wSerialPortAndBaud]
66
67ALIGN JUMP_ALIGN
68SerialCommand_FallThroughToSerialServer_SendReceive:
69
70%include "SerialServer.asm"
71
72%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS       
73    %if SerialCommand_FallThroughToSerialServer_SendReceive <> SerialServer_SendReceive
74        %error "SerialServer_SendReceive must be the first routine at the top of SerialServer.asm in the Assembly_Library"
75    %endif
76%endif
77
78ALIGN JUMP_ALIGN       
79SerialCommand_ReturnError:     
80        stc
81        ret     
82
83;--------------------------------------------------------------------
84; SerialCommand_IdentifyDeviceToBufferInESSIwithDriveSelectByteInBH
85;   Parameters:
86;       BH:     Drive Select byte for Drive and Head Select Register
87;       DS:     Segment to RAMVARS
88;       ES:SI:  Ptr to buffer to receive 512-byte IDE Information
89;       CS:BP:  Ptr to IDEVARS
90;   Returns:
91;       CF:     Cleared if success, Set if error
92;   Corrupts registers:
93;       AL, BL, CX, DX, SI, DI, ES
94;--------------------------------------------------------------------
95ALIGN JUMP_ALIGN
96SerialCommand_IdentifyDeviceToBufferInESSIwithDriveSelectByteInBH:
97;
98; To improve boot time, we do our best to avoid looking for slave serial drives when we already know the results
99; from the looking for a master.  This is particularly true when doing a COM port scan, as we will end up running
100; through all the COM ports and baud rates a second time.
101;
102; But drive detection isn't the only case - we also need to get the right drive when called on int13h/25h.
103;
104; The decision tree:
105;
106;    Master:
107;          wSerialPortAndBaud Non-Zero:           -> Continue with wSerialPortAndBaud (1)
108;          wSerialPortAndBaud Zero:
109;              previous serial drive not found:   -> Scan (2)
110;              previous serial drive found:       -> Continue with previous serial drive info (3)
111;
112;    Slave:
113;          wSerialPortAndBaud Non-Zero:
114;              previous serial drive not found:   -> Error - Not Found (4)
115;              previous serial drive found:       -> Continue with wSerialPackedAndBaud (5)
116;          wSerialPortAndBaud Zero:
117;              previous serial drive not found:   -> Error - Not Found (4)
118;              previous serial drive found:       -> Continue with previous serial drive info (6)
119;
120; (1) This was a port/baud that was explicitly set with the configurator.  In the drive detection case, as this
121;     is the Master, we are checking out a new controller, and so don't care if we already have a serial drive.
122;     And as with the int13h/25h case, we just go off and get the needed information using the user's setting.
123; (2) We are using the special .ideVarsSerialAuto structure.  During drive detection, we would only be here
124;     if we hadn't already seen a serial drive (since we only scan if no explicit drives are set),
125;     so we go off to scan.
126; (3) We are using the special .ideVarsSerialAuto structure.  We won't get here during drive detection, but
127;     we might get here on an int13h/25h call.  If we have scanned COM drives, they are the ONLY serial drives
128;     in use, and so we use the values from the previously seen serial drive DPT.
129; (4) No master has been found yet, therefore no slave should be found.  Avoiding the slave reduces boot time,
130;     especially in the full COM port scan case.  Note that this is different from the hardware IDE, where we
131;     will scan for a slave even if a master is not present.  Note that if ANY master had been previously found,
132;     we will do the slave scan, which isn't harmful, it just wastes time.  But the most common case (by a wide
133;     margin) will be just one serial controller.
134; (5) A COM port scan for a master had been previously completed, and a drive was found.  In a multiple serial
135;     controller scenario being called with int13h/25h, we need to use the value in bSerialPackedPortAndBaud
136;     to make sure we get the proper drive.
137; (6) A COM port scan for a master had been previously completed, and a drive was found.  We would only get here
138;     if no serial drive was explicitly set by the user in the configurator or that drive had not been found.
139;     Instead of performing the full COM port scan for the slave, use the port/baud value stored during the
140;     master scan.
141;
142        mov     dx,[cs:bp+IDEVARS.wSerialPortAndBaud]
143        xor     ax,ax
144       
145        push    si
146        call    FindDPT_ToDSDIforSerialDevice
147        pop     si
148%ifdef MODULE_SERIAL_FLOPPY
149        jnc     .founddpt
150;
151; If not found above with FindDPT_ToDSDIforSerialDevice, DI will point to the DPT after the last hard disk DPT
152; So, if there was a previously found floppy disk, DI will point to that DPT and we use that value for the slave.
153;
154        cmp     byte [RAMVARS.xlateVars+XLATEVARS.bFlopCntAndFirst], 0
155        jz      .notfounddpt
156.founddpt:
157%else
158        jc      .notfounddpt
159%endif
160        mov     ax, [di+DPT_SERIAL.wSerialPortAndBaud]
161.notfounddpt:
162
163        test    bh, FLG_DRVNHEAD_DRV
164        jz      .master
165
166        test    ax,ax           ; Take care of the case that is different between master and slave.
167        jz      SerialCommand_ReturnError
168
169; fall-through
170.master:
171        test    dx,dx
172        jnz     .identifyDeviceInDX
173
174        xchg    dx, ax          ;  move ax to dx (move previously found serial drive to dx, could be zero)
175
176.identifyDeviceInDX:
177
178ALIGN JUMP_ALIGN
179SerialCommand_FallThroughToSerialServerScan_ScanForServer:     
180       
181%include "SerialServerScan.asm"
182
183%ifndef CHECK_FOR_UNUSED_ENTRYPOINTS               
184    %if SerialCommand_FallThroughToSerialServerScan_ScanForServer <> SerialServerScan_ScanForServer
185        %error "SerialServerScan_ScanForServer must be the first routine at the top of SerialServerScan.asm in the Assembly_Library"
186    %endif
187%endif
188
189
Note: See TracBrowser for help on using the repository browser.