(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.8.2_REL.img of=/dev/da8 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
53
54 Before installing any application (X11) you need to edit your <b>/etc/rc.conf</b> file. Add the following to an existing file:
55
56     smbd_enable="YES"  #needed for samba share
57     nmbd_enable="YES"  #needed for samba share
58     hostname="yourhostname" #this is the name of your box
59
60     ifconfig_ae0="DHCP" #this is needed for LAN
61     wlans_ath0="wlan0"    #this is needed for WLAN
62     ifconfig_wlan0="WPA DHCP" #this is needed for WLAN
63
64     moused_enable="YES" #this is needed for keyboard and touchpad support
65     linux_enable="YES"  #this is needed for Openoffice etc  
66
67 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:
68
69         network={
70         ssid="network name"
71         psk="secret password"
72         }
73
74 Edit <b>/etc/host</b> file and add your user name (this is needed for XFCE4 to work without a problem).
75
76         127.0.0.1               yourname yourname.my.domain
77         
78 Now you just have to reboot and login again as a user.
79
80 If you want to install any applications follow [DragonFly instructions](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/).
81
82 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).
83
84 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):
85
86         http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.8.2/pkgsrc-2010Q3/All
87
88 Remember to disable (<b>#</b>) any other than DragonFly mirrors. 
89
90 Now you have to update pkgin and upgrade any applications that are already on your system by:
91
92         #pkgin update && pkgin full-upgrade
93
94 ## Installing X11
95
96 For X11, you can follow [DragonFly Installing X(http://www.dragonflybsd.org/docs/newhandbook/X/#index3h2)] main instructions and simply copy listed below <b>xorg.conf</b> to <b>/etc/X11/</b> directory (it has full support for mulitmonitor setup).
97
98    # pkgin in modular-xorg-server
99    # pkgin in  modular-xorg-drivers
100    # pkgin in  modular-xorg-libs
101    # pkgin in modular-xorg-apps
102    # pkgin in  modular-xorg-fonts
103
104 Ready to use eeepc 900 <b>xorg.conf</b>:
105
106         Section "ServerLayout"
107               Identifier     "X.org Configured"
108               Screen      0  "Screen0" 0 0
109               InputDevice    "Mouse0" "CorePointer"
110               InputDevice    "Keyboard0" "CoreKeyboard"
111         EndSection
112
113         Section "Files"
114               ModulePath   "/usr/pkg/lib/xorg/modules"
115               FontPath     "/usr/pkg/lib/X11/fonts/misc/"
116               FontPath     "/usr/pkg/lib/X11/fonts/TTF/"
117               FontPath     "/usr/pkg/lib/X11/fonts/OTF"
118               FontPath     "/usr/pkg/lib/X11/fonts/Type1/"
119               FontPath     "/usr/pkg/lib/X11/fonts/100dpi/"
120               FontPath     "/usr/pkg/lib/X11/fonts/75dpi/"
121         EndSection
122
123         Section "Module"
124               Load  "glx"
125               Load  "dbe"
126               Load  "extmod"
127               Load  "dri"
128               Load  "dri2"
129         EndSection
130
131        Section "InputDevice"
132               Identifier  "Keyboard0"
133               Driver      "kbd"
134               #Option      "XkbLayout"  #"insert your keyboard layout"  #for non-english users
135        EndSection
136
137        Section "InputDevice"
138               Identifier  "Mouse0"
139               Driver      "mouse"
140               Option        "Protocol" "auto"
141               Option        "Device" "/dev/sysmouse"
142               Option        "ZAxisMapping" "4 5 6 7"
143               Option        "Protocol"    "Auto"
144               Option      "Protocol"    "/dev/psm0"
145        EndSection
146
147        Section "Monitor"
148               Identifier   "Monitor0"
149               VendorName   "Monitor Vendor"
150               ModelName    "Monitor Model"
151               HorizSync    30-107
152               VertRefresh  48-120
153               Option       "DPMS"
154        EndSection
155
156        Section "Device"
157               ### Available Driver options are:-
158               ### Values: <i>: integer, <f>: float, <bool>: "True"/"False",
159               ### <string>: "String", <freq>: "<f> Hz/kHz/MHz"
160               ### [arg]: arg optional
161               #Option     "NoAccel"             # [<bool>]
162               #Option     "SWcursor"            # [<bool>]
163               #Option     "ColorKey"            # <i>
164               #Option     "CacheLines"          # <i>
165               #Option     "Dac6Bit"             # [<bool>]
166               #Option     "DRI"                 # [<bool>]
167               #Option     "NoDDC"               # [<bool>]
168               #Option     "ShowCache"           # [<bool>]
169               #Option     "XvMCSurfaces"        # <i>
170               #Option     "PageFlip"            # [<bool>]
171               Identifier  "Card0"
172               Driver      "intel"
173               VendorName  "Unknown Vendor"
174               BoardName   "Unknown Board"
175               BusID       "PCI:0:2:0"
176       EndSection
177
178       Section "Screen"
179              Identifier "Screen0"
180              Device     "Card0"
181              Monitor    "Monitor0"
182              SubSection "Display"
183                 Viewport   0 0
184                 Depth     24
185              Virtual 2048 2048
186              EndSubSection
187      EndSection
188
189      Section "ServerFlags"
190              Option "DontZap"         "off"
191              Option "AllowEmptyInput" "off"
192              Option "AutoAddDevices"  "off"
193      EndSection
194
195
196 Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
197
198 ## ACPI and power management
199
200 There is no issues in running with ACPI.
201
202    
203 Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
204
205 For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
206
207     $ sysctl hw.acpi.asus
208     hw.acpi.asus.lcd_brightness: 1
209     hw.acpi.asus.camera: 0
210     hw.acpi.asus.cardreader: 1
211     hw.acpi.asus.wlan: 1
212
213 ## Video controller 
214
215 Video playback is okay. The chipset in use is Intel 945GM. 
216
217 ## Ethernet controller 
218
219 Works without any problem with ae(4).
220
221 ## Wireless card(s) 
222
223 Works fine
224
225 ## Audio 
226
227 Works fine
228
229 ## SD card reader 
230
231 Works fine
232
233 ## Camera
234
235 Not supported.