(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 /home
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 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:
65
66         network={
67         ssid="network name"
68         psk="secret password"
69         }
70
71 Edit <b>/etc/host</b> file and add your user name (this is needed for XFCE4 to work without a problem).
72
73         127.0.0.1               yourname yourname.my.domain
74         
75 Now you just have to reboot and login again as a user.
76
77 If you want to install any applications follow [DragonFly instructions](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/).
78
79 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).
80
81 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):
82
83         http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.8.2/pkgsrc-2010Q3/All
84
85 Remember to disable (<b>#</b>) any other than DragonFly mirrors. 
86
87 Now you have to update pkgin and upgrade any applications that are already on your system by:
88
89         #pkgin update && pkgin full-upgrade
90
91         
92
93 Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
94
95 ## ACPI and power management
96
97 There is no issues in running with ACPI.
98
99    
100 Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
101
102 For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
103
104     $ sysctl hw.acpi.asus
105     hw.acpi.asus.lcd_brightness: 1
106     hw.acpi.asus.camera: 0
107     hw.acpi.asus.cardreader: 1
108     hw.acpi.asus.wlan: 1
109
110 ## Video controller 
111
112 Video playback is okay. The chipset in use is Intel 945GM. 
113
114 ## Ethernet controller 
115
116 Works without any problem with ae(4).
117
118 ## Wireless card(s) 
119
120 Works fine
121
122 ## Audio 
123
124 Works fine
125
126 ## SD card reader 
127
128 Works fine
129
130 ## Camera
131
132 Not supported.