(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
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         
95
96 Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
97
98 ## ACPI and power management
99
100 There is no issues in running with ACPI.
101
102    
103 Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
104
105 For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
106
107     $ sysctl hw.acpi.asus
108     hw.acpi.asus.lcd_brightness: 1
109     hw.acpi.asus.camera: 0
110     hw.acpi.asus.cardreader: 1
111     hw.acpi.asus.wlan: 1
112
113 ## Video controller 
114
115 Video playback is okay. The chipset in use is Intel 945GM. 
116
117 ## Ethernet controller 
118
119 Works without any problem with ae(4).
120
121 ## Wireless card(s) 
122
123 Works fine
124
125 ## Audio 
126
127 Works fine
128
129 ## SD card reader 
130
131 Works fine
132
133 ## Camera
134
135 Not supported.