mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-15 10:17:20 +00:00
9bcb275009
This driver was generously developed and donated by Highpoint. It is enabled for i386 only at the moment. I will enable it for amd64 shortly. Obtained from: HighPoint Technologies, Inc.
203 lines
6.6 KiB
Plaintext
203 lines
6.6 KiB
Plaintext
RocketRAID 232x Controller Driver for FreeBSD
|
||
Copyright (C) 2005 HighPoint Technologies, Inc. All rights reserved.
|
||
|
||
#############################################################################
|
||
Revision History:
|
||
|
||
v1.02 02/20/2006
|
||
Add RR2322 support
|
||
|
||
v1.01 2005-8-30
|
||
First source code release
|
||
|
||
$FreeBSD$
|
||
|
||
#############################################################################
|
||
|
||
1. Overview
|
||
---------------------
|
||
This package contains FreeBSD driver source code for HighPoint RocketRAID
|
||
232x SATA controller.
|
||
|
||
NO WARRANTY
|
||
|
||
THE DRIVER SOURCE CODE HIGHPOINT PROVIDED IS FREE OF CHARGE, AND THERE IS
|
||
NO WARRANTY FOR THE PROGRAM. THERE ARE NO RESTRICTIONS ON THE USE OF THIS
|
||
FREE SOURCE CODE. HIGHPOINT DOES NOT PROVIDE ANY TECHNICAL SUPPORT IF THE
|
||
CODE HAS BEEN CHANGED FROM ORIGINAL SOURCE CODE.
|
||
|
||
LIMITATION OF LIABILITY
|
||
|
||
IN NO EVENT WILL HIGHPOINT BE LIABLE FOR DIRECT, INDIRECT, SPECIAL,
|
||
INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR
|
||
INABILITY TO USE THIS PRODUCT OR DOCUMENTATION, EVEN IF ADVISED OF THE
|
||
POSSIBILITY OF SUCH DAMAGES. IN PARTICULAR, HIGHPOINT SHALL NOT HAVE
|
||
LIABILITY FOR ANY HARDWARE, SOFTWARE, OR DATA STORED USED WITH THE
|
||
PRODUCT, INCLUDING THE COSTS OF REPAIRING, REPLACING, OR RECOVERING
|
||
SUCH HARDWARE, OR DATA.
|
||
|
||
|
||
2. Rebuild the kernel with RR232x support
|
||
--------------------------------------------
|
||
|
||
1) Install kernel source package and building tools.
|
||
|
||
2) Extract the driver files under the kernel source tree:
|
||
|
||
# cd /usr/src/sys/
|
||
# tar xvzf /your/path/to/rr232x-freebsd-src.tgz
|
||
|
||
3) Update the kernel configuration file to include the HighPoint source.
|
||
Assume the configure file is GENERIC, and new kernel configure file is
|
||
MYKERNEL:
|
||
|
||
# cd i386/conf (or amd64/conf for AMD64)
|
||
# cp GENERIC MYKERNEL
|
||
|
||
4) Edit MYKERNEL, and add the following line under "RAID controllers
|
||
interfaced to the SCSI subsystem":
|
||
|
||
device "rr232x" #HighPoint RocketRAID 232x
|
||
|
||
5) For i386 system, edit /usr/src/sys/conf/files.i386 and append the lines
|
||
shown below:
|
||
|
||
rr232x_lib.o optional rr232x \
|
||
dependency "$S/dev/rr232x/i386-elf.rr232x_lib.o.uu" \
|
||
compile-with "uudecode < $S/dev/rr232x/i386-elf.rr232x_lib.o.uu" \
|
||
no-implicit-rule
|
||
|
||
dev/rr232x/os_bsd.c optional rr232x
|
||
dev/rr232x/osm_bsd.c optional rr232x
|
||
dev/rr232x/rr232x_config.c optional rr232x
|
||
|
||
For amd64 system, edit /usr/src/sys/conf/files.amd64 and append the lines
|
||
shown below:
|
||
|
||
rr232x_lib.o optional rr232x \
|
||
dependency "$S/dev/rr232x/amd64-elf.rr232x_lib.o.uu" \
|
||
compile-with "uudecode < $S/dev/rr232x/amd64-elf.rr232x_lib.o.uu" \
|
||
no-implicit-rule
|
||
|
||
dev/rr232x/os_bsd.c optional rr232x
|
||
dev/rr232x/osm_bsd.c optional rr232x
|
||
dev/rr232x/rr232x_config.c optional rr232x
|
||
|
||
Note FreeBSD 5.3/5.4 i386 already have a built-in RR232x driver, you should
|
||
replace the old configuration lines with the lines listed above.
|
||
|
||
|
||
6) Rebuild and install the kernel:
|
||
|
||
a) for FreeBSD 5.x-i386:
|
||
|
||
# cd /usr/src/sys/i386/conf/
|
||
# /usr/sbin/config MYKERNEL
|
||
# cd ../compile/MYKERNEL/
|
||
# make depend
|
||
# make
|
||
# make install
|
||
|
||
b) for FreeBSD 5.x-amd64:
|
||
|
||
# cd /usr/src/sys/amd64/conf/
|
||
# /usr/sbin/config MYKERNEL
|
||
# cd ../compile/MYKERNEL/
|
||
# make depend
|
||
# make
|
||
# make install
|
||
|
||
c) for FreeBSD 4.x:
|
||
|
||
# cd /usr/src/sys/i386/conf/
|
||
# /usr/sbin/config MYKERNEL
|
||
# cd ../../compile/MYKERNEL/
|
||
# make depend
|
||
# make
|
||
# make install
|
||
|
||
If the driver was previously configured as an auto-loaded module by
|
||
/boot/defaults/loader.conf, please remove the entry rr232x_load="YES"
|
||
from loader.conf to prevent the driver from being loaded twice.
|
||
|
||
7) Reboot from the new kernel.
|
||
|
||
|
||
3. Build/Load the driver as a kernel module
|
||
------------------------------------------------
|
||
|
||
1) Install kernel source package and building tools.
|
||
|
||
2) Extract the driver files under the kernel source tree:
|
||
|
||
# cd /usr/src/sys/
|
||
# tar xvzf /your/path/to/rr232x-opensource-v1.12-bsd.tgz
|
||
|
||
|
||
4) Build the driver module:
|
||
|
||
# cd modules/rr232x
|
||
# make
|
||
|
||
5) Copy the driver module to the kernel module directory
|
||
|
||
For FreeBSD 4.x:
|
||
|
||
# cp rr232x.ko /modules/
|
||
|
||
For FreeBSD 5.x:
|
||
|
||
# cp rr232x.ko /boot/kernel/
|
||
|
||
6) Reboot and load the driver under loader prompt. e.g:
|
||
|
||
BTX loader 1.00 BTX version is 1.01
|
||
Console: internal video/keyboard
|
||
BIOS driver A: is disk0
|
||
BIOS driver C: is disk2
|
||
BIOS 636kB/74512kB available memory
|
||
|
||
FreeBSD/i386 bootstrap loader, Revision 0.8
|
||
(mailto:jkh@narf.osd.bsdi.com, Sat Apr 21 08:46:19 GMT 2001)
|
||
Loading /boot/defaults/loader.conf
|
||
/kernel text=0x24f1db data=0x3007ec+0x2062c -
|
||
|
||
Hit [Enter] to boot immediagely, or any other key for command prompt.
|
||
Booting [kernel] in 9 seconds<64><73>
|
||
|
||
<-- press SPACE key here
|
||
Type '?' for a list of commands, 'help' for more detailed help.
|
||
ok load rr232x
|
||
/modules/rr232x.ko text=0xf571 data=0x2c8+0x254
|
||
ok boot
|
||
|
||
For FreeBSD 5.x, you can select 6 on the boot menu to get a loader prompt.
|
||
|
||
7) You can add a below line into /boot/defaults/loader.conf to load the
|
||
driver automatically:
|
||
|
||
rr232x_load="YES"
|
||
|
||
Please refer to the installation guide in HighPoint FreeBSD driver release
|
||
package for more information.
|
||
|
||
|
||
#############################################################################
|
||
Technical support and service
|
||
|
||
If you have questions about installing or using your HighPoint product,
|
||
check the user's guide or readme file first, and you will find answers to
|
||
most of your questions here. If you need further assistance, please
|
||
contact us. We offer the following support and information services:
|
||
|
||
1) The HighPoint Web Site provides information on software upgrades,
|
||
answers to common questions, and other topics. The Web Site is
|
||
available from Internet 24 hours a day, 7 days a week, at
|
||
http://www.highpoint-tech.com.
|
||
|
||
2) For technical support, send e-mail to support@highpoint-tech.com
|
||
|
||
NOTE: Before you send an e-mail, please visit our Web Site
|
||
(http://www.highpoint-tech.com) to check if there is a new or
|
||
updated device driver for your system.
|