1RocketRAID 18xx Driver for FreeBSD 2Copyright (C) 2007-2008 HighPoint Technologies, Inc. All rights reserved. 3 4############################################################################# 5Revision History: 6 v1.16 2008-2-29 7 Fix 7.0 compile error. 8 9 v1.15 2007-8-6 10 Override kernel driver(built-in) to support over 2T RAID array. 11 12 v1.14 2006-3-21 13 Fix 48-bit LBA compatibility for Seagate drives. 14 Fix 16 bytes CDB support. 15 16 v1.13 2006-2-13 17 Fix fail LED/beeper control. 18 Add 16 bytes CDB support. 19 20 v1.12 2005-6-10 21 Fix over 4G memory support on amd64. 22 Fix disk flush problem. 23 24 v1.1 2004-9-23 25 Fix activity LED problem. 26 Cleanup diagnostic code. 27 28 v1.01 2004-5-24 29 First source code release 30 31############################################################################# 32 331. Overview 34--------------------- 35 This package contains FreeBSD driver source code for HighPoint RocketRAID 36 18xx SATA controller. 37 38 NO WARRANTY 39 40 THE DRIVER SOURCE CODE HIGHPOINT PROVIDED IS FREE OF CHARGE, AND THERE IS 41 NO WARRANTY FOR THE PROGRAM. THERE ARE NO RESTRICTIONS ON THE USE OF THIS 42 FREE SOURCE CODE. HIGHPOINT DOES NOT PROVIDE ANY TECHNICAL SUPPORT IF THE 43 CODE HAS BEEN CHANGED FROM ORIGINAL SOURCE CODE. 44 45 LIMITATION OF LIABILITY 46 47 IN NO EVENT WILL HIGHPOINT BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, 48 INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR 49 INABILITY TO USE THIS PRODUCT OR DOCUMENTATION, EVEN IF ADVISED OF THE 50 POSSIBILITY OF SUCH DAMAGES. IN PARTICULAR, HIGHPOINT SHALL NOT HAVE 51 LIABILITY FOR ANY HARDWARE, SOFTWARE, OR DATA STORED USED WITH THE 52 PRODUCT, INCLUDING THE COSTS OF REPAIRING, REPLACING, OR RECOVERING 53 SUCH HARDWARE, OR DATA. 54 55 562. Rebuild the kernel with RR18xx support 57-------------------------------------------- 58 59 1) Install kernel source package and building tools. 60 61 2) Extract the driver files under the kernel source tree: 62 63 # cd /usr/src/sys/ 64 # tar xvzf /your/path/to/rr18xx-opensource-v1.12-bsd.tgz 65 66 3) Update the kernel configuration file to include the HighPoint source. 67 Assume the configure file is GENERIC, and new kernel configure file is 68 MYKERNEL: 69 70 # cd i386/conf (or amd64/conf for AMD64) 71 # cp GENERIC MYKERNEL 72 73 4) Edit MYKERNEL, and add the following line under "RAID controllers 74 interfaced to the SCSI subsystem": 75 76 device hptmv #HighPoint RocketRAID 18xx 77 78 5) For i386 system, edit /usr/src/sys/conf/files.i386 and append the lines 79 shown below: 80 81 hptmvraid.o optional hptmv \ 82 dependency "$S/dev/hptmv/i386-elf.raid.o.uu" \ 83 compile-with "uudecode < $S/dev/hptmv/i386-elf.raid.o.uu" \ 84 no-implicit-rule 85 86 dev/hptmv/gui_lib.c optional hptmv 87 dev/hptmv/hptproc.c optional hptmv 88 dev/hptmv/ioctl.c optional hptmv 89 dev/hptmv/entry.c optional hptmv 90 dev/hptmv/mv.c optional hptmv 91 92 For amd64 system, edit /usr/src/sys/conf/files.amd64 and append the lines 93 shown below: 94 95 hptmvraid.o optional hptmv \ 96 dependency "$S/dev/hptmv/amd64-elf.raid.o.uu" \ 97 compile-with "uudecode < $S/dev/hptmv/amd64-elf.raid.o.uu" \ 98 no-implicit-rule 99 100 dev/hptmv/gui_lib.c optional hptmv 101 dev/hptmv/hptproc.c optional hptmv 102 dev/hptmv/ioctl.c optional hptmv 103 dev/hptmv/entry.c optional hptmv 104 dev/hptmv/mv.c optional hptmv 105 106 Note FreeBSD 5.3/5.4/6.x/7.x i386 already have a built-in RR18xx driver, 107 you should replace the old configuration lines with the lines listed above. 108 109 110 6) Rebuild and install the kernel: 111 112 a) for FreeBSD 5.x/6.x/7.x i386: 113 114 # cd /usr/src/sys/i386/conf/ 115 # /usr/sbin/config MYKERNEL 116 # cd ../compile/MYKERNEL/ 117 # make depend 118 # make 119 # make install 120 121 b) for FreeBSD 5.x/6.x/7.x amd64: 122 123 # cd /usr/src/sys/amd64/conf/ 124 # /usr/sbin/config MYKERNEL 125 # cd ../compile/MYKERNEL/ 126 # make depend 127 # make 128 # make install 129 130 c) for FreeBSD 4.x: 131 132 # cd /usr/src/sys/i386/conf/ 133 # /usr/sbin/config MYKERNEL 134 # cd ../../compile/MYKERNEL/ 135 # make depend 136 # make 137 # make install 138 139 If the driver was previously configured as an auto-loaded module by 140 /boot/defaults/loader.conf, please remove the entry hptmv_load="YES" 141 from loader.conf to prevent the driver from being loaded twice. 142 143 7) Reboot from the new kernel. 144 145 1463. Build/Load the driver as a kernel module 147------------------------------------------------ 148 149 1) Install kernel source package and building tools. 150 151 2) Extract the driver files under the kernel source tree: 152 153 # cd /usr/src/sys/ 154 # tar xvzf /your/path/to/rr18xx-opensource-v1.12-bsd.tgz 155 156 157 4) Build the driver module: 158 159 # cd modules/hptmv 160 # make 161 162 5) Copy the driver module to the kernel module directory 163 164 For FreeBSD 4.x: 165 166 # cp hptmv.ko /modules/ 167 168 For FreeBSD 5.x/6.x/7.x: 169 170 # cp hptmv.ko /boot/kernel/ 171 172 6) Reboot and load the driver under loader prompt. e.g: 173 174 BTX loader 1.00 BTX version is 1.01 175 Console: internal video/keyboard 176 BIOS driver A: is disk0 177 BIOS driver C: is disk2 178 BIOS 636kB/74512kB available memory 179 180 FreeBSD/i386 bootstrap loader, Revision 0.8 181 (mailto:jkh@narf.osd.bsdi.com, Sat Apr 21 08:46:19 GMT 2001) 182 Loading /boot/defaults/loader.conf 183 /kernel text=0x24f1db data=0x3007ec+0x2062c - 184 185 Hit [Enter] to boot immediagely, or any other key for command prompt. 186 Booting [kernel] in 9 seconds 187 188 <-- press SPACE key here 189 Type '?' for a list of commands, 'help' for more detailed help. 190 ok load hptmv 191 /modules/hptmv.ko text=0xf571 data=0x2c8+0x254 192 ok boot 193 194 For FreeBSD 5.x/6.x/7.x, you can select 6 on the boot menu to get a loader prompt. 195 196 7) You can add a below line into /boot/defaults/loader.conf to load the 197 driver automatically: 198 199 hptmv_load="YES" 200 201 Please refer to the installation guide in HighPoint FreeBSD driver release 202 package for more information. 203 204 205############################################################################# 206Technical support and service 207 208 If you have questions about installing or using your HighPoint product, 209 check the user's guide or readme file first, and you will find answers to 210 most of your questions here. If you need further assistance, please 211 contact us. We offer the following support and information services: 212 213 1) The HighPoint Web Site provides information on software upgrades, 214 answers to common questions, and other topics. The Web Site is 215 available from Internet 24 hours a day, 7 days a week, at 216 http://www.highpoint-tech.com. 217 218 2) For technical support, send e-mail to support@highpoint-tech.com 219 220 NOTE: Before you send an e-mail, please visit our Web Site 221 (http://www.highpoint-tech.com) to check if there is a new or 222 updated device driver for your system. 223