LaptopTesting

Differences between revisions 4 and 5
Revision 4 as of 2005-08-14 21:59:14
Size: 2224
Editor: S0106000000cc07fc
Comment: point to Spec
Revision 5 as of 2005-08-14 22:56:57
Size: 6877
Editor: S0106000000cc07fc
Comment: data merged from Spec
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
If you have a spare laptop that doesn't contain any important data, or if you like restoring from backups, or if you know how to install an OS under a `chroot`, here's what you can do. Laptop testing is not that hard. You just need a laptop and a few hours to do it. Here are the steps you need to follow:
 1. Install the current stable version of Ubuntu on it (currently 5.04 (Hoary Hedgehog))
 1. Copy data from ["LaptopTestingTeam/Template"] into a new subpage of LaptopTestingTeam named after your make and model. If you owned a Toshiba Tecra A5, the page would be ["LaptopTestingTeam/ToshibaTecraA5"]
 1. Add yourself to the table on LaptopTestingTeam
 1. Fill out all the information. Don't file any bugs at this point.
 1. Install the most current point release of the development version (currently 5.10 (Breezy Badger))
 1. Fill out all the information. File bugs for anything that doesn't work or worked in the stable release and doesn't work now
 1. When a new point release for the development comes out, install that and correct any information. File new bugs for newly broken things and close bugs for things that now work
Line 9: Line 16:
 1. Go to LaptopTestingSpec and follow the guide there == Install ==
Line 11: Line 18:
Ubuntu developers can then choose which hardware to target for improvement, with the aim of ensuring that it works out of the box in future releases. Did the installer complete without errors?
Line 13: Line 20:
== What we're interested in == == Basic Hardware Test ==
Line 15: Line 22:
This is a quick overview of what we are interested in. A more complete guide can be found at LaptopTestingSpec  * Does X start correctly?
  * After installation is complete, a graphical login window should appear
 * Is X running at the correct resolution?
  * The X desktop should be sharp and clear. System/Preferences/Screen Resolution should default to the resolution of the screen
 * Does glxinfo return the line "direct rendering: Yes"?
  * Start a terminal and type the following:{{{
glxinfo | grep rendering}}}
  This will print either "direct rendering: Yes" or "direct rendering: No"
 * Does the wired ethernet work?
  * Can you browse the internet when plugged into the wired ethernet port?
 * Does the wireless ethernet work?
  * Can you browse the internet when near a wireless access point?
 * Does the trackpad work?
  * Does it move the mouse pointer?
  * Does the right hand side emulate a mouse scroll wheel?
  * Does the trackpoint work?
  * Does it move the mouse pointer?
Line 17: Line 40:
=== Hotkeys === == Advanced Hardware Test ==
Line 19: Line 42:
Any printed hotkeys should generate events that are passed on to userspace, and appropriate commands then executed. For example, a wireless button should enable or disable the wireless and bluetooth hardware. A sleep button should put the laptop to sleep. A mail button should launch an email client.  * Does the modem work?
  * Right click on the panel and select add to panel. Choose "Modem monitor" and click OK. Right click and select properties. Enter the password. Click add, and choose modem (PPP). Enter a phone number on the next screen. Enter username and password. Apply the changes and then select Activate from the phone applet menu. Does the machine dial out correctly?
 * Does the sound work ?
   * A good initial indication is if a sound was played on GNOME login.
   * A sample audio file which will be played out of the box by totem can be found here: http://www.xiph.org/vorbis/listen/41_30secOgg-q0.ogg
 * Does pressing the volume hotkeys raise, lower and mute volume?
  * This may or may not result in a dialog appearing on screen showing the current volume
 * Do the brightness keys alter the screen brightness?
  * Brightness up should raise the screen brightness, and down should lower it. On machines with light sensors, the hotkey should enable and disable this.
 * Does the video display hotkey switch the external display on and off?
  * Without rebooting the machine, connect a monitor to the external display. Press the display key. Does a picture appear on the monitor? Is it correct?
 * Does the wireless button enable and disable wireless?
  * When enabled, the wireless monitor applet in the top right of the screen should show a signal. When disabled, it should not.
 * Do application buttons (mail, help, web) launch appropriate applications? Pressing application buttons should launch an application, or bring it to the front if it is already running.
 * Is the machine discoverable from a mobile phone with bluetooth?
  * On the phone, select "Discover devices". See if the computer is listed.
 * If an infra red phone is placed in front of the infra red port, does its address appear in /proc/net/irda/discovery?
  * Ensure that infra-red is switched on on the phone. Place it in front of the infra-red port. From a terminal, type{{{
cat /proc/net/irda/discovery}}}
  and see if it contains a line referring to the phone
 * Does attaching a docking station result in all of the hardware appearing correctly under Linux?
  * Do USB ports on the docking station work?
  * Does the video out on the docking station work?
  * Do any removable media devices in the docking station work?
  * If the docking station contains a battery, does it show up correctly?
  * Does removing the docking station result in correct behaviour?
  * If the docking station is removed, does Linux carry on running?
  * If the docking station is reattached, does the docking station still work?
 * Does the PCMCIA/CardBus port work?
   * If you have a PCMCIA/CardBus card to try with, is the device picked up? The lights on the device should light up.
 * Does the firewire work?
   * If you have a device to try with, plug in a firewire device and see if it is detected.
 * Do the USB ports work?
   * Plug in a USB device, does it work? Using something simple for testing like a mouse is good.
 * Note: For the above tests, if the usability of the device is not apparently, you may wish to refer to the 'dmesg' command, or the "Device Manager" located under System->Administration to see if the device is listed.
