wmpower/README.compal

   1 Compal laptop support for wmpower
   2 ---------------------------------
   3
   4 Francisco Rodrigo Escobedo Robles <frer@pepix.net>
   5 20031002
   6
   7
   8 -----
   9
  10 0 - Objectives, requirements, legal and contact.
  11 1 - What is a Compal laptop?
  12 2 - How can I know if I have one?
  13 3 - What specifics has beed added to wmpower?
  14 4 - Known bugs.
  15
  16 -----
  17
  18
  19 0 - Objectives, requirements, legal and contact.
  20 ------------------------------------------------
  21
  22 This patch to wmpower enhances its operation by supplying temperature, fan
  23 and remaining battery time information, as well as charging time information
  24 and LCD brightness control for Compal laptops. Nowadays they come in all
  25 kind of brands.
  26
  27 It uses and requires the omnibook kernel module, available at
  28 http://sourceforge.net/projects/omke/
  29
  30 All the code in this patch is under the GNU General Public License, version 2.
  31
  32 For any suggestions, appraisals and critics, contact me at frer@pepix.net.
  33
  34
  35 1 - What is a Compal laptop?
  36 ----------------------------
  37
  38 Is a laptop made or designed by the Compal ODM (Original Design
  39 Manufacturer). Compal (http://www.compal.com/) is a company in Taiwan that
  40 makes laptops (as well as PDAs, mobile phones and TFT monitors), and offers
  41 them to another makers for rebranding. This is a more usual process than one
  42 can possibly imagine. So there it goes for "brand fidelity"...
  43
  44 In fact, a real proof of the whole Universe being a practical joke, Acer used
  45 to be ODM for other well-known brands. Nowadays, the demand for Acer is so
  46 high, that they themselves have turned to ODMs like Compal and Quanta. My
  47 Acer Aspire 1403XC is made by Compal (that they sell it as model CR10, and the
  48 board is labelled as BR20). It's the same as the FlexNote CR10, the Beep
  49 Chrome and very similar to some models of the Toshiba Satellite 1900 and 2430
  50 series, and of course, the HP Omnibook XE3 GF.
  51
  52 Compal models are rebranded by Acer, Toshiba, HP, Dell and some others. And
  53 here is where the excellent omnibook kernel module comes into scene. The
  54 people at http://sourceforge.net/projects/omke/ have come with a wonderful
  55 module that interfaces with several special features of the HP Omnibook XE3
  56 GF and related models. As a matter of fact, and due to their Compal origin,
  57 several contributed code has made it possible for similar architectures to be
  58 properly interfaced and available in /proc/omnibook
  59
  60 (side note: since the 1970s, rebranding ODM producs has been a common process,
  61 and I took first contact with it while comparing the schematic diagrams for
  62 CB transceivers in the early 1980s: I could classify any given model in one
  63 of 4 or 5 makers, namely Cybernet (now merged into Kyocera and working on
  64 WiFi networks), Uniden (still on the radio market), Maxon (still on radio
  65 and now on mobile phone markets) and 1 or 2 unidentified makers. I was fond of
  66 Cybernet SSB designs, despite of them being generally messier than the Uniden
  67 ones. Nowadays, Uniden still produces for the President brand and others a
  68 chassis that is some 25 years old in its foundations, with little incremental
  69 changes over time. If you didn't want to know this, you'd better had not taken
  70 the red pill :)
  71
  72
  73 2 - How can I know if I have one?
  74 ---------------------------------
  75
  76 You can look for it in http://tuxmobil.org/laptop_oem.html and
  77 https://gullfoss2.fcc.gov/prod/oet/cf/eas/reports/GenericSearch.cfm (FCC ID
  78 search, for models sold in the U.S.A.; most of them carry it the FCC ID even
  79 if sold elsewhere).
  80
  81 Other than that, you can try to install the omnibook module: if it fails,
  82 then your laptop is not supported by it, be it a Compal ODM model or not. If
  83 you suspect it's a Compal made one, contact the people at
  84 http://sourceforge.net/projects/omke/ or better yet, contribute some code :)
  85
  86
  87 3 - What specifics has beed added to wmpower?
  88 ---------------------------------------------
  89
  90 wmpower relies on ACPI or APM to get the power management information.
  91 Additionally, Toshiba and Dell are supported for their specifics. Now
  92 Compal/Acer/HP/whatever are :)
  93
  94 The patch makes available the following information from the /proc/omnibook:
  95
  96  - fan activity
  97  - CPU temperature
  98  - remaining battery time (computed from the current charge over the time)
  99  - remaining charge time (the same as before)
 100  - the maker and model of the laptop (on stderr)
 101
 102 Additionally, it offers the following controls:
 103
 104  - LCD brightness (through the mouse wheel)
 105
 106 The fan activity and CPU temperature are shown from the information directly
 107 available from /proc/omnibook/fan and /proc/omnibook/temperature,
 108 respectively. The battery status information is read from
 109 /proc/omnibook/battery, as it's more reliable than /proc/acpi/battery/...
 110 for this kind of machines (compare 4000 mAh from ACPI and 5900 mAh from the
 111 omnibook module as the full battery capacity).
 112
 113 From the remaining capacity and the time between polls, the current draw
 114 rate is calculated, and hence the remaining time. Similarly, the remaining
 115 time to get a full charge is calculated from the same data set. I couldn't
 116 resist to get a bit more of functionality :)
 117
 118 Enjoy!
 119
 120
 121 4 - Known bugs.
 122 ---------------
 123
 124  - currently, it draws a little more CPU time than would be ideal
 125  - assumes ACPI support is present to calculate the remaining time