1228940SdelphijRocketRAID Controller Driver for FreeBSD 2228940SdelphijCopyright (C) 2011 HighPoint Technologies, Inc. All rights reserved. 3228940Sdelphij 4228940Sdelphij############################################################################# 5228940SdelphijRevision History: 6228940Sdelphij v1.0 2011-12-27 7228940Sdelphij First source code release 8228940Sdelphij 9228940Sdelphij############################################################################# 10228940Sdelphij 11228940Sdelphij1. Overview 12228940Sdelphij--------------------- 13228940Sdelphij This package contains FreeBSD driver source code for HighPoint RocketRAID 14228940Sdelphij controller, include: 15228940Sdelphij SAS Controller: RR271x, RR272x, RR274x, RR276x, RR278x. 16228940Sdelphij 17228940Sdelphij NO WARRANTY 18228940Sdelphij 19228940Sdelphij THE DRIVER SOURCE CODE HIGHPOINT PROVIDED IS FREE OF CHARGE, AND THERE IS 20228940Sdelphij NO WARRANTY FOR THE PROGRAM. THERE ARE NO RESTRICTIONS ON THE USE OF THIS 21228940Sdelphij FREE SOURCE CODE. HIGHPOINT DOES NOT PROVIDE ANY TECHNICAL SUPPORT IF THE 22228940Sdelphij CODE HAS BEEN CHANGED FROM ORIGINAL SOURCE CODE. 23228940Sdelphij 24228940Sdelphij LIMITATION OF LIABILITY 25228940Sdelphij 26228940Sdelphij IN NO EVENT WILL HIGHPOINT BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, 27228940Sdelphij INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR 28228940Sdelphij INABILITY TO USE THIS PRODUCT OR DOCUMENTATION, EVEN IF ADVISED OF THE 29228940Sdelphij POSSIBILITY OF SUCH DAMAGES. IN PARTICULAR, HIGHPOINT SHALL NOT HAVE 30228940Sdelphij LIABILITY FOR ANY HARDWARE, SOFTWARE, OR DATA STORED USED WITH THE 31228940Sdelphij PRODUCT, INCLUDING THE COSTS OF REPAIRING, REPLACING, OR RECOVERING 32228940Sdelphij SUCH HARDWARE, OR DATA. 33228940Sdelphij 34228940Sdelphij 35228940Sdelphij2. Rebuild the kernel with HighPoint RocketRAID support 36228940Sdelphij----------------------------------------------- 37228940Sdelphij 38228940Sdelphij 1) Install kernel source package and building tools. 39228940Sdelphij 40228940Sdelphij 2) Extract the driver files under the kernel source tree: 41228940Sdelphij 42228940Sdelphij # cd /usr/src/sys/ 43228940Sdelphij # tar xvzf /your/path/to/hpt27xx-freebsd-src-v1.0-111227.tgz 44228940Sdelphij 45228940Sdelphij 3) Update the kernel configuration file to include the HighPoint source. 46228940Sdelphij Assume the configure file is GENERIC, and new kernel configure file is 47228940Sdelphij MYKERNEL: 48228940Sdelphij 49228940Sdelphij # cd i386/conf (or amd64/conf for AMD64) 50228940Sdelphij # cp GENERIC MYKERNEL 51228940Sdelphij 52228940Sdelphij 4) Edit MYKERNEL, and add the following line under "RAID controllers 53228940Sdelphij interfaced to the SCSI subsystem": 54228940Sdelphij 55228940Sdelphij device "hpt27xx" #HighPoint RocketRAID 56228940Sdelphij 57228940Sdelphij 5) For i386 system, edit /usr/src/sys/conf/files.i386 and append the lines 58228940Sdelphij shown below: 59228940Sdelphij 60228940Sdelphij hpt27xx_lib.o optional hpt27xx \ 61228940Sdelphij dependency "$S/dev/hpt27xx/i386-elf.hpt27xx_lib.o.uu" \ 62228940Sdelphij compile-with "uudecode < $S/dev/hpt27xx/i386-elf.hpt27xx_lib.o.uu" \ 63228940Sdelphij no-implicit-rule 64228940Sdelphij 65228940Sdelphij dev/hpt27xx/os_bsd.c optional hpt27xx 66228940Sdelphij dev/hpt27xx/osm_bsd.c optional hpt27xx 67228940Sdelphij dev/hpt27xx/hpt27xx_config.c optional hpt27xx 68228940Sdelphij 69228940Sdelphij For amd64 system, edit /usr/src/sys/conf/files.amd64 and append the lines 70228940Sdelphij shown below: 71228940Sdelphij 72228940Sdelphij hpt27xx_lib.o optional hpt27xx \ 73228940Sdelphij dependency "$S/dev/hpt27xx/amd64-elf.hpt27xx_lib.o.uu" \ 74228940Sdelphij compile-with "uudecode < $S/dev/hpt27xx/amd64-elf.hpt27xx_lib.o.uu" \ 75228940Sdelphij no-implicit-rule 76228940Sdelphij 77228940Sdelphij dev/hpt27xx/os_bsd.c optional hpt27xx 78228940Sdelphij dev/hpt27xx/osm_bsd.c optional hpt27xx 79228940Sdelphij dev/hpt27xx/hpt27xx_config.c optional hpt27xx 80228940Sdelphij 81228940Sdelphij 6) Rebuild and install the kernel: 82228940Sdelphij 83228940Sdelphij a) for FreeBSD 5.x-i386/6.x-i386/7.x-i386/8.x-i386/9.x-i386: 84228940Sdelphij 85228940Sdelphij # cd /usr/src/sys/i386/conf/ 86228940Sdelphij # /usr/sbin/config MYKERNEL 87228940Sdelphij # cd ../compile/MYKERNEL/ 88228940Sdelphij # make depend 89228940Sdelphij # make 90228940Sdelphij # make install 91228940Sdelphij 92228940Sdelphij b) for FreeBSD 5.x-amd64/6.x-amd64/7.x-amd64/8.x-amd64/9.x-amd64: 93228940Sdelphij 94228940Sdelphij # cd /usr/src/sys/amd64/conf/ 95228940Sdelphij # /usr/sbin/config MYKERNEL 96228940Sdelphij # cd ../compile/MYKERNEL/ 97228940Sdelphij # make depend 98228940Sdelphij # make 99228940Sdelphij # make install 100228940Sdelphij 101228940Sdelphij c) for FreeBSD 4.x: 102228940Sdelphij 103228940Sdelphij # cd /usr/src/sys/i386/conf/ 104228940Sdelphij # /usr/sbin/config MYKERNEL 105228940Sdelphij # cd ../../compile/MYKERNEL/ 106228940Sdelphij # make depend 107228940Sdelphij # make 108228940Sdelphij # make install 109228940Sdelphij 110228940Sdelphij If the driver was previously configured as an auto-loaded module by 111228940Sdelphij /boot/defaults/loader.conf, please remove the entry hpt27xx_load="YES" 112228940Sdelphij from loader.conf to prevent the driver from being loaded twice. 113228940Sdelphij 114228940Sdelphij 7) Reboot from the new kernel. 115228940Sdelphij 116228940Sdelphij 117228940Sdelphij3. Build/Load the driver as a kernel module 118228940Sdelphij------------------------------------------------ 119228940Sdelphij 120228940Sdelphij 1) Install kernel source package and building tools. 121228940Sdelphij 122228940Sdelphij 2) Extract the driver files under the kernel source tree: 123228940Sdelphij 124228940Sdelphij # cd /usr/src/sys/ 125228940Sdelphij # tar xvzf /your/path/to/hpt27xx-freebsd-src-v1.0-111227.tgz 126228940Sdelphij 127228940Sdelphij 128228940Sdelphij 4) Build the driver module: 129228940Sdelphij 130228940Sdelphij # cd modules/hpt27xx 131228940Sdelphij # make 132228940Sdelphij 133228940Sdelphij 5) Copy the driver module to the kernel module directory 134228940Sdelphij 135228940Sdelphij For FreeBSD 4.x: 136228940Sdelphij 137228940Sdelphij # cp hpt27xx.ko /modules/ 138228940Sdelphij 139228940Sdelphij For FreeBSD 5.x/6.x/7.x/8.x/9.x: 140228940Sdelphij 141228940Sdelphij # cp hpt27xx.ko /boot/kernel/ 142228940Sdelphij 143228940Sdelphij 6) Reboot and load the driver under loader prompt. e.g: 144228940Sdelphij 145228940Sdelphij BTX loader 1.00 BTX version is 1.01 146228940Sdelphij Console: internal video/keyboard 147228940Sdelphij BIOS driver A: is disk0 148228940Sdelphij BIOS driver C: is disk2 149228940Sdelphij BIOS 636kB/74512kB available memory 150228940Sdelphij 151228940Sdelphij FreeBSD/i386 bootstrap loader, Revision 0.8 152228940Sdelphij (mailto:jkh@narf.osd.bsdi.com, Sat Apr 21 08:46:19 GMT 2001) 153228940Sdelphij Loading /boot/defaults/loader.conf 154228940Sdelphij /kernel text=0x24f1db data=0x3007ec+0x2062c - 155228940Sdelphij 156228940Sdelphij Hit [Enter] to boot immediagely, or any other key for command prompt. 157230133Suqs Booting [kernel] in 9 seconds 158228940Sdelphij 159228940Sdelphij <-- press SPACE key here 160228940Sdelphij Type '?' for a list of commands, 'help' for more detailed help. 161228940Sdelphij ok load hpt27xx 162228940Sdelphij /modules/hpt27xx.ko text=0xf571 data=0x2c8+0x254 163228940Sdelphij ok boot 164228940Sdelphij 165228940Sdelphij For FreeBSD 5.x/6.x/7.x/8.x/9.x, you can select 6 on the boot menu to get a loader 166228940Sdelphij prompt. 167228940Sdelphij 168228940Sdelphij 7) You can add a below line into /boot/defaults/loader.conf to load the 169228940Sdelphij driver automatically: 170228940Sdelphij 171228940Sdelphij hpt27xx_load="YES" 172228940Sdelphij 173228940Sdelphij Please refer to the installation guide in HighPoint FreeBSD driver release 174228940Sdelphij package for more information. 175228940Sdelphij 176228940Sdelphij 177228940Sdelphij############################################################################# 178228940SdelphijTechnical support and service 179228940Sdelphij 180228940Sdelphij If you have questions about installing or using your HighPoint product, 181228940Sdelphij check the user's guide or readme file first, and you will find answers to 182228940Sdelphij most of your questions here. If you need further assistance, please 183228940Sdelphij contact us. We offer the following support and information services: 184228940Sdelphij 185228940Sdelphij 1) The HighPoint Web Site provides information on software upgrades, 186228940Sdelphij answers to common questions, and other topics. The Web Site is 187228940Sdelphij available from Internet 24 hours a day, 7 days a week, at 188228940Sdelphij http://www.highpoint-tech.com. 189228940Sdelphij 190228940Sdelphij 2) For technical support, send e-mail to support@highpoint-tech.com 191228940Sdelphij 192228940Sdelphij NOTE: Before you send an e-mail, please visit our Web Site 193228940Sdelphij (http://www.highpoint-tech.com) to check if there is a new or 194228940Sdelphij updated device driver for your system. 195228940Sdelphij 196228940Sdelphij$FreeBSD$ 197