Line 21: Line 78:
A list of known keys is being assembled at LaptopKeycodes. == Power Management Test ==
Line 23: Line 80:
=== Bluetooth ===  * Does pressing the sleep button cause the machine to sleep?
  * After a few seconds, the machine's screen should go blank and the sleep light come on
 * Does the machine then wake up correctly?
  * After a few seconds, the machine should wake up. Moving the mouse should result in a screen unlock box appearing.
  * Does the keyboard still work after resume?
  * Does the network still work after resume?
  * Do USB devices work correctly?
  * Does the audio still work correctly?
 * Does pressing the hibernate button cause the machine to hibernate? (Not all machines have hibernate buttons)
  * The screen should go blank. Some time later, the machine should switch off.
 * Does the machine then wake up correctly?
  * Pressing the power button should result in the machine waking up. After a while, moving the mouse should result in a screen unlock box appearing.
  * Does the keyboard still work after resume?
  * Does the network still work after resume?
  * Do USB devices work correctly?
  * Does the audio still work correctly?
 * Does performing these actions from the logout menu behave identically?
Line 25: Line 98:
The Bluetooth hardware in the laptop should be automatically configured on boot.

=== Modem ===

The modem should be autodetected and configured. The user should simply be able to configure /dev/modem for their ISP.

=== Infra-red ===

The infra-red port should work correctly. Where possible, it should use FIR, but falling back to SIR is acceptable.

=== Docking station ===

When supported by the hardware, it must be possible to hot dock and undock the laptop from the docking station. On docking, all docking station hardware must automatically appear and be made available with no further configuration. On eject, the resources must be freed correctly.

=== Video/TV out ===

With the aid of hotkeys or UI elements, it must be possible for the laptop user to enable and disable all video outputs on the laptop.

=== Suspend ===

Suspend to disk and to RAM must work without any further configuration.
 * Does repeating the entire process, having already done one suspend perform the same (i.e. suspending more than once.)

Providing totally rad laptop support

