wmgeneral: Check if malloc fails.
[dockapps.git] / wmpower / README.compal
blob36b249cd4d5a5967697647af847c9d5d681bfe7d
1 Compal laptop support for wmpower
2 ---------------------------------
4 Francisco Rodrigo Escobedo Robles <frer@pepix.net>
5 20031002
8 -----
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.
16 -----
19 0 - Objectives, requirements, legal and contact.
20 ------------------------------------------------
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.
27 It uses and requires the omnibook kernel module, available at
28 http://sourceforge.net/projects/omke/
30 All the code in this patch is under the GNU General Public License, version 2.
32 For any suggestions, appraisals and critics, contact me at frer@pepix.net.
35 1 - What is a Compal laptop?
36 ----------------------------
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"...
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.
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
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 :)
73 2 - How can I know if I have one?
74 ---------------------------------
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).
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 :)
87 3 - What specifics has beed added to wmpower?
88 ---------------------------------------------
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 :)
94 The patch makes available the following information from the /proc/omnibook:
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)
102 Additionally, it offers the following controls:
104  - LCD brightness (through the mouse wheel)
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).
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 :)
118 Enjoy!
121 4 - Known bugs.
122 ---------------
124  - currently, it draws a little more CPU time than would be ideal
125  - assumes ACPI support is present to calculate the remaining time