diff options
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/acpi-hotkey.txt | 38 | ||||
-rw-r--r-- | Documentation/arm/Samsung-S3C24XX/DMA.txt | 46 | ||||
-rw-r--r-- | Documentation/arm/Samsung-S3C24XX/Overview.txt | 21 | ||||
-rw-r--r-- | Documentation/feature-removal-schedule.txt | 23 | ||||
-rw-r--r-- | Documentation/kernel-parameters.txt | 6 | ||||
-rw-r--r-- | Documentation/pci.txt | 4 | ||||
-rw-r--r-- | Documentation/powerpc/booting-without-of.txt | 14 | ||||
-rw-r--r-- | Documentation/sony-laptop.txt | 106 |
8 files changed, 180 insertions, 78 deletions
diff --git a/Documentation/acpi-hotkey.txt b/Documentation/acpi-hotkey.txt deleted file mode 100644 index 38040fa37649..000000000000 --- a/Documentation/acpi-hotkey.txt +++ /dev/null | |||
@@ -1,38 +0,0 @@ | |||
1 | driver/acpi/hotkey.c implement: | ||
2 | 1. /proc/acpi/hotkey/event_config | ||
3 | (event based hotkey or event config interface): | ||
4 | a. add a event based hotkey(event) : | ||
5 | echo "0:bus::action:method:num:num" > event_config | ||
6 | |||
7 | b. delete a event based hotkey(event): | ||
8 | echo "1:::::num:num" > event_config | ||
9 | |||
10 | c. modify a event based hotkey(event): | ||
11 | echo "2:bus::action:method:num:num" > event_config | ||
12 | |||
13 | 2. /proc/acpi/hotkey/poll_config | ||
14 | (polling based hotkey or event config interface): | ||
15 | a.add a polling based hotkey(event) : | ||
16 | echo "0:bus:method:action:method:num" > poll_config | ||
17 | this adding command will create a proc file | ||
18 | /proc/acpi/hotkey/method, which is used to get | ||
19 | result of polling. | ||
20 | |||
21 | b.delete a polling based hotkey(event): | ||
22 | echo "1:::::num" > event_config | ||
23 | |||
24 | c.modify a polling based hotkey(event): | ||
25 | echo "2:bus:method:action:method:num" > poll_config | ||
26 | |||
27 | 3./proc/acpi/hotkey/action | ||
28 | (interface to call aml method associated with a | ||
29 | specific hotkey(event)) | ||
30 | echo "event_num:event_type:event_argument" > | ||
31 | /proc/acpi/hotkey/action. | ||
32 | The result of the execution of this aml method is | ||
33 | attached to /proc/acpi/hotkey/poll_method, which is dynamically | ||
34 | created. Please use command "cat /proc/acpi/hotkey/polling_method" | ||
35 | to retrieve it. | ||
36 | |||
37 | Note: Use cmdline "acpi_generic_hotkey" to over-ride | ||
38 | platform-specific with generic driver. | ||
diff --git a/Documentation/arm/Samsung-S3C24XX/DMA.txt b/Documentation/arm/Samsung-S3C24XX/DMA.txt new file mode 100644 index 000000000000..37f4edcc5d87 --- /dev/null +++ b/Documentation/arm/Samsung-S3C24XX/DMA.txt | |||
@@ -0,0 +1,46 @@ | |||
1 | S3C2410 DMA | ||
2 | =========== | ||
3 | |||
4 | Introduction | ||
5 | ------------ | ||
6 | |||
7 | The kernel provides an interface to manage DMA transfers | ||
8 | using the DMA channels in the cpu, so that the central | ||
9 | duty of managing channel mappings, and programming the | ||
10 | channel generators is in one place. | ||
11 | |||
12 | |||
13 | DMA Channel Ordering | ||
14 | -------------------- | ||
15 | |||
16 | Many of the range do not have connections for the DMA | ||
17 | channels to all sources, which means that some devices | ||
18 | have a restricted number of channels that can be used. | ||
19 | |||
20 | To allow flexibilty for each cpu type and board, the | ||
21 | dma code can be given an dma ordering structure which | ||
22 | allows the order of channel search to be specified, as | ||
23 | well as allowing the prohibition of certain claims. | ||
24 | |||
25 | struct s3c24xx_dma_order has a list of channels, and | ||
26 | each channel within has a slot for a list of dma | ||
27 | channel numbers. The slots are searched in order, for | ||
28 | the presence of a dma channel number with DMA_CH_VALID | ||
29 | orred in. | ||
30 | |||
31 | If the order has the flag DMA_CH_NEVER set, then after | ||
32 | checking the channel list, the system will return no | ||
33 | found channel, thus denying the request. | ||
34 | |||
35 | A board support file can call s3c24xx_dma_order_set() | ||
36 | to register an complete ordering set. The routine will | ||
37 | copy the data, so the original can be discared with | ||
38 | __initdata. | ||
39 | |||
40 | |||
41 | Authour | ||
42 | ------- | ||
43 | |||
44 | Ben Dooks, | ||
45 | Copyright (c) 2007 Ben Dooks, Simtec Electronics | ||
46 | Licensed under the GPL v2 | ||
diff --git a/Documentation/arm/Samsung-S3C24XX/Overview.txt b/Documentation/arm/Samsung-S3C24XX/Overview.txt index 28d014714ab8..c31b76fa66c4 100644 --- a/Documentation/arm/Samsung-S3C24XX/Overview.txt +++ b/Documentation/arm/Samsung-S3C24XX/Overview.txt | |||
@@ -8,13 +8,10 @@ Introduction | |||
8 | 8 | ||
9 | The Samsung S3C24XX range of ARM9 System-on-Chip CPUs are supported | 9 | The Samsung S3C24XX range of ARM9 System-on-Chip CPUs are supported |
10 | by the 's3c2410' architecture of ARM Linux. Currently the S3C2410, | 10 | by the 's3c2410' architecture of ARM Linux. Currently the S3C2410, |
11 | S3C2440 and S3C2442 devices are supported. | 11 | S3C2412, S3C2413, S3C2440 and S3C2442 devices are supported. |
12 | 12 | ||
13 | Support for the S3C2400 series is in progress. | 13 | Support for the S3C2400 series is in progress. |
14 | 14 | ||
15 | Support for the S3C2412 and S3C2413 CPUs is being merged. | ||
16 | |||
17 | |||
18 | Configuration | 15 | Configuration |
19 | ------------- | 16 | ------------- |
20 | 17 | ||
@@ -26,6 +23,22 @@ Configuration | |||
26 | please check the machine specific documentation. | 23 | please check the machine specific documentation. |
27 | 24 | ||
28 | 25 | ||
26 | Layout | ||
27 | ------ | ||
28 | |||
29 | The core support files are located in the platform code contained in | ||
30 | arch/arm/plat-s3c24xx with headers in include/asm-arm/plat-s3c24xx. | ||
31 | This directory should be kept to items shared between the platform | ||
32 | code (arch/arm/plat-s3c24xx) and the arch/arm/mach-s3c24* code. | ||
33 | |||
34 | Each cpu has a directory with the support files for it, and the | ||
35 | machines that carry the device. For example S3C2410 is contained | ||
36 | in arch/arm/mach-s3c2410 and S3C2440 in arch/arm/mach-s3c2440 | ||
37 | |||
38 | Register, kernel and platform data definitions are held in the | ||
39 | include/asm-arm/arch-s3c2410 directory. | ||
40 | |||
41 | |||
29 | Machines | 42 | Machines |
30 | -------- | 43 | -------- |
31 | 44 | ||
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt index c585aa8d62b4..28f897fd3674 100644 --- a/Documentation/feature-removal-schedule.txt +++ b/Documentation/feature-removal-schedule.txt | |||
@@ -253,29 +253,6 @@ Who: Venkatesh Pallipadi <venkatesh.pallipadi@intel.com> | |||
253 | 253 | ||
254 | --------------------------- | 254 | --------------------------- |
255 | 255 | ||
256 | <<<<<<< test:Documentation/feature-removal-schedule.txt | ||
257 | What: ACPI hotkey driver (CONFIG_ACPI_HOTKEY) | ||
258 | When: 2.6.21 | ||
259 | Why: hotkey.c was an attempt to consolidate multiple drivers that use | ||
260 | ACPI to implement hotkeys. However, hotkeys are not documented | ||
261 | in the ACPI specification, so the drivers used undocumented | ||
262 | vendor-specific hooks and turned out to be more different than | ||
263 | the same. | ||
264 | |||
265 | Further, the keys and the features supplied by each platform | ||
266 | are different, so there will always be a need for | ||
267 | platform-specific drivers. | ||
268 | |||
269 | So the new plan is to delete hotkey.c and instead, work on the | ||
270 | platform specific drivers to try to make them look the same | ||
271 | to the user when they supply the same features. | ||
272 | |||
273 | hotkey.c has always depended on CONFIG_EXPERIMENTAL | ||
274 | |||
275 | Who: Len Brown <len.brown@intel.com> | ||
276 | |||
277 | --------------------------- | ||
278 | |||
279 | What: /sys/firmware/acpi/namespace | 256 | What: /sys/firmware/acpi/namespace |
280 | When: 2.6.21 | 257 | When: 2.6.21 |
281 | Why: The ACPI namespace is effectively the symbol list for | 258 | Why: The ACPI namespace is effectively the symbol list for |
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 5bc8970b8349..35470de14a95 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
@@ -1280,6 +1280,12 @@ and is between 256 and 4096 characters. It is defined in the file | |||
1280 | This sorting is done to get a device | 1280 | This sorting is done to get a device |
1281 | order compatible with older (<= 2.4) kernels. | 1281 | order compatible with older (<= 2.4) kernels. |
1282 | nobfsort Don't sort PCI devices into breadth-first order. | 1282 | nobfsort Don't sort PCI devices into breadth-first order. |
1283 | cbiosize=nn[KMG] The fixed amount of bus space which is | ||
1284 | reserved for the CardBus bridge's IO window. | ||
1285 | The default value is 256 bytes. | ||
1286 | cbmemsize=nn[KMG] The fixed amount of bus space which is | ||
1287 | reserved for the CardBus bridge's memory | ||
1288 | window. The default value is 64 megabytes. | ||
1283 | 1289 | ||
1284 | pcmv= [HW,PCMCIA] BadgePAD 4 | 1290 | pcmv= [HW,PCMCIA] BadgePAD 4 |
1285 | 1291 | ||
diff --git a/Documentation/pci.txt b/Documentation/pci.txt index fd5028eca13e..cdf2f3c0ab14 100644 --- a/Documentation/pci.txt +++ b/Documentation/pci.txt | |||
@@ -205,8 +205,8 @@ Tips on when/where to use the above attributes: | |||
205 | exclusively called by the probe() routine, can be marked __devinit. | 205 | exclusively called by the probe() routine, can be marked __devinit. |
206 | Ditto for remove() and __devexit. | 206 | Ditto for remove() and __devexit. |
207 | 207 | ||
208 | o If mydriver_probe() is marked with __devinit(), then all address | 208 | o If mydriver_remove() is marked with __devexit(), then all address |
209 | references to mydriver_probe must use __devexit_p(mydriver_probe) | 209 | references to mydriver_remove must use __devexit_p(mydriver_remove) |
210 | (in the struct pci_driver declaration for example). | 210 | (in the struct pci_driver declaration for example). |
211 | __devexit_p() will generate the function name _or_ NULL if the | 211 | __devexit_p() will generate the function name _or_ NULL if the |
212 | function will be discarded. For an example, see drivers/net/tg3.c. | 212 | function will be discarded. For an example, see drivers/net/tg3.c. |
diff --git a/Documentation/powerpc/booting-without-of.txt b/Documentation/powerpc/booting-without-of.txt index 3b514672b80e..b41397d6430a 100644 --- a/Documentation/powerpc/booting-without-of.txt +++ b/Documentation/powerpc/booting-without-of.txt | |||
@@ -497,7 +497,7 @@ looks like in practice. | |||
497 | | |- device_type = "cpu" | 497 | | |- device_type = "cpu" |
498 | | |- reg = <0> | 498 | | |- reg = <0> |
499 | | |- clock-frequency = <5f5e1000> | 499 | | |- clock-frequency = <5f5e1000> |
500 | | |- linux,boot-cpu | 500 | | |- 64-bit |
501 | | |- linux,phandle = <2> | 501 | | |- linux,phandle = <2> |
502 | | | 502 | | |
503 | o memory@0 | 503 | o memory@0 |
@@ -509,7 +509,6 @@ looks like in practice. | |||
509 | o chosen | 509 | o chosen |
510 | |- name = "chosen" | 510 | |- name = "chosen" |
511 | |- bootargs = "root=/dev/sda2" | 511 | |- bootargs = "root=/dev/sda2" |
512 | |- linux,platform = <00000600> | ||
513 | |- linux,phandle = <4> | 512 | |- linux,phandle = <4> |
514 | 513 | ||
515 | This tree is almost a minimal tree. It pretty much contains the | 514 | This tree is almost a minimal tree. It pretty much contains the |
@@ -519,7 +518,7 @@ physical memory layout. It also includes misc information passed | |||
519 | through /chosen, like in this example, the platform type (mandatory) | 518 | through /chosen, like in this example, the platform type (mandatory) |
520 | and the kernel command line arguments (optional). | 519 | and the kernel command line arguments (optional). |
521 | 520 | ||
522 | The /cpus/PowerPC,970@0/linux,boot-cpu property is an example of a | 521 | The /cpus/PowerPC,970@0/64-bit property is an example of a |
523 | property without a value. All other properties have a value. The | 522 | property without a value. All other properties have a value. The |
524 | significance of the #address-cells and #size-cells properties will be | 523 | significance of the #address-cells and #size-cells properties will be |
525 | explained in chapter IV which defines precisely the required nodes and | 524 | explained in chapter IV which defines precisely the required nodes and |
@@ -733,8 +732,7 @@ address which can extend beyond that limit. | |||
733 | that typically get driven by the same platform code in the | 732 | that typically get driven by the same platform code in the |
734 | kernel, you would use a different "model" property but put a | 733 | kernel, you would use a different "model" property but put a |
735 | value in "compatible". The kernel doesn't directly use that | 734 | value in "compatible". The kernel doesn't directly use that |
736 | value (see /chosen/linux,platform for how the kernel chooses a | 735 | value but it is generally useful. |
737 | platform type) but it is generally useful. | ||
738 | 736 | ||
739 | The root node is also generally where you add additional properties | 737 | The root node is also generally where you add additional properties |
740 | specific to your board like the serial number if any, that sort of | 738 | specific to your board like the serial number if any, that sort of |
@@ -778,7 +776,6 @@ address which can extend beyond that limit. | |||
778 | bytes | 776 | bytes |
779 | - d-cache-size : one cell, size of L1 data cache in bytes | 777 | - d-cache-size : one cell, size of L1 data cache in bytes |
780 | - i-cache-size : one cell, size of L1 instruction cache in bytes | 778 | - i-cache-size : one cell, size of L1 instruction cache in bytes |
781 | - linux, boot-cpu : Should be defined if this cpu is the boot cpu. | ||
782 | 779 | ||
783 | Recommended properties: | 780 | Recommended properties: |
784 | 781 | ||
@@ -843,11 +840,6 @@ address which can extend beyond that limit. | |||
843 | the prom_init() trampoline when booting with an OF client interface, | 840 | the prom_init() trampoline when booting with an OF client interface, |
844 | but that you have to provide yourself when using the flattened format. | 841 | but that you have to provide yourself when using the flattened format. |
845 | 842 | ||
846 | Required properties: | ||
847 | |||
848 | - linux,platform : This is your platform number as assigned by the | ||
849 | architecture maintainers | ||
850 | |||
851 | Recommended properties: | 843 | Recommended properties: |
852 | 844 | ||
853 | - bootargs : This zero-terminated string is passed as the kernel | 845 | - bootargs : This zero-terminated string is passed as the kernel |
diff --git a/Documentation/sony-laptop.txt b/Documentation/sony-laptop.txt new file mode 100644 index 000000000000..dfd26df056f4 --- /dev/null +++ b/Documentation/sony-laptop.txt | |||
@@ -0,0 +1,106 @@ | |||
1 | Sony Notebook Control Driver (SNC) Readme | ||
2 | ----------------------------------------- | ||
3 | Copyright (C) 2004- 2005 Stelian Pop <stelian@popies.net> | ||
4 | Copyright (C) 2007 Mattia Dongili <malattia@linux.it> | ||
5 | |||
6 | This mini-driver drives the SNC device present in the ACPI BIOS of | ||
7 | the Sony Vaio laptops. | ||
8 | |||
9 | It gives access to some extra laptop functionalities. In its current | ||
10 | form, this driver let the user set or query the screen brightness | ||
11 | through the backlight subsystem and remove/apply power to some devices. | ||
12 | |||
13 | Backlight control: | ||
14 | ------------------ | ||
15 | If your laptop model supports it, you will find sysfs files in the | ||
16 | /sys/class/backlight/sony/ | ||
17 | directory. You will be able to query and set the current screen | ||
18 | brightness: | ||
19 | brightness get/set screen brightness (an iteger | ||
20 | between 0 and 7) | ||
21 | actual_brightness reading from this file will query the HW | ||
22 | to get real brightness value | ||
23 | max_brightness the maximum brightness value | ||
24 | |||
25 | |||
26 | Platform specific: | ||
27 | ------------------ | ||
28 | Loading the sony-laptop module will create a | ||
29 | /sys/devices/platform/sony-laptop/ | ||
30 | directory populated with some files. | ||
31 | |||
32 | You then read/write integer values from/to those files by using | ||
33 | standard UNIX tools. | ||
34 | |||
35 | The files are: | ||
36 | brightness_default screen brightness which will be set | ||
37 | when the laptop will be rebooted | ||
38 | cdpower power on/off the internal CD drive | ||
39 | audiopower power on/off the internal sound card | ||
40 | lanpower power on/off the internal ethernet card | ||
41 | (only in debug mode) | ||
42 | |||
43 | Note that some files may be missing if they are not supported | ||
44 | by your particular laptop model. | ||
45 | |||
46 | Example usage: | ||
47 | # echo "1" > /sys/devices/platform/sony-laptop/brightness_default | ||
48 | sets the lowest screen brightness for the next and later reboots, | ||
49 | # echo "8" > /sys/devices/platform/sony-laptop/brightness_default | ||
50 | sets the highest screen brightness for the next and later reboots, | ||
51 | # cat /sys/devices/platform/sony-laptop/brightness_default | ||
52 | retrieves the value. | ||
53 | |||
54 | # echo "0" > /sys/devices/platform/sony-laptop/audiopower | ||
55 | powers off the sound card, | ||
56 | # echo "1" > /sys/devices/platform/sony-laptop/audiopower | ||
57 | powers on the sound card. | ||
58 | |||
59 | Development: | ||
60 | ------------ | ||
61 | |||
62 | If you want to help with the development of this driver (and | ||
63 | you are not afraid of any side effects doing strange things with | ||
64 | your ACPI BIOS could have on your laptop), load the driver and | ||
65 | pass the option 'debug=1'. | ||
66 | |||
67 | REPEAT: DON'T DO THIS IF YOU DON'T LIKE RISKY BUSINESS. | ||
68 | |||
69 | In your kernel logs you will find the list of all ACPI methods | ||
70 | the SNC device has on your laptop. You can see the GCDP/GCDP methods | ||
71 | used to pwer on/off the CD drive, but there are others. | ||
72 | |||
73 | I HAVE NO IDEA WHAT THOSE METHODS DO. | ||
74 | |||
75 | The sony-laptop driver creates, for some of those methods (the most | ||
76 | current ones found on several Vaio models), an entry under | ||
77 | /sys/devices/platform/sony-laptop, just like the 'cdpower' one. | ||
78 | You can create other entries corresponding to your own laptop methods by | ||
79 | further editing the source (see the 'sony_acpi_values' table, and add a new | ||
80 | entry to this table with your get/set method names using the | ||
81 | HANDLE_NAMES macro). | ||
82 | |||
83 | Your mission, should you accept it, is to try finding out what | ||
84 | those entries are for, by reading/writing random values from/to those | ||
85 | files and find out what is the impact on your laptop. | ||
86 | |||
87 | Should you find anything interesting, please report it back to me, | ||
88 | I will not disavow all knowledge of your actions :) | ||
89 | |||
90 | Bugs/Limitations: | ||
91 | ----------------- | ||
92 | |||
93 | * This driver is not based on official documentation from Sony | ||
94 | (because there is none), so there is no guarantee this driver | ||
95 | will work at all, or do the right thing. Although this hasn't | ||
96 | happened to me, this driver could do very bad things to your | ||
97 | laptop, including permanent damage. | ||
98 | |||
99 | * The sony-laptop and sonypi drivers do not interact at all. In the | ||
100 | future, sonypi could use sony-laptop to do (part of) its business. | ||
101 | |||
102 | * spicctrl, which is the userspace tool used to communicate with the | ||
103 | sonypi driver (through /dev/sonypi) does not try to use the | ||
104 | sony-laptop driver. In the future, spicctrl could try sonypi first, | ||
105 | and if it isn't present, try sony-laptop instead. | ||
106 | |||