The [http://ubuntu.com/community/teams/laptop Ubuntu laptop team] are on a mission to get Ubuntu to work great on as many laptops as they can. To do this, they need to know which hardware works without configuration and which is currently unsupported.

How you can help

Laptop testing is not that hard. You just need a laptop and a few hours to do it. Here are the steps you need to follow:

  1. Install the current stable version of Ubuntu on it (currently 5.04 (Hoary Hedgehog))
  2. Copy data from ["LaptopTestingTeam/Template"] into a new subpage of LaptopTestingTeam named after your make and model. If you owned a Toshiba Tecra A5, the page would be ["LaptopTestingTeam/ToshibaTecraA5"]

  3. Add yourself to the table on LaptopTestingTeam

  4. Fill out all the information. Don't file any bugs at this point.
  5. Install the most current point release of the development version (currently 5.10 (Breezy Badger))
  6. Fill out all the information. File bugs for anything that doesn't work or worked in the stable release and doesn't work now
  7. When a new point release for the development comes out, install that and correct any information. File new bugs for newly broken things and close bugs for things that now work

Install

Did the installer complete without errors?

Basic Hardware Test

  • Does X start correctly?
    • After installation is complete, a graphical login window should appear
  • Is X running at the correct resolution?
    • The X desktop should be sharp and clear. System/Preferences/Screen Resolution should default to the resolution of the screen
  • Does glxinfo return the line "direct rendering: Yes"?
    • Start a terminal and type the following:

      glxinfo | grep rendering
      This will print either "direct rendering: Yes" or "direct rendering: No"
  • Does the wired ethernet work?
    • Can you browse the internet when plugged into the wired ethernet port?
  • Does the wireless ethernet work?
    • Can you browse the internet when near a wireless access point?
  • Does the trackpad work?
    • Does it move the mouse pointer?
    • Does the right hand side emulate a mouse scroll wheel?
    • Does the trackpoint work?
    • Does it move the mouse pointer?

Advanced Hardware Test

  • Does the modem work?
    • Right click on the panel and select add to panel. Choose "Modem monitor" and click OK. Right click and select properties. Enter the password. Click add, and choose modem (PPP). Enter a phone number on the next screen. Enter username and password. Apply the changes and then select Activate from the phone applet menu. Does the machine dial out correctly?
  • Does the sound work ?
  • Does pressing the volume hotkeys raise, lower and mute volume?
    • This may or may not result in a dialog appearing on screen showing the current volume
  • Do the brightness keys alter the screen brightness?
    • Brightness up should raise the screen brightness, and down should lower it. On machines with light sensors, the hotkey should enable and disable this.
  • Does the video display hotkey switch the external display on and off?
    • Without rebooting the machine, connect a monitor to the external display. Press the display key. Does a picture appear on the monitor? Is it correct?
  • Does the wireless button enable and disable wireless?
    • When enabled, the wireless monitor applet in the top right of the screen should show a signal. When disabled, it should not.
  • Do application buttons (mail, help, web) launch appropriate applications? Pressing application buttons should launch an application, or bring it to the front if it is already running.
  • Is the machine discoverable from a mobile phone with bluetooth?
    • On the phone, select "Discover devices". See if the computer is listed.
  • If an infra red phone is placed in front of the infra red port, does its address appear in /proc/net/irda/discovery?
    • Ensure that infra-red is switched on on the phone. Place it in front of the infra-red port. From a terminal, type

      cat /proc/net/irda/discovery
      and see if it contains a line referring to the phone
  • Does attaching a docking station result in all of the hardware appearing correctly under Linux?
    • Do USB ports on the docking station work?
    • Does the video out on the docking station work?
    • Do any removable media devices in the docking station work?
    • If the docking station contains a battery, does it show up correctly?
    • Does removing the docking station result in correct behaviour?
    • If the docking station is removed, does Linux carry on running?
    • If the docking station is reattached, does the docking station still work?
  • Does the PCMCIA/CardBus port work?
    • If you have a PCMCIA/CardBus card to try with, is the device picked up? The lights on the device should light up.
  • Does the firewire work?
    • If you have a device to try with, plug in a firewire device and see if it is detected.
  • Do the USB ports work?
    • Plug in a USB device, does it work? Using something simple for testing like a mouse is good.
  • Note: For the above tests, if the usability of the device is not apparently, you may wish to refer to the 'dmesg' command, or the "Device Manager" located under System->Administration to see if the device is listed.

Power Management Test

  • Does pressing the sleep button cause the machine to sleep?
    • After a few seconds, the machine's screen should go blank and the sleep light come on
  • Does the machine then wake up correctly?
    • After a few seconds, the machine should wake up. Moving the mouse should result in a screen unlock box appearing.
    • Does the keyboard still work after resume?
    • Does the network still work after resume?
    • Do USB devices work correctly?
    • Does the audio still work correctly?
  • Does pressing the hibernate button cause the machine to hibernate? (Not all machines have hibernate buttons)
    • The screen should go blank. Some time later, the machine should switch off.
  • Does the machine then wake up correctly?
    • Pressing the power button should result in the machine waking up. After a while, moving the mouse should result in a screen unlock box appearing.
    • Does the keyboard still work after resume?
    • Does the network still work after resume?
    • Do USB devices work correctly?
    • Does the audio still work correctly?
  • Does performing these actions from the logout menu behave identically?
  • Does repeating the entire process, having already done one suspend perform the same (i.e. suspending more than once.)

CategoryLaptop

LaptopTesting (last edited 2010-11-24 09:09:05 by host238-226-dynamic)