cleanup
[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 -  instructions](http://www.dragonflybsd.org/docs/newhandbook/X/#index3h2) and simply copy attached below <b>xorg.conf</b> file to <b>/etc/X11/</b> directory (it has full support for mulitimonitor 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 ## How to mount Windows Shares with a GUI
197
198 To mount Windows shares at boot-time can follow [DragonFly instructions on HowToMountWindowsShares](http://www.dragonflybsd.org/docs/howtos/HowToMountWindowsShares/) .
199 If you don't want to mount them at boot time you can install gnome-commander (which should also install samba) and gnome-vfs-smb.
200
201     # pkgin in gnome-commander   
202     # pkgin in gnome-vfs-smb
203     # pkgin in samba
204
205 Now make sure that you have 
206
207     smbd_enable="YES" 
208     nmbd_enable="YES" 
209
210 in your <b>rc.conf</b> file.
211
212 Pkgin should automatically copy <b>/usr/pkg/share/examples/rc.d/nmbd</b> and <b>cd /usr/pkg/share/examples/rc.d/smbd</b> to <b>/etc/rc.d</b> directory. If it fails manually copy those files as root by:
213
214     # cp /usr/pkg/share/examples/rc.d/smbd /etc/rc.d/smbd
215     # cp cd /usr/pkg/share/examples/rc.d/nmbd /etc/rc.d/nmbd
216   
217 You can add DragonFly users (and their passwords) for sharing files by:
218
219     # smbpasswd -a username 
220
221 It is now the time to configure <b>smb.conf</b> file which is located in <b>/usr/pkg/etc/samba</b>. 
222
223 Now, to start samba deamon type in terminal (as root):
224
225     # /etc/rc.d/smbd start
226     # /etc/rc.d/nmbd start  
227
228 Open gnome-commander (X11 is essential for this application) and navigate to your Windows share directory (<b>smb</b> button)
229
230
231 Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
232
233 ## ACPI and power management
234
235 There is no issues in running with ACPI.
236
237    
238 Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
239
240 For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
241
242     $ sysctl hw.acpi.asus
243     hw.acpi.asus.lcd_brightness: 1
244     hw.acpi.asus.camera: 0
245     hw.acpi.asus.cardreader: 1
246     hw.acpi.asus.wlan: 1
247
248 ## Video controller 
249
250 Video playback is okay. The chipset in use is Intel 945GM. 
251
252 ## Ethernet controller 
253
254 Works without any problem with ae(4).
255
256 ## Wireless card(s) 
257
258 Works fine
259
260 ## Audio 
261
262 Works fine
263
264 ## SD card reader 
265
266 Works fine
267
268 ## Camera
269
270 Not supported.