(no commit message)
[ikiwiki.git] / docs / user / asuseee900 / index.mdwn
1 # DragonFly on Asus EEE 900
2
3 [[!toc levels=2]]
4
5 ## Installation procedure
6
7 The easiest way to install DragonFly on an eee is to use the USB memory stick image. Download [.img file](http://www.dragonflybsd.org/download/#index1h2), open it with xarchiver (or similar). Then transfer it  directly to a USB key. Use dd on unix-like systems (or a similar program on Windows) eg.:
8
9 dd if=/path/to/dfly-i386-2.<b>x</b>.<b>x</b>_REL.img of=/dev/da<b>x</b> bs=1M
10  
11 Pressing "Escape" on the BIOS boot screen allows you to select the boot device (use your USB key). After a successful boot, you can install DragonFly on the SSD or SD-card (WARNING: this erases your SSD or SD-card!).
12
13 Now follow [this link](http://www.dragonflybsd.org/docs/newhandbook/Installation/) and install DragonFly on your eeepc 900. Note that you don't need any swap nor bootblocks to be installed on your system (unmark those default options).
14
15 Altouth it is recommended not to use HAMMER on small drives (below 50GB), you can use HAMMER with eeepc 20GB ssd drive without a problem.
16
17 Once DragonFly is installed, reboot and login as root. Now add your user account to wheel and operator group in <b>/etc/group</b>
18    
19 If your eeepc has 2 ssd drives (4 and 16GB) you need to add the 16GB drive to your DragonFly system.
20
21 First list all aveliable drives with:
22
23         # ls /dev/ad*
24         
25 You will get similar output:
26
27         > ls /dev/ad*
28         /dev/ad2        /dev/ad2s1a     /dev/ad3
29         /dev/ad2s1      /dev/ad2s1b     /dev/ad3s0
30         
31 Now repeat this but with following:
32
33         > ls /dev/serno*
34         OS1Q85001000517 OS1Q85001000517.s1a SOQ1580033
35         OS1Q85001000517.s1 OS1Q85001000517.s1b SOQ1580033.s0
36
37 In this example we have to add <b>/dev/ad3</b> called also <b>/serno/SOQ1580033</b> to hammerfs.
38
39 As root, use hammer volume-add utility to expand your hammerfs:
40
41         hammer volume-add /dev/ad3 /
42
43 Now you need to edit <b>/boot/loader.conf</b> (this is an example do not copy any rootmounts) :
44
45         vfs.root.mountfrom="hammer:serno/OS1Q85001000517.s1b:serno/SOQ1580033"
46         kern.emergency_intr_enable=1
47         if_ath_load="YES"                       #this will load wifi driver
48         acpi_asus_load="YES"            #this will load asus acpi
49         linux_load="YES"                        #this is needed if you want OpenOffice.org etc
50         snd_hda_load="YES"                      #this is needed for sound 
51
52 Before installing any application (X11) you need to edit your <b>/etc/rc.conf</b> file. Add the following to an existing file:
53
54         smbd_enable="YES"  #needed for samba share
55         nmbd_enable="YES"  #needed for samba share
56         hostname="yourhostname" #this is the name of your box
57
58         ifconfig_ae0="DHCP" #this is needed for LAN
59         wlans_ath0="wlan0"      #this is needed for WLAN
60         ifconfig_wlan0="WPA DHCP" #this is needed for WLAN
61
62         moused_enable="YES" #this is needed for keyboard and touchpad support
63         
64         linux_enable="YES" #this is needed for Openoffice etc
65 If you have and accss to wifi then create and edit with ee <b>/etc/wpa_supplicant.conf</b> file. Add the following for WPA2 encrypted wifi:
66
67         network={
68         ssid="network name"
69         psk="secret password"
70         }
71
72 Edit <b>/etc/host</b> file and add your user name (this is needed for XFCE4 to work without a problem).
73
74         127.0.0.1               yourname yourname.my.domain
75         
76 Now you just have to reboot and login again as a user.
77
78 If you want to install any applications follow [DragonFly instructions](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/).
79
80 I would recommend to use pkgin as long as it is possible and install pkgsrc (just in case it is needed - eg. for libdca-0.0.5 essential for vlc).
81
82 Before you can use pkgin you need to feed its config file <b>/usr/pkg/etc/pkgin/repositories.conf</b> with (eg. for pkgsrc-2010Q3 on DF-2.8.2):
83
84         http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.8.2/pkgsrc-2010Q3/All
85
86 Remember to disable (<b>#</b>) any other than DragonFly mirrors. 
87
88 Now you have to update pkgin and upgrade any applications that are already on your system by:
89
90         #pkgin update && pkgin full-upgrade
91
92         
93
94 Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
95
96 ## ACPI and power management
97
98 There is no issues in running with ACPI.
99
100    
101 Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
102
103 For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
104
105     $ sysctl hw.acpi.asus
106     hw.acpi.asus.lcd_brightness: 1
107     hw.acpi.asus.camera: 0
108     hw.acpi.asus.cardreader: 1
109     hw.acpi.asus.wlan: 1
110
111 ## Video controller 
112
113 Video playback is okay. The chipset in use is Intel 945GM. 
114
115 ## Ethernet controller 
116
117 Works without any problem with ae(4).
118
119 ## Wireless card(s) 
120
121 Works fine
122
123 ## Audio 
124
125 Works fine
126
127 ## SD card reader 
128
129 Works fine
130
131 ## Camera
132
133 Not supported.