  
		     ARECA SATA/SAS RAID Controller:


			for FreeBSD 10.3 Release

  ===================  Driver User's Guide  =======================

	Areca RAID driver technical support
	   support@areca.com.tw
	   Web site: www.areca.com.tw
  =================================================================


*********************************************************************************
*  1. Contents     
*********************************************************************************
readme.txt  - The readme file for ARECA FreeBSD RAID driver
arcmsr-freebsd103.zip - areca Raid adapter driver for freebsd release 10.3 
arcmsr-1.50.00.03-20210504-freebsd.zip     - areca driver source code

*********************************************************************************
*  2. The first-time installation
*********************************************************************************

A. Before Installing

	a. Decompress arcmsr-freebsd103.zip file by:

		pkunzip arcmsr-freebsd103.zip 	-->amd64
						-->i386
		where drivers in amd64 directory is for FreeBSD 10.3 AMD64
		      drivers in i386 directory is for FreeBSD 10.3 i386(x86)

	c. copy drivers in amd64 or i386 to a USB flash drive or a floppy diskette.



B. Installation

	a. Installing system

		1 Insert the FreeBSD Installation CD/DVD.
		2 Insert the flash/floppy drive or diskette.
		3 Restart your computer.
		4 When the FreeBSD start screen opens, select 3 to Escape to loader prompt.
		5 Type "lsdev" to find flash/floppy drive disk number. Here, we assume it is disk1.
		6 Type "load cd0:boot/kernel/kernel", press Enter
		  Type "load disk1s1:arcmsr.ko"
		7 Type "boot" to complete the FreeBSD installation.
		8. After system is installed completely, Exit installation and reboot.

		Eject CD/DVD disc and reboot the system. (Leave USB Flash drive as it was)
		
	b. Updating driver module arcmsr.ko  ---- !!! IMPORTANT IMPORTANT !!!

		1. Restart your computer.
		2. When the FreeBSD start screen opens, select 3 to Escape to loader prompt.
		3. Type "lsdev" to find USB Flash drive disk number. Here, we assume it is disk5.
		   And assume boot disk partition is disk0s1a.
		4. Type "load disk0s1a:boot/kernel/kernel", press Enter
		   Type "load disk5s1:arcmsr.ko", press Enter
		5. Type "boot" to boot the FreeBSD system.
		6. login as root.
		  (USB Flash drive has been in its place)
		
		Type following commands to install the arcmsr.ko and loader.conf

		# cd /
		# mount_msdosfs /dev/da5s1 /mnt			( USB Flash drive always be the last da device, assume it is da5)
		# cp -f /mnt/arcmsr.ko /boot/kernel
		# echo 'arcmsr_load="YES"' >> /boot/loader.conf
		# umount /mnt
		# reboot

		Eject USB Flash drive and reboot the system.


*********************************************************************************
*  3. To install arcmsr driver into an existing freebsd system
*********************************************************************************

	a. Decompress arcmsr-freebsd103.zip to arcmsr.ko and loader.conf
	b. Type following command to install arcmsr driver
	   # cp arcmsr.ko /boot/kernel
	   # echo 'arcmsr_load="YES"' >> /boot/loader.conf
	c. Restart computer

************************************************************************
*  4. To compile the arcmsr.ko module and update arcmsr driver only
************************************************************************

    You should have installed FreeBSD kernel source code before compile the arcmsr.ko module.

	a. Decompress arcmsr-1.50.00.03-20210504-freebsd.zip to arcmsr.c and arcmsr.h
	b. copy arcmsr.c and arcmsr.h to /usr/src/sys/dev/arcmsr directory.
	c. # cd /usr/src/sys/modules/arcmsr
	d. # make
	e. # cp arcmsr.ko /boot/kernel
	f. # echo 'arcmsr_load="YES"' >> /boot/loader.conf
	g. # reboot

************************************************************************
*  5. To configure the system and Remake the kernel
************************************************************************
   
    You should have installed FreeBSD kernel source code before building a new kernel.
    
	**************************************
	* in arcmsr-1.50.00.03-20210504-freebsd.zip has files arcmsr.c and arcmsr.h
	* please copy arcmsr.c and arcmsr.h into /usr/src/sys/dev/arcmsr directory
	**************************************

	ls /usr/src/sys/dev/arcmsr

	arcmsr.c
	arcmsr.h

	====================================================================
	To Build a Kernel with arcmsr driver
	====================================================================
	*************************************
	* edit /usr/src/sys/amd64/conf/GENERIC
	*************************************

	device			arcmsr			# add this context description....
  	
	# cd /usr/src/
	# make buildkernel
	# make installkernel
	# reboot


