4 * Home page of code is: http://smartmontools.sourceforge.net
6 * Copyright (C) 2012 Hank Wu <hank@areca.com.tw>
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, or (at your option)
13 * You should have received a copy of the GNU General Public License
14 * (for example COPYING); If not, see <http://www.gnu.org/licenses/>.
21 #include "dev_interface.h"
22 #include "dev_areca.h"
24 const char * dev_areca_cpp_cvsid
= "$Id: dev_areca.cpp 3872 2014-02-03 21:07:51Z chrfranke $"
32 #if 0 // For debugging areca code
33 static void dumpdata(unsigned char *block
, int len
)
35 int ln
= (len
/ 16) + 1; // total line#
39 printf(" Address = %p, Length = (0x%x)%d\n", block
, len
, len
);
40 printf(" 0 1 2 3 4 5 6 7 8 9 A B C D E F ASCII \n");
41 printf("=====================================================================\n");
43 for ( int l
= 0; l
< ln
&& len
; l
++ )
45 // printf the line# and the HEX data
46 // if a line data length < 16 then append the space to the tail of line to reach 16 chars
48 for ( pos
= 0; pos
< 16 && len
; pos
++, len
-- )
56 for ( int loop
= pos
; loop
< 16; loop
++ )
63 for ( int loop
= 0; loop
< pos
; loop
++ )
66 if ( c
>= 0x20 && c
<= 0x7F )
77 printf("=====================================================================\n");
81 generic_areca_device::generic_areca_device(smart_interface
* intf
, const char * dev_name
, int disknum
, int encnum
)
82 : smart_device(intf
, dev_name
, "areca", "areca"),
86 set_info().info_name
= strprintf("%s [areca_disk#%02d_enc#%02d]", dev_name
, disknum
, encnum
);
89 generic_areca_device::~generic_areca_device() throw()
95 // This is an interface routine meant to isolate the OS dependent
96 // parts of the code, and to provide a debugging interface. Each
97 // different port and OS needs to provide it's own interface. This
98 // is the Windows interface to the Areca "arcmsr" driver. It allows ATA
99 // commands to be passed through the SCSI driver.
100 // DETAILED DESCRIPTION OF ARGUMENTS
101 // fd: is the file descriptor provided by open()
102 // disknum is the disk number (0 to 127) in the RAID array
103 // command: defines the different operations.
104 // select: additional input data if needed (which log, which type of
106 // data: location to write output data, if needed (512 bytes).
107 // Note: not all commands use all arguments.
109 // -1 if the command failed
110 // 0 if the command succeeded,
111 // STATUS_CHECK routine:
112 // -1 if the command failed
113 // 0 if the command succeeded and disk SMART status is "OK"
114 // 1 if the command succeeded and disk SMART status is "FAILING"
115 int generic_areca_device::arcmsr_command_handler(unsigned long arcmsr_cmd
, unsigned char *data
, int data_len
)
117 if (arcmsr_cmd
>= ARCMSR_CMD_TOTAL
)
120 static const unsigned int cmds
[ARCMSR_CMD_TOTAL
] =
122 ARCMSR_IOCTL_READ_RQBUFFER
,
123 ARCMSR_IOCTL_WRITE_WQBUFFER
,
124 ARCMSR_IOCTL_CLEAR_RQBUFFER
,
125 ARCMSR_IOCTL_CLEAR_WQBUFFER
,
126 ARCMSR_IOCTL_RETURN_CODE_3F
131 struct scsi_cmnd_io iop
;
132 int dir
= DXFER_TO_DEVICE
;
137 unsigned char *areca_return_packet
;
140 unsigned char return_buff
[2048]={0};
141 unsigned char *ptr
= &return_buff
[0];
143 memset((unsigned char *)&sBuf
, 0, sizeof(sBuf
));
144 memset(&iop
, 0, sizeof(iop
));
146 sBuf
.srbioctl
.HeaderLength
= sizeof(sARCMSR_IO_HDR
);
147 memcpy(sBuf
.srbioctl
.Signature
, ARECA_SIG_STR
, strlen(ARECA_SIG_STR
));
148 sBuf
.srbioctl
.Timeout
= 10000;
149 sBuf
.srbioctl
.ControlCode
= cmds
[arcmsr_cmd
];
151 switch ( arcmsr_cmd
)
153 // command for writing data to driver
154 case ARCMSR_WRITE_WQBUFFER
:
155 if ( data
&& data_len
)
157 sBuf
.srbioctl
.Length
= data_len
;
158 memcpy((unsigned char *)sBuf
.ioctldatabuffer
, (unsigned char *)data
, data_len
);
160 // commands for clearing related buffer of driver
161 case ARCMSR_CLEAR_RQBUFFER
:
162 case ARCMSR_CLEAR_WQBUFFER
:
163 cdb
[0] = 0x3B; //SCSI_WRITE_BUF command;
165 // command for reading data from driver
166 case ARCMSR_READ_RQBUFFER
:
167 // command for identifying driver
168 case ARCMSR_RETURN_CODE_3F
:
169 cdb
[0] = 0x3C; //SCSI_READ_BUF command;
170 dir
= DXFER_FROM_DEVICE
;
173 // unknown arcmsr commands
179 cdb
[5] = cmds
[arcmsr_cmd
] >> 24;
180 cdb
[6] = cmds
[arcmsr_cmd
] >> 16;
181 cdb
[7] = cmds
[arcmsr_cmd
] >> 8;
182 cdb
[8] = cmds
[arcmsr_cmd
] & 0x0F;
185 iop
.dxfer_len
= sizeof(sBuf
);
186 iop
.dxferp
= (unsigned char *)&sBuf
;
188 iop
.cmnd_len
= sizeof(cdb
);
190 iop
.max_sense_len
= sizeof(sense
);
191 iop
.timeout
= SCSI_TIMEOUT_DEFAULT
;
195 ioctlreturn
= arcmsr_do_scsi_io(&iop
);
196 if(ioctlreturn
|| iop
.scsi_status
)
201 if ( arcmsr_cmd
!= ARCMSR_READ_RQBUFFER
)
203 // if succeeded, just returns the length of outgoing data
207 if ( sBuf
.srbioctl
.Length
)
209 memcpy(ptr
, &sBuf
.ioctldatabuffer
[0], sBuf
.srbioctl
.Length
);
210 ptr
+= sBuf
.srbioctl
.Length
;
211 total
+= sBuf
.srbioctl
.Length
;
212 // the returned bytes enough to compute payload length ?
213 if ( expected
< 0 && total
>= 5 )
215 areca_return_packet
= (unsigned char *)&return_buff
[0];
216 if ( areca_return_packet
[0] == 0x5E &&
217 areca_return_packet
[1] == 0x01 &&
218 areca_return_packet
[2] == 0x61 )
220 // valid header, let's compute the returned payload length,
221 // we expected the total length is
222 // payload + 3 bytes header + 2 bytes length + 1 byte checksum
223 expected
= areca_return_packet
[4] * 256 + areca_return_packet
[3] + 6;
227 if ( total
>= 7 && total
>= expected
)
229 //printf("total bytes received = %d, expected length = %d\n", total, expected);
231 // ------ Okay! we received enough --------
237 // Deal with the different error cases
238 if ( arcmsr_cmd
== ARCMSR_RETURN_CODE_3F
)
240 // Silence the ARCMSR_IOCTL_RETURN_CODE_3F's error, no pout(...)
246 pout("do_scsi_cmnd_io with write buffer failed code = %x\n", ioctlreturn
);
250 if ( iop
.scsi_status
)
252 pout("io_hdr.scsi_status with write buffer failed code = %x\n", iop
.scsi_status
);
258 memcpy(data
, return_buff
, total
);
264 bool generic_areca_device::arcmsr_probe()
271 if(arcmsr_command_handler(ARCMSR_RETURN_CODE_3F
, NULL
, 0) != 0)
278 int generic_areca_device::arcmsr_ui_handler(unsigned char *areca_packet
, int areca_packet_len
, unsigned char *result
)
281 unsigned char return_buff
[2048];
282 unsigned char cs
= 0;
285 // ----- ADD CHECKSUM -----
286 cs_pos
= areca_packet_len
- 1;
287 for(int i
= 3; i
< cs_pos
; i
++)
289 areca_packet
[cs_pos
] += areca_packet
[i
];
296 expected
= arcmsr_command_handler(ARCMSR_CLEAR_RQBUFFER
, NULL
, 0);
300 expected
= arcmsr_command_handler(ARCMSR_CLEAR_WQBUFFER
, NULL
, 0);
301 expected
= arcmsr_command_handler(ARCMSR_WRITE_WQBUFFER
, areca_packet
, areca_packet_len
);
304 expected
= arcmsr_command_handler(ARCMSR_READ_RQBUFFER
, return_buff
, sizeof(return_buff
));
317 // ----- VERIFY THE CHECKSUM -----
319 for ( int loop
= 3; loop
< expected
- 1; loop
++ )
321 cs
+= return_buff
[loop
];
324 if ( return_buff
[expected
- 1] != cs
)
329 memcpy(result
, return_buff
, expected
);
334 int generic_areca_device::arcmsr_get_controller_type()
337 unsigned char return_buff
[2048];
338 unsigned char areca_packet
[] = {0x5E, 0x01, 0x61, 0x01, 0x00, 0x23, 0x00};
340 memset(return_buff
, 0, sizeof(return_buff
));
341 expected
= arcmsr_ui_handler(areca_packet
, sizeof(areca_packet
), return_buff
);
347 return return_buff
[0xc2];
350 int generic_areca_device::arcmsr_get_dev_type()
353 unsigned char return_buff
[2048];
355 int encnum
= get_encnum();
356 int disknum
= get_disknum();
357 unsigned char areca_packet
[] = {0x5E, 0x01, 0x61, 0x03, 0x00, 0x22,
358 (unsigned char)(disknum
- 1), (unsigned char)(encnum
- 1), 0x00};
360 memset(return_buff
, 0, sizeof(return_buff
));
361 expected
= arcmsr_ui_handler(areca_packet
, sizeof(areca_packet
), return_buff
);
367 ctlr_type
= arcmsr_get_controller_type();
374 if( ctlr_type
== 0x02/* SATA Controllers */ ||
375 (ctlr_type
== 0x03 /* SAS Controllers */ && return_buff
[0x52] & 0x01 /* SATA devices behind SAS Controller */) )
385 bool generic_areca_device::arcmsr_ata_pass_through(const ata_cmd_in
& in
, ata_cmd_out
& out
)
387 // ATA input registers
388 typedef struct _ATA_INPUT_REGISTERS
390 unsigned char features
;
391 unsigned char sector_count
;
392 unsigned char sector_number
;
393 unsigned char cylinder_low
;
394 unsigned char cylinder_high
;
395 unsigned char device_head
;
396 unsigned char command
;
397 unsigned char reserved
[8];
398 unsigned char data
[512]; // [in/out] buffer for outgoing/incoming data
399 } sATA_INPUT_REGISTERS
;
401 // ATA output registers
402 // Note: The output registers is re-sorted for areca internal use only
403 typedef struct _ATA_OUTPUT_REGISTERS
406 unsigned char status
;
407 unsigned char sector_count
;
408 unsigned char sector_number
;
409 unsigned char cylinder_low
;
410 unsigned char cylinder_high
;
411 } sATA_OUTPUT_REGISTERS
;
413 // Areca packet format for outgoing:
414 // B[0~2] : 3 bytes header, fixed value 0x5E, 0x01, 0x61
415 // B[3~4] : 2 bytes command length + variant data length, little endian
416 // B[5] : 1 bytes areca defined command code, ATA passthrough command code is 0x1c
417 // B[6~last-1] : variant bytes payload data
418 // B[last] : 1 byte checksum, simply sum(B[3] ~ B[last -1])
421 // header 3 bytes length 2 bytes cmd 1 byte payload data x bytes cs 1 byte
422 // +--------------------------------------------------------------------------------+
423 // + 0x5E 0x01 0x61 | 0x00 0x00 | 0x1c | .................... | 0x00 |
424 // +--------------------------------------------------------------------------------+
427 //Areca packet format for incoming:
428 // B[0~2] : 3 bytes header, fixed value 0x5E, 0x01, 0x61
429 // B[3~4] : 2 bytes payload length, little endian
430 // B[5~last-1] : variant bytes returned payload data
431 // B[last] : 1 byte checksum, simply sum(B[3] ~ B[last -1])
434 // header 3 bytes length 2 bytes payload data x bytes cs 1 byte
435 // +-------------------------------------------------------------------+
436 // + 0x5E 0x01 0x61 | 0x00 0x00 | .................... | 0x00 |
437 // +-------------------------------------------------------------------+
438 unsigned char areca_packet
[640];
439 int areca_packet_len
= sizeof(areca_packet
);
440 unsigned char return_buff
[2048];
443 sATA_INPUT_REGISTERS
*ata_cmd
;
447 memset(sInq
, 0, sizeof(sInq
));
448 scsiStdInquiry(fd
, (unsigned char *)sInq
, (int)sizeof(sInq
));
449 dumpdata((unsigned char *)sInq
, sizeof(sInq
));
451 memset(areca_packet
, 0, areca_packet_len
);
453 // ----- BEGIN TO SETUP HEADERS -------
454 areca_packet
[0] = 0x5E;
455 areca_packet
[1] = 0x01;
456 areca_packet
[2] = 0x61;
457 areca_packet
[3] = (unsigned char)((areca_packet_len
- 6) & 0xff);
458 areca_packet
[4] = (unsigned char)(((areca_packet_len
- 6) >> 8) & 0xff);
459 areca_packet
[5] = 0x1c; // areca defined code for ATA passthrough command
461 // ----- BEGIN TO SETUP PAYLOAD DATA -----
462 memcpy(&areca_packet
[7], "SmrT", 4); // areca defined password
463 ata_cmd
= (sATA_INPUT_REGISTERS
*)&areca_packet
[12];
467 const ata_in_regs
& r
= in
.in_regs
;
468 ata_cmd
->features
= r
.features
;
469 ata_cmd
->sector_count
= r
.sector_count
;
470 ata_cmd
->sector_number
= r
.lba_low
;
471 ata_cmd
->cylinder_low
= r
.lba_mid
;
472 ata_cmd
->cylinder_high
= r
.lba_high
;
473 ata_cmd
->device_head
= r
.device
;
474 ata_cmd
->command
= r
.command
;
476 bool readdata
= false;
477 if (in
.direction
== ata_cmd_in::data_in
) {
479 // the command will read data
480 areca_packet
[6] = 0x13;
482 else if ( in
.direction
== ata_cmd_in::no_data
)
484 // the commands will return no data
485 areca_packet
[6] = 0x15;
487 else if (in
.direction
== ata_cmd_in::data_out
)
489 // the commands will write data
490 memcpy(ata_cmd
->data
, in
.buffer
, in
.size
);
491 areca_packet
[6] = 0x14;
494 // COMMAND NOT SUPPORTED VIA ARECA IOCTL INTERFACE
495 return set_err(ENOSYS
);
498 areca_packet
[11] = get_disknum() - 1; // disk#
499 areca_packet
[19] = get_encnum() - 1; // enc#
501 // ----- BEGIN TO SEND TO ARECA DRIVER ------
502 expected
= arcmsr_ui_handler(areca_packet
, areca_packet_len
, return_buff
);
508 sATA_OUTPUT_REGISTERS
*ata_out
= (sATA_OUTPUT_REGISTERS
*)&return_buff
[5] ;
509 if ( ata_out
->status
)
511 if ( in
.in_regs
.command
== ATA_IDENTIFY_DEVICE
512 && !nonempty((unsigned char *)in
.buffer
, in
.size
))
514 return set_err(ENODEV
, "No drive on port %d", get_disknum());
521 memcpy(in
.buffer
, &return_buff
[7], in
.size
);
524 // Return register values
526 ata_out_regs
& r
= out
.out_regs
;
527 r
.error
= ata_out
->error
;
528 r
.sector_count
= ata_out
->sector_count
;
529 r
.lba_low
= ata_out
->sector_number
;
530 r
.lba_mid
= ata_out
->cylinder_low
;
531 r
.lba_high
= ata_out
->cylinder_high
;
532 r
.status
= ata_out
->status
;
537 bool generic_areca_device::arcmsr_scsi_pass_through(struct scsi_cmnd_io
* iop
)
539 // Areca packet format for outgoing:
540 // B[0~2] : 3 bytes header, fixed value 0x5E, 0x01, 0x61
541 // B[3~4] : 2 bytes command length + variant data length, little endian
542 // B[5] : 1 bytes areca defined command code
543 // B[6~last-1] : variant bytes payload data
544 // B[last] : 1 byte checksum, simply sum(B[3] ~ B[last -1])
547 // header 3 bytes length 2 bytes cmd 1 byte payload data x bytes cs 1 byte
548 // +--------------------------------------------------------------------------------+
549 // + 0x5E 0x01 0x61 | 0x00 0x00 | 0x1c | .................... | 0x00 |
550 // +--------------------------------------------------------------------------------+
553 //Areca packet format for incoming:
554 // B[0~2] : 3 bytes header, fixed value 0x5E, 0x01, 0x61
555 // B[3~4] : 2 bytes payload length, little endian
556 // B[5~last-1] : variant bytes returned payload data
557 // B[last] : 1 byte checksum, simply sum(B[3] ~ B[last -1])
560 // header 3 bytes length 2 bytes payload data x bytes cs 1 byte
561 // +-------------------------------------------------------------------+
562 // + 0x5E 0x01 0x61 | 0x00 0x00 | .................... | 0x00 |
563 // +-------------------------------------------------------------------+
564 unsigned char areca_packet
[640];
565 int areca_packet_len
= sizeof(areca_packet
);
566 unsigned char return_buff
[2048];
569 if (iop
->cmnd_len
> 16) {
570 set_err(EINVAL
, "cmnd_len too large");
574 memset(areca_packet
, 0, areca_packet_len
);
576 // ----- BEGIN TO SETUP HEADERS -------
577 areca_packet
[0] = 0x5E;
578 areca_packet
[1] = 0x01;
579 areca_packet
[2] = 0x61;
580 areca_packet
[3] = (unsigned char)((areca_packet_len
- 6) & 0xff);
581 areca_packet
[4] = (unsigned char)(((areca_packet_len
- 6) >> 8) & 0xff);
582 areca_packet
[5] = 0x1c;
584 // ----- BEGIN TO SETUP PAYLOAD DATA -----
585 areca_packet
[6] = 0x16; // scsi pass through
586 memcpy(&areca_packet
[7], "SmrT", 4); // areca defined password
587 areca_packet
[12] = iop
->cmnd_len
; // cdb length
588 memcpy( &areca_packet
[35], iop
->cmnd
, iop
->cmnd_len
); // cdb
589 areca_packet
[15] = (unsigned char)iop
->dxfer_len
; // 15(LSB) ~ 18(MSB): data length ( max=512 bytes)
590 areca_packet
[16] = (unsigned char)(iop
->dxfer_len
>> 8);
591 areca_packet
[17] = (unsigned char)(iop
->dxfer_len
>> 16);
592 areca_packet
[18] = (unsigned char)(iop
->dxfer_len
>> 24);
593 if(iop
->dxfer_dir
== DXFER_TO_DEVICE
)
595 areca_packet
[13] |= 0x01;
596 memcpy(&areca_packet
[67], iop
->dxferp
, iop
->dxfer_len
);
598 else if (iop
->dxfer_dir
== DXFER_FROM_DEVICE
)
601 else if( iop
->dxfer_dir
== DXFER_NONE
)
605 // COMMAND NOT SUPPORTED VIA ARECA IOCTL INTERFACE
606 return set_err(ENOSYS
);
609 areca_packet
[11] = get_disknum() - 1; // disk#
610 areca_packet
[19] = get_encnum() - 1; // enc#
612 // ----- BEGIN TO SEND TO ARECA DRIVER ------
613 expected
= arcmsr_ui_handler(areca_packet
, areca_packet_len
, return_buff
);
616 return set_err(EIO
, "arcmsr_scsi_pass_through: I/O error");
617 if (expected
< 15) // 7 bytes if port is empty
618 return set_err(EIO
, "arcmsr_scsi_pass_through: missing data (%d bytes, expected %d)", expected
, 15);
620 int scsi_status
= return_buff
[5];
621 int in_data_len
= return_buff
[11] | return_buff
[12] << 8 | return_buff
[13] << 16 | return_buff
[14] << 24;
623 if (iop
->dxfer_dir
== DXFER_FROM_DEVICE
)
625 memset(iop
->dxferp
, 0, iop
->dxfer_len
); // need?
626 memcpy(iop
->dxferp
, &return_buff
[15], in_data_len
);
629 if(scsi_status
== 0xE1 /* Underrun, actual data length < requested data length */)
631 // don't care, just ignore
635 if(scsi_status
!= 0x00 && scsi_status
!= SCSI_STATUS_CHECK_CONDITION
)
640 if(scsi_status
== SCSI_STATUS_CHECK_CONDITION
)
643 iop
->scsi_status
= SCSI_STATUS_CHECK_CONDITION
;
644 iop
->resp_sense_len
= 4;
645 iop
->sensep
[0] = return_buff
[7];
646 iop
->sensep
[1] = return_buff
[8];
647 iop
->sensep
[2] = return_buff
[9];
648 iop
->sensep
[3] = return_buff
[10];
654 /////////////////////////////////////////////////////////////
655 areca_ata_device::areca_ata_device(smart_interface
* intf
, const char * dev_name
, int disknum
, int encnum
)
656 : smart_device(intf
, dev_name
, "areca", "areca")
659 set_disknum(disknum
);
660 set_info().info_name
= strprintf("%s [areca_disk#%02d_enc#%02d]", dev_name
, disknum
, encnum
);
663 areca_ata_device::~areca_ata_device() throw()
668 bool areca_ata_device::ata_pass_through(const ata_cmd_in
& in
, ata_cmd_out
& out
)
670 if (!ata_cmd_is_supported(in
,
671 ata_device::supports_data_out
|
672 ata_device::supports_output_regs
|
673 //ata_device::supports_multi_sector | // TODO
674 ata_device::supports_48bit_hi_null
,
679 return arcmsr_ata_pass_through(in
, out
);
682 /////////////////////////////////////////////////////////////
683 areca_scsi_device::areca_scsi_device(smart_interface
* intf
, const char * dev_name
, int disknum
, int encnum
)
684 : smart_device(intf
, dev_name
, "areca", "areca")
687 set_disknum(disknum
);
688 set_info().info_name
= strprintf("%s [areca_disk#%02d_enc#%02d]", dev_name
, disknum
, encnum
);
691 areca_scsi_device::~areca_scsi_device() throw()
696 bool areca_scsi_device::scsi_pass_through(struct scsi_cmnd_io
* iop
)
698 return arcmsr_scsi_pass_through(iop
);