(no commit message)
[ikiwiki.git] / docs / user / asuseee900 / index.mdwn
index a71dcd8..925a800 100644 (file)
-# DragonFly on Lenovo Thinkpad X61s 
+# DragonFly on Asus EEE 900
 
 [[!toc levels=2]]
 
-Following experience is from running DragonFly 2.3.2 development on laptop.
+## Installation procedure
 
-    $ sudo lspci -nn
+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.:
 
-## Kernel and system in general 
+    dd if=/path/to/dfly-i386-2.8.2_REL.img of=/dev/da8 bs=1M
+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!).
 
-SMP kernel boots with IO_APIC disabled only. With IO_APIC support it panics early in boot. I haven't bothered yet to dig deeper into this issue.
+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).
 
-I'm not able to boot machine with SATA controller in AHCI mode while running on battery (without AC). It boots fine with AHCI AC connected as it does SATA controller in IDE mode. As some brief benchmarks showed that there is no actual difference I'm using it SATA controller in IDE mode at the moment. The issue itself is related to interrupt routing probably, it really needs some love in DragonFly.
+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.
 
-##### Update from 20.05.2008
+Once DragonFly is installed, reboot and login as root. Now add your user account to wheel and operator group in <b>/etc/group</b>
+   
+If your eeepc has 2 ssd drives (4 and 16GB) you need to add the 16GB drive to your DragonFly system.
 
-The BIOS update released in 18.05.2008 - 7NETB3WW (2.13) - solves most of problems mentioned here, but the kernel with IO_APIC is still no go.
+First list all aveliable drives with:
 
-* A kernel without IO_APIC option boots fine with SATA controller in any mode - AHCI or compatibility, with and without AC. So there is no need to switch SATA controller to compatibility mode any more.
-* A kernel with IO_APIC boots with SATA controller in AHCI mode, but doesn't find any disks.
-* A kernel with IO_APIC boots with SATA controller in compatibility mode, finds disks, but ath(4) doesn't work.
+       # ls /dev/ad*
+       
+You will get similar output:
 
-## ACPI and power management
+       > ls /dev/ad*
+       /dev/ad2        /dev/ad2s1a     /dev/ad3
+       /dev/ad2s1      /dev/ad2s1b     /dev/ad3s0
+       
+Now repeat this but with following:
 
-There is no issues in running with ACPI.
+       > ls /dev/serno*
+       OS1Q85001000517 OS1Q85001000517.s1a SOQ1580033
+       OS1Q85001000517.s1 OS1Q85001000517.s1b SOQ1580033.s0
 
