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