-    acpi0: <LENOVO TP-7N> on motherboard
-    acpi_ec0: <Embedded Controller: GPE 0x12, ECDT> port 0x66,0x62 on acpi0
-    acpi0: Power Button (fixed)
-    acpi_timer0: <24-bit timer at 3.579545MHz> port 0x1008-0x100b on acpi0
-    cpu0: <ACPI CPU (3 Cx states)> on acpi0
-    cpu1: <ACPI CPU (3 Cx states)> on acpi0
-    acpi_tz0: <Thermal Zone> on acpi0
-    acpi_tz1: <Thermal Zone> on acpi0
-    acpi_lid0: <Control Method Lid Switch> on acpi0
-    acpi_button0: <Sleep Button> on acpi0
-    atkbdc0: <Keyboard controller (i8042)> port 0x64,0x60 irq 1 on acpi0
-    acpi_cpu: throttling enabled, 8 steps (100% to 12.5%), currently 100.0%
-    acpi_cmbat0: <Control Method Battery> on acpi0
-    acpi_acad0: <AC Adapter> on acpi0
-
-Suspend (S3) doesn't work though - panics on resume. Haven't time to dig into it yet. Throttling CPU speed works through ACPI, but it doesn't seem to have any impact to battery life, it makes system just slower. So I disabled automatic throttling while running on battery:
-
-    $ sysctl hw.acpi.cpu
-    hw.acpi.cpu.throttle_max: 8
-    hw.acpi.cpu.throttle_state: 8
-    hw.acpi.cpu.performance_speed: 8
-    hw.acpi.cpu.economy_speed: 8
-
-[est(4)](http://leaf.dragonflybsd.org/cgi/web-man?command#est&section4) in DragonFly doesn't support Core family CPU's yet AFAIK. I have 8 cell battery and it lasts about 5 hours, which is enough for me at the moment. Therefore I haven't bothered to dig into power management issues yet.
-
-For tuning/controlling/monitoring ACPI extras for Thinkpad laptops I have acpi_ibm(4) and acpi_video(4) ports from FreeBSD in work. Neither of them are rady to commit yet, but I can share the current state if you contact me privately. I'll work on them after 2.0 release probably.
-
-    $ sysctl hw.acpi.ibm
-    hw.acpi.ibm.initialmask: 2060
-    hw.acpi.ibm.availmask: 16777215
-    hw.acpi.ibm.events: 0
-    hw.acpi.ibm.eventmask: 2060
-    hw.acpi.ibm.hotkey: 2483
-    hw.acpi.ibm.lcd_brightness: 0
-    hw.acpi.ibm.volume: 0
-    hw.acpi.ibm.mute: 0
-    hw.acpi.ibm.thinklight: 0
-    hw.acpi.ibm.bluetooth: 1
-    hw.acpi.ibm.wlan: 1
-    hw.acpi.ibm.fan_speed: 4343
-    hw.acpi.ibm.fan_level: 0
-    hw.acpi.ibm.fan: 1
-    hw.acpi.ibm.thermal: 52 48 48 49 37 -1 35 -1
+In this example we have to add <b>/dev/ad3</b> called also <b>/serno/SOQ1580033</b> to hammerfs.
 
-## Video controller 
+As root, use hammer volume-add utility to expand your hammerfs:
 
-The chipset in use is Intel 965GM.
+       hammer volume-add /dev/ad3 /
 
-    agp0: <Intel GM965 SVGA controller> port 0x1800-0x1807 mem 0xe0000000-0xefffffff,0xf8000000-0xf80fffff irq 10 at device 2.0 on pci0
-    agp0: detected 7676k stolen memory
-    agp0: aperture size is 256M
-    drmsub0: <Intel i965GM> on agp0
+Now you need to edit <b>/boot/loader.conf</b> (this is an example do not copy any rootmounts):
 
-Although there are some issues with it, Intel chips are the best ones to use at the moment. I experimented a lot with Xorg and found that XAA acceleration architecture with DRI works best for me. DRM isn't in CVS yet, so you have to use info from [this mail](http://leaf.dragonflybsd.org/mailarchive/users/2008-01/msg00003.html).
+    vfs.root.mountfrom="hammer:serno/OS1Q85001000517.s1b:serno/SOQ1580033"
+    kern.emergency_intr_enable=1
+    if_ath_load="YES"              #this will load wifi driver
+    acpi_asus_load="YES"        #this will load asus acpi
+    linux_load="YES"            #this is needed if you want OpenOffice.org etc
+    snd_hda_load="YES"            #this is needed for sound 
 
-+ **XAA without DRI** - Works in general, but there are random XVideo related crashes - [this bug](https://bugs.freedesktop.org/show_bug.cgi?id=13976). Crashes seem to be specific to 965GM chipset, 965Q I'm using in desktops doesn't have this problem. 
-+ **EXA without DRI** - Unusably slow. Seems to be known problem (see [this bug](https://bugs.freedesktop.org/show_bug.cgi?id=13389) for example) Note, that EXA is default in new intel driver 2.2.0, so if you don't want to run DRI, switch to XAA.
-+ **XAA with DRI** - Best option so far. Running GL applications is problematic though - I'm able to crash X 100% with moving glxgears window (see [this bug](https://bugs.freedesktop.org/show_bug.cgi?id=13985) for details) and with trying to run second glxgears. The second issue is probably related to bugs in our DRM locking. XVideo crashes are rare, but they are there. 
-+ **EXA with DRI** - The speed is good, I can't crash X with moving glxgears windows, but opening second glxgears still crashes X. There are also some random crashes I'm not yet sure about.
 
-##### Update (20080228)
 
-XVideo crases seems to be related Intel(R) Textured Video adaptor. Modified Xorg driver (2.2.1) which adds hardware overlay support for G965 chips works fine without crashes so far. See [this thread](http://thread.gmane.org/gmane.comp.freedesktop.xorg/26334) for details how to modify the driver.
+Before installing any application (X11) you need to edit your <b>/etc/rc.conf</b> file. Add the following to an existing file:
 
-## Ethernet controller 
+    smbd_enable="YES"  #needed for samba share
+    nmbd_enable="YES"  #needed for samba share
+    hostname="yourhostname" #this is the name of your box
 
-Works without any problem with em(4).
+    ifconfig_ae0="DHCP" #this is needed for LAN
+    wlans_ath0="wlan0"    #this is needed for WLAN
+    ifconfig_wlan0="WPA DHCP" #this is needed for WLAN
 
-    em0: <Intel(R) PRO/1000 Network Connection, Version - 6.2.9> port 0x1840-0x185f mem 0xf8225000-0xf8225fff,0xf8200000-0xf821ffff irq 11 at device 25.0 on pci0
+    moused_enable="YES" #this is needed for keyboard and touchpad support
+    linux_enable="YES"  #this is needed for Openoffice etc  
 
-## Wireless card(s) 
+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:
 
-AFAICS all X61(s) models have either Intel PRO/Wireless 3945ABG or Intel PRO/Wireless 4965AGN Mini-PCI Express WiFi adapters. Unfortunately neither of them is working in DragonFly at the moment. Situation isn't hopeless though, both of them are supported in OpenBSD via wpi(4) and iwn(4) drivers respectively. With some effort it would be possible to support them. There is also wpi(4) work in progress in FreeBSD which would be simpler to port than the driver from FreeBSD.
+       network={
+        ssid="network name"
+        psk="secret password"
+       }
 
-I haven't done any porting work yet, because I can use Atheros AR5418 802.11a/b/g/n Wireless Mini-PCI Express adapter for now. I'm not very happy with it though, because I have to use ath(4) driver with binary blob. Blob in DragonFly doesn't work either and I have to use the one from [[http://people.freebsd.org/~sam/]]. This one works without problems so far and has necessary for me WPA support.
+Edit <b>/etc/host</b> file and add your user name (this is needed for XFCE4 to work without a problem).
 
-    ath0: <Atheros 5418> mem 0xf7f00000-0xf7f0ffff irq 11 at device 0.0 on pci3
-    ath0: mac 12.10 phy 8.1 radio 12.0
+       127.0.0.1               yourname yourname.my.domain
+       
+Now you just have to reboot and login again as a user.
 
-If you plan to change Mini-PCI Express card note that "unauthorised" ones don't work out of box. See [this link]( http://www.thinkwiki.org/wiki/Problem_with_unauthorized_MiniPCI_network_card) for more details.
+If you want to install any applications follow [DragonFly instructions](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/).
 
-## Bluetooth 
+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).
+
+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):
+
+       http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.8.2/pkgsrc-2010Q3/All
+
+Remember to disable (<b>#</b>) any other than DragonFly mirrors. 
+
+Now you have to update pkgin and upgrade any applications that are already on your system by:
+
+       #pkgin update && pkgin full-upgrade
+
+## Installing X11
+
+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).
 
-Works with ubt(4) driver without problems. In fact all my bluetooth(4) work is done with this laptop.    
+    # pkgin in modular-xorg-server
+    # pkgin in modular-xorg-drivers
+    # pkgin in modular-xorg-libs
+    # pkgin in modular-xorg-apps
+    # pkgin in modular-xorg-fonts
+
+Ready to use eeepc 900 <b>xorg.conf</b>:
+
+        Section "ServerLayout"
+             Identifier     "X.org Configured"
+             Screen      0  "Screen0" 0 0
+             InputDevice    "Mouse0" "CorePointer"
+             InputDevice    "Keyboard0" "CoreKeyboard"
+        EndSection
 
-    ubt0: <Broadcom Corp BCM2045B, class 224/1, rev 2.00/1.00, addr 3> on uhub0
+        Section "Files"
+             ModulePath   "/usr/pkg/lib/xorg/modules"
+             FontPath     "/usr/pkg/lib/X11/fonts/misc/"
+             FontPath     "/usr/pkg/lib/X11/fonts/TTF/"
+             FontPath     "/usr/pkg/lib/X11/fonts/OTF"
+             FontPath     "/usr/pkg/lib/X11/fonts/Type1/"
+             FontPath     "/usr/pkg/lib/X11/fonts/100dpi/"
+             FontPath     "/usr/pkg/lib/X11/fonts/75dpi/"
+        EndSection
 
-## Audio 
+        Section "Module"
+             Load  "glx"
+             Load  "dbe"
+             Load  "extmod"
+             Load  "dri"
+             Load  "dri2"
+        EndSection
+
+       Section "InputDevice"
+             Identifier  "Keyboard0"
+             Driver      "kbd"
+             #Option      "XkbLayout"  #"insert your keyboard layout"  #for non-english users
+       EndSection
+
+       Section "InputDevice"
+             Identifier  "Mouse0"
+              Driver      "mouse"
+             Option        "Protocol" "auto"
+             Option        "Device" "/dev/sysmouse"
+             Option        "ZAxisMapping" "4 5 6 7"
+             Option        "Protocol"    "Auto"
+             Option      "Protocol"    "/dev/psm0"
+       EndSection
+
+       Section "Monitor"
+             Identifier   "Monitor0"
+             VendorName   "Monitor Vendor"
+             ModelName    "Monitor Model"
+             HorizSync    30-107
+             VertRefresh  48-120
+             Option       "DPMS"
+       EndSection
+
+       Section "Device"
+              ### Available Driver options are:-
+              ### Values: <i>: integer, <f>: float, <bool>: "True"/"False",
+              ### <string>: "String", <freq>: "<f> Hz/kHz/MHz"
+              ### [arg]: arg optional
+              #Option     "NoAccel"                    # [<bool>]
+              #Option     "SWcursor"                   # [<bool>]
+              #Option     "ColorKey"                   # <i>
+              #Option     "CacheLines"                 # <i>
+              #Option     "Dac6Bit"                    # [<bool>]
+              #Option     "DRI"                        # [<bool>]
+              #Option     "NoDDC"                      # [<bool>]
+              #Option     "ShowCache"                  # [<bool>]
+              #Option     "XvMCSurfaces"               # <i>
+              #Option     "PageFlip"                   # [<bool>]
+             Identifier  "Card0"
+             Driver      "intel"
+             VendorName  "Unknown Vendor"
+             BoardName   "Unknown Board"
+             BusID       "PCI:0:2:0"
+      EndSection
+
+      Section "Screen"
+            Identifier "Screen0"
+            Device     "Card0"
+            Monitor    "Monitor0"
+            SubSection "Display"
+               Viewport   0 0
+               Depth     24
+            Virtual 2048 2048
+            EndSubSection
+     EndSection
+
+     Section "ServerFlags"
+            Option "DontZap"         "off"
+            Option "AllowEmptyInput" "off"
+            Option "AutoAddDevices"  "off"
+     EndSection
+
+
+## How to mount Windows Shares with a GUI
+
+To mount Windows shares at boot-time can follow [DragonFly instructions on HowToMountWindowsShares](http://www.dragonflybsd.org/docs/howtos/HowToMountWindowsShares/) .
+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.
+
+    # pkgin in gnome-commander   
+    # pkgin in gnome-vfs-smb
+    # pkgin in samba
+
+Now make sure that you have 
+
+    smbd_enable="YES" 
+    nmbd_enable="YES" 
+
+in your <b>rc.conf</b> file.
+
+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:
+
+    # cp /usr/pkg/share/examples/rc.d/smbd /etc/rc.d/smbd
+    # cp cd /usr/pkg/share/examples/rc.d/nmbd /etc/rc.d/nmbd
+  
+You can add DragonFly users (and their passwords) for sharing files by:
+
+    # smbpasswd -a username 
+
+It is now the time to configure <b>smb.conf</b> file which is located in <b>/usr/pkg/etc/samba</b>. 
+
+Now, to start samba deamon type in terminal (as root):
+
+    # /etc/rc.d/smbd start
+    # /etc/rc.d/nmbd start  
+
+Open gnome-commander (X11 is essential for this application) and navigate to your Windows share directory (<b>smb</b> button)
+
+## Installing VLC
+
+VLC is a great multimedia player – one of the best available on DragonFly (with pkgsrc-2010Q3 package collection). You can install it by:
+
+    # pkgin in vlc
+
+This will fail to install libdca-0.0.5. Libdca-0.0.5 you should install with pkgsrc collection:
+
+    # cd /usr/pkgsrc/audio/libdca
+    # bmake install clean
 
-Works without problems.
+If you have no <b>/usr/pkgsrc/audio/libdca</b> directory, then you should install pkgsrc collection by:
 
-    pcm0: <Intel 82801H High Definition Audio Controller> mem 0xf8220000-0xf8223fff irq 11 at device 27.0 on pci0
-    pcm0: <HDA Codec: Analog Devices AD1984>
-    pcm0: <HDA Driver Revision: 20071129_0050>
+    # cd /usr
+    # make pkgsrc-create
 
-## Firewire 
+After successful installation, go back to <b>/usr/pkgsrc/audio/libdca</b> and repeat libdca installation process with <b>bmake install clean</b> .
 
-Seems to work, but I haven't done any tests so far.    
 
-    fwohci0: vendor#1180, dev832
-    fwohci0: <1394 Open Host Controller Interface> mem 0xd7efe800-0xd7efefff irq 11 at device 0.1 on pci5
-    fwohci0: OHCI version 1.10 (ROM=0)
-    fwohci0: No. of Isochronous channel is 4.
-    fwohci0: EUI64 00:16:d3:ff:ff:c2:f7:57
-    fwohci0: Phy 1394a available S400, 1 ports.
-    fwohci0: Link S400, max_rec 2048 bytes.
-    firewire0: <IEEE1394(FireWire) bus> on fwohci0
-    fwe0: <Ethernet over FireWire> on firewire0
-    fwe0: MAC address: 02:16:d3:c2:f7:57
-    sbp0: <SBP-2/SCSI over FireWire> on firewire0
-    fwohci0: Initiate bus reset
-    fwohci0: node_id#0xc800ffc0, gen1, CYCLEMASTER mode
-    firewire0: 1 nodes, maxhop <# 0, cable IRM  0 (me)
-    firewire0: bus manager 0 (me)
+Following experience is from running DragonFly 2.8.2 on netbook (eeepc 900).
+
+## ACPI and power management
+
+There is no issues in running with ACPI.
+
+   
+Suspend (S3) works but there are some problems with resuming (X11 crashes and touchpad doesn't work after <b>zzz</b>).
+
+For tuning/controlling/monitoring ACPI extras for ASUS laptops you have acpi_asus(4).
+
+    $ sysctl hw.acpi.asus
+    hw.acpi.asus.lcd_brightness: 1
+    hw.acpi.asus.camera: 0
+    hw.acpi.asus.cardreader: 1
+    hw.acpi.asus.wlan: 1
+
+## Video controller 
+
+Video playback is okay. The chipset in use is Intel 945GM. 
+
+## Ethernet controller 
+
+Works without any problem with ae(4).
+
+## Wireless card(s) 
+
+Works fine
+
+## Audio 
+
+Works fine
 
 ## SD card reader 
 
-Isn't supported yet.
+Works fine
+
+## Camera
+
+Not supported.