EC Register Settings: Difference between revisions

From OLPC
Jump to navigation Jump to search
(Proper name for Open Firmware)
 
(67 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Category:Firmware]]
[[Category:Hardware]]
[[Category:SoC Project]]
{{OLPC}}
{{draft}}


Current Embedded Controller register Settings
Current Embedded Controller register Settings



'''WORK IN PROGRESS'''


=OFW Dump=
=OFW Dump=
Using [http://dev.laptop.org/~joel/ec-dump.fth ec-dump.fth] under [[Open Firmware]]: ['''old dump''']

GPIOO fc00: 68 0 1e 0
GPIOO fc00: 68 0 1e 0
GPIOE fc10: 7 d7 ff 1 b fd
GPIOE fc10: 7 d7 ff 1 b fd
Line 22: Line 31:
GPWUEN ff30: 10 0 0 0
GPWUEN ff30: 10 0 0 0
GPWUPF ff40: 89 8 16 c
GPWUPF ff40: 89 8 16 c
GPWUPS ff50: 0 8 0 0
GPWUEL ff60: 0 8 0 0

* EC dump Q2C25
GPIOO fc00: 68 0 1e 0
GPIOE fc10: 87 d7 fe 1 f bd
GPIOD fc20: e 95 1 0 1 60
GPIOIN fc30: fe bf f7 e ff 71 27
GPIOPU fc40: 0 0 0 0 0 0
GPIOOD fc50: 0 80 0 0
GPIOIE fc60: 19 68 1e f f4 c0 3c
GPIOM fc70: 1
KBC fc80: 60 43 0 ff ae f4 10
PWM fe00: 0 0 0 0 0 0 cf cf 0 80 80 0 ff ff
GPT fe50: f 0 0 43 0 fa 27 10 0 20
SPI fea0: 0 0 0 0 0 64 24 0 0 0 0 0 0 4 0 0
WDT fe80: 3 0 50 25 9f b
LPC fe90: 2 30 3 80 a0 fd 0 80 0 62 0 0 0 82 c0 1d
PS2 fee0: 2f 0 21 5a 1 af 2f
EC ff00: a0 0 f 50 3 80 0 0 8d f0 83 1 17 94 52 95 0 0 1f 11 2 3 3e 83 0 1f 0 0 0 20 37 0
GPWUEN ff30: 10 0 0 0
GPWUPF ff40: 9 49 fe d
GPWUPS ff50: 0 0 0 0
GPWUEL ff60: 0 0 0 0

*EC dump Q2C26

GPIOO fc00: 68 0 1e 0
GPIOE fc10: 7 d7 fe 1 b bd
GPIOD fc20: e 95 1 0 1 60
GPIOIN fc30: f6 bf f7 e ff 71 27
GPIOPU fc40: 0 0 0 0 0 0
GPIOOD fc50: 0 80 0 0
GPIOIE fc60: 99 68 1e f f4 c0 3c
GPIOM fc70: 1
KBC fc80: 60 43 0 ff ae f4 10
PWM fe00: 0 0 0 0 0 0 cf cf 0 80 80 0 ff ff
GPT fe50: f 0 0 43 0 fa 27 10 0 20
SPI fea0: 0 0 0 0 0 64 24 0 0 0 0 0 0 4 0 0
WDT fe80: 0 0 50 1e 4d 9
LPC fe90: 2 30 3 80 a0 fd 0 80 0 62 0 0 0 82 c0 1d
PS2 fee0: 2f 0 21 5a 1 af 2f
EC ff00: a0 0 f 50 3 80 0 0 8d f0 83 1 12 94 52 95 0 0 1f 11 2 3 3e 83 4 49 0 0 0 20 37 0
GPWUEN ff30: 10 0 0 0
GPWUPF ff40: 89 48 1e d
GPWUPS ff50: 0 8 0 0
GPWUPS ff50: 0 8 0 0
GPWUEL ff60: 0 8 0 0
GPWUEL ff60: 0 8 0 0


=Register settings=
=Register settings=
==GPIO General Purpose IO (include ADC, DAC)==
==GPIO==


===GPIOO===
===GPIOO===
Line 79: Line 133:




==KBC==
==KBC Keyboard Controller==
fc80: 60 43 0 ff ae f4 10
fc80: 60 43 0 ff ae f4 10


Line 162: Line 216:
</table>
</table>


==PWM==
==PWM Pulse Width Modulation==
fe00: 0 0 0 0 0 0 cf cf 0 80 80 0 ff ff
fe00: 0 0 0 0 0 0 cf cf 0 80 80 0 ff ff


Line 259: Line 313:
0xFF
0xFF


==GPT General Purpose 16-bit timer==
==GPT==
fe50: f 0 0 43 0 fa 27 10 0 20
fe50: f 0 0 43 0 fa 27 10 0 20


Line 350: Line 404:
fe85 03->00
fe85 03->00


==LPC==
==LPC Low Pin Count==
'''Low Pin Count / Firmware Hub'''
'''Low Pin Count / Firmware Hub'''
fe90: 2 30 3 80 a0 fd 0 80 0 62 0 0 0 82 c0 1d
fe90: 2 30 3 80 a0 fd 0 80 0 62 0 0 0 82 c0 1d
Line 451: Line 505:
</table>
</table>


==EC Embedded Controller (hardware EC Space)==
==EC==
'''EC Registers'''
'''EC Registers'''
ff00: a0 0 f 50 3 80 0 0 8c f0 83 20 12 94 52 95 0 0 1f 11 0 b 3e 83 9 0 0 0 0 20 37 0
ff00: a0 0 f 50 3 80 0 0 8c f0 83 20 12 94 52 95 0 0 1f 11 0 b 3e 83 9 0 0 0 0 20 37 0


===ECHV===
===ECHV===
'''EC Hardware Revision ID''' A0 (default)
'''EC Hardware Revision ID''' A0 (default)
* OFWDUMP same


===ECFV===
===ECFV===
'''EC Firmware Revision ID''' 0 (default)
'''EC Firmware Revision ID''' 0 (default)
* OFWDUMP same


===ECHA===
===ECHA===
'''EC High Address'''
'''EC High Address''' default (F)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
Line 469: Line 525:
<tr><td>3-0</td> <td>1111</td> <td>High-byte address of 64Kbyte EC address base.</td></tr>
<tr><td>3-0</td> <td>1111</td> <td>High-byte address of 64Kbyte EC address base.</td></tr>
</table>
</table>

* OFWDUMP same


===SCICFG===
===SCICFG===
'''SCI Configuration'''
'''SCI Configuration''' default (90)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>0</td> <td>Enable generation of SCI by standard EC commands (default enable)</td></tr>
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>1</td> <td>Enable SCID port (Firmware generated SCI)</td></tr>
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
<tr><td>5</td> <td>0</td> <td>EC SCI pulse polarity (1 low active (default), 0 high active)</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
<tr><td>4</td> <td>1</td> <td>Enable EC SCI (set 1) from SCIIFx (default enabled)</td></tr>
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
<tr><td>3~0</td> <td>0</td> <td>SCI pluse width = SCIPW x 64us. if 0, pluse width is system clock</td></tr>
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
</table>
</table>

* OFWDUMP 50
**diff
***EC SCI pulse polarity low active
***disabled EC SCI


===ECCFG===
===ECCFG===
'''EC Configuration'''
'''EC Configuration''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>0</td> <td>Enable EPB Fast Access</td></tr>
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>0</td> <td>Test mode (Set to 0 for normal operation)</td></tr>
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
<tr><td>5</td> <td>0</td> <td>Enable hardware EC Read/Write command</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
<tr><td>4</td> <td>0</td> <td>Enable hardware EC Burst Enable/Disable command</td></tr>
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
<tr><td>3</td> <td>0</td> <td>Enable hardware EC Query command</td></tr>
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
<tr><td>2</td> <td>0</td> <td>Enable Extended IO port interrupt to 8051</td></tr>
<tr><td>1</td> <td>1</td> <td>IBF Interrupt Enable. also be the Firmware Mode Enable. This bit enables KBC to generate interrupt to the 8051 at the rising edge of IBF, when the KBC command being received will be bypassed to firmware for processing.</td></tr>
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
<tr><td>0</td> <td>1</td> <td>OBF Interrupt enable. This bit enables KBC to generate interrupt to the core processor at the falling edge of OBF.</td></tr>
</table>
</table>


* OFWDUMP 3
===SCIE===
**diff
***

===SCIE0===
'''Enable extended 8051 Port0 interrupt to SCI''' default (0)

===SCIE1===
'''Enable extended 8051 Port1 interrupt to SCI''' default (0)

===SCIE3 ===
'''Enable extended 8051 Port3 interrupt to SCI''' default (0)

===SCIF0===
'''Flag for extended 8051 Port0 interrupt to SCI''' default (0)

===SCIF1===
'''Flag for extended 8051 Port1 interrupt to SCI''' default (0)


===SCIF===
===SCIF3===
'''Flag for extended 8051 Port3 interrupt to SCI''' default (0)


===SCID===
===SCID===
'''EC SCI_ID Write port for 8051 firmware to generate SCI event''' default (0)


===PMUCFG===
===PMUCFG===
'''PMU Control / Configuration'''
'''PMU Control / Configuration''' default (2F)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>1</td> <td>Enable PLL enter low speed state in STOP mode</td></tr>
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>0</td> <td>Flash (SPI) Interface Clock Control</td></tr>
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
<tr><td>5</td> <td>0</td> <td>Enable PLL to generate 32.768Mhz</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
<tr><td>4</td> <td>1</td> <td>Enable PLL enter low power state in STOP mode</td></tr>
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
<tr><td>3~2</td> <td>01</td> <td>8051/Peripherals Normal Run Clock Selection
10: 22/8 MHz<br />
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
01: 16/8 MHz<br />
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
00: 8/4 MHz (default) the SPI clock is 16Mhz in this setting.<br />
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
Clock rate is fixed in 2/1MHz when 8051 in IDE if CLKCFG.0 is set. The flash interface (SPI or ISA) is fixed at 32.768 Mhz or higher by CLCKCFG.6 setting.</td></tr>
<tr><td>1</td> <td>0</td> <td>Enable Peripheral Auto Slow Clock control to be 1Mhz</td></tr>
<tr><td>0</td> <td>0</td> <td>Enable 8051 IDLE mode slow clock control to be 1/2 Mhz</td></tr>
</table>
</table>


===CLKCFG===
===CLKCFG===
'''Clock Configuration'''
'''Clock Configuration''' default (00)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>0</td> <td> Enable PLL enter low speed state in STOP mode.
Set PLL frequency control value to be PLLLOW in STOP mode.
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
The CLKCFG bit 4 should also be enabled for this option.
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>3-2</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>0</td> <td> Flash (SPI) Interface Clock Control
* 1: full speed (Internal clock is 66(+-%25) MHz )
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
* 0: half speed (default, ½ of supplied clock)
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
* SPI clock is 16MHz if CLKCFG set to 8 / 4 MHz.
* SPI clock is stopped when 8051 in IDLE if CLKCFG.0 is set.
</td></tr>
<tr><td>5</td> <td>0</td> <td> Enable PLL to generate a good 32.768MHz. (default reset PLL)
This bit should be set after PCICLK is stable.
</td></tr>
<tr><td>4</td> <td>0</td> <td>Enable PLL enter low power state in STOP mode</td></tr>
<tr><td>3-2</td> <td>0</td> <td> 8051 / Peripherals Normal Run Clock Selection.
* 10: 22 / 8 MHz
* 01: 16 / 8 MHz
* 00: 8 / 4 MHz (default) The SPI clock is 16MHz in this setting.
Clock rate is fixed in 2/1MHz when 8051 in IDLE if CLKCFG.0 is set.
The flash interface (SPI or ISA) is fixed in 32.768 MHz or higher by
CLKCFG.6 setting.
</td></tr>
<tr><td>1</td> <td>0</td> <td> Enable Peripheral Auto Slow Clock Control to be 1 MHz.
The Peripheral's clock will be 1 MHz when no host accessing.
</td></tr>
<tr><td>0</td> <td>0</td> <td> Enable 8051 IDLE Mode Slow Clock Control to be 2 / 1 MHz.
When 8051 enters IDLE state, the clock of 8051 and peripherals will changed
automatically to 2 / 1 MHz. And the flash interface clock will be stop if this bit
is set.
</td></tr>
</table>
</table>


===EXTIO===
===EXTIO===
'''EC Extended Write IO Data'''
'''EC Extended Write IO Data''' default (0)



===PLLCFG===
===PLLCFG===
'''PLL Configuration'''
'''PLL Configuration''' default (70)

===RSV===
foo


===CLKCFG2===
===CLKCFG2===
Clock Configuration 2
'''Clock Configuration 2''' default (1F)


===PLLCFG2===
===PLLCFG2===
'''PLL Configuration 2'''
'''PLL Configuration 2''' default (11)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7-6</td> <td>0</td> <td>foo</td></tr>
<tr><td>7-6</td> <td>0</td> <td> PLLINIT High Bits (PLLINITH)
High 2 bits of PLL frequency control initial value(PLLINIT).
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
Combine with FF0Fh to be 10 bits frequency control value.
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>3~0</td> <td>0</td> <td>foo</td></tr>
<tr><td>5</td> <td>0</td> <td>PLL Reference Selection
* 0: select PCI clock(LPC clock) as reference clock of PLL.(default)
* 1: select alternative clock source from GPIO02 Alt. input.
</td></tr>
<tr><td>4</td> <td>0</td> <td>PLL Source Clock Divider
* 0: Disable
* 1: Enable (default)
The PLL build-in a 1024(10-bit) divider for source clock.For PLL reference
clock is high speed, as PCICLK, the divider should be enabled. For PLL
reference clock is low speed, as 32KHz from GPIO02 Alt. Input, the divider
should be disabled.
</td></tr>
<tr><td>3~0</td> <td>0</td> <td> PLL Low Speed State Setting
As Enable PLL enter low speed state in STOP mode,
Use this value as PLL frequency control.
</td></tr>
</table>
</table>


===PXCFG===
===PXCFG===
'''8051 on-chip Control'''
'''8051 on-chip Control''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7~1</td> <td>0</td> <td>RSV</td></tr>
<tr><td>7~2</td> <td>0</td> <td>RSV</td></tr>
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
<tr><td>1</td> <td>0</td> <td> Enable WDT timeout only reset 8051
* 1: WDT timeout event only resets 8051.
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
* 0: The WDT timeout event resets whole chip
(not including GPIO module)
</td></tr>
<tr><td>0</td> <td>0</td> <td>Reset 8051 and 8051 internal peripherals(8051 serial port, timer, interrupt controller) . After reset, the 8051 will restart from reset vector if this bit is reset
to '0'. Write '1' to reset 8051. Write '0' to restart 8051.
</td></tr>
</table>
</table>


===ADDAEN===
===ADDAEN===
'''ADC/DAC Enable'''
'''ADC/DAC Enable''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>0</td> <td>Select converting ADC channel 5 (Valid in A1 Version only)</td></tr>
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>0</td> <td>Select converting ADC channel 4 (Valid in A1 Version only)</td></tr>
<tr><td>5=0</td> <td>0</td> <td>foo</td></tr>
<tr><td>5-0</td> <td>0</td> <td>Enable ADC5~0</td></tr>
</table>
</table>


===PLLFRH===
===PLLFRH===
'''PLL Frequency Register High Byte'''
'''PLL Frequency Register High Byte''' default (3E)


===PLLFRL===
===PLLFRL===
'''PLL Frequency Register Low Byte'''
'''PLL Frequency Register Low Byte''' default (83)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7~4</td> <td>0</td> <td>foo</td></tr>
<tr><td>7~4</td> <td>0</td> <td>32MHz clock count 32.768KHz value[3:0]</td></tr>
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
<tr><td>3</td> <td>0</td> <td>Enable show PLL lock value in CHIP ID reg</td></tr>
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
<tr><td>2</td> <td>0</td> <td> Enable PLL logic from test mode clock for testing.

<tr><td>1~0</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>1~0</td> <td>0</td> <td> Set PLL frequency count don't care bits
* 0: all comparing
* 1: don't care bit 1
* 2: don't care bit 1~0
* 3: don't care bit 2~0
</td></tr>
</table>
</table>


===ADCTRL===
===ADCTRL===
'''ADC Control Register'''
'''ADC Control Register''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>RSV</td></tr>
<tr><td>7-5</td> <td>0</td> <td>RSV</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
<tr><td>4-2</td> <td>0</td> <td> Select converting ADC channel (ADC5~0)
NOTE: ONLY Channel 3~0 is valid in A0 and A1 version. All these three bit
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
need to set ZERO if channel 4 or 5 selected using ADDAEN.
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
<tr><td>1</td> <td>0</td> <td>ADC test mode</td></tr>
<tr><td>0</td> <td>0</td> <td>Start (write 1 action ) ADC converter and Enable ADC converted interrupt</td></tr>
</table>
</table>


===ADCDAT===
===ADCDAT===
'''ADC Data output port''' After ADC converted, the value is held here.
'''ADC Data output port''' After ADC converted, the value is held here. default (0)


===ECIF===
===ECIF===
'''EC Interrupt Pending Flag'''
'''EC Interrupt Pending Flag''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>RSV</td></tr>
<tr><td>7-3</td> <td>0</td> <td>RSV</td></tr>
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
<tr><td>2</td> <td>0</td> <td> EC firmware mode in processing flag
Exit EC firmware mode and re-enable hardware mode by writing 1
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>1</td> <td>0</td> <td>IBF interrupt pending flag, as ECSTS IBF is set by host write</td></tr>
<tr><td>0</td> <td>0</td> <td>OBF interrupt pending flag, as ECSTS OBF is clear by host read ECDAT
0
</td></tr>
</table>
</table>


===ECDAT===
===ECDAT===
'''EC Data Port''' Window between host and EC
'''EC Data Port''' Window between host and EC default (0)


===ECCMD===
===ECCMD===
'''EC Command Port''' Stores the latest EC command from host.
'''EC Command Port''' Stores the latest EC command from host. default (0)


===ECSTS===
===ECSTS===
'''EC Status port'''
'''EC Status port''' default (0)


<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><th>Bit</th> <th>State</th><th>Description</th></tr>
<tr><td>7</td> <td>0</td> <td>foo</td></tr>
<tr><td>7</td> <td>0</td> <td>Free r/w bit for host interface</td></tr>
<tr><td>6</td> <td>0</td> <td>foo</td></tr>
<tr><td>6</td> <td>0</td> <td>Free r/w bit for host interface</td></tr>
<tr><td>5</td> <td>0</td> <td>foo</td></tr>
<tr><td>5</td> <td>0</td> <td>SCI pending flag</td></tr>
<tr><td>4</td> <td>0</td> <td>foo</td></tr>
<tr><td>4</td> <td>0</td> <td>Burst Enable Status</td></tr>
<tr><td>3</td> <td>0</td> <td>foo</td></tr>
<tr><td>3</td> <td>0</td> <td>
A2 (Command or Data Flag)
<tr><td>2</td> <td>0</td> <td>foo</td></tr>
* =0, previous host write is Data
<tr><td>1</td> <td>0</td> <td>foo</td></tr>
* =1, previous host write is Command
<tr><td>0</td> <td>0</td> <td>foo</td></tr>
</td></tr>
<tr><td>2</td> <td>0</td> <td>RSV</td></tr>
<tr><td>1</td> <td>0</td> <td>IBF, write IBF = 1 to clear IBF</td></tr>
<tr><td>0</td> <td>0</td> <td>OBF, write port ECDAT will set OBF to 1. Write OBF = 1 to clear OBF</td></tr>
</table>
</table>


==GPWU==
===PLLVAL===
Chip Part No. / PLL lock value (works if bit 3 of PLLFRL is enabled)

==GPWU (hardware EC Space)==
'''General Purpose Wake Up'''
'''General Purpose Wake Up'''
GPWUEN ff30: 10 0 0 0
GPWUEN ff30: 10 0 0 0
Line 677: Line 825:
</tr>
</tr>
</table>
</table>
[[Category:EC]]

Latest revision as of 17:56, 6 October 2012


  This page is monitored by the OLPC team.


Pencil.png NOTE: The contents of this page are not set in stone, and are subject to change!

This page is a draft in active flux ...
Please leave suggestions on the talk page.

Pencil.png


Current Embedded Controller register Settings


OFW Dump

Using ec-dump.fth under Open Firmware: [old dump] 

GPIOO  fc00:   68  0 1e  0
GPIOE  fc10:    7 d7 ff  1  b fd
GPIOD  fc20:    e 91  0  0  9 60
GPIOIN fc30:   fe b7 f7  e ff 71 2b
GPIOPU fc40:    0  0  0  0  0  0
GPIOOD fc50:    0 80  0  0
GPIOIE fc60:   99 68 1e  f f4 c0 34
GPIOM  fc70:    1
KBC    fc80:   60 43  0 ff ae f4 10
PWM    fe00:    0  0  0  0  0  0 cf cf  0 80 80  0 ff ff
GPT    fe50:    f  0  0 43  0 fa 27 10  0 20
SPI    fea0:    0  0  0  0  0 64  4  0  0  0  0  0  0  4  0  0
WDT    fe80:    0  0  0 70 5a  7
LPC    fe90:    2 30  3 80 a0 fd  0 80  0 62  0  0  0 82 c0 1d
PS2    fee0:   2f  0 21 76  1 af 2f
EC     ff00:   a0  0  f 50  3 80  0  0 8c f0 83 20 12 94 52 95  0  0 1f 11  0  b 3e 83  9  0  0  0  0 20 37  0
GPWUEN ff30:   10  0  0  0
GPWUPF ff40:   89  8 16  c
GPWUPS ff50:    0  8  0  0
GPWUEL ff60:    0  8  0  0
  • EC dump Q2C25
GPIOO  fc00:   68  0 1e  0
GPIOE  fc10:   87 d7 fe  1  f bd
GPIOD  fc20:    e 95  1  0  1 60
GPIOIN fc30:   fe bf f7  e ff 71 27
GPIOPU fc40:    0  0  0  0  0  0
GPIOOD fc50:    0 80  0  0
GPIOIE fc60:   19 68 1e  f f4 c0 3c
GPIOM  fc70:    1
KBC    fc80:   60 43  0 ff ae f4 10
PWM    fe00:    0  0  0  0  0  0 cf cf  0 80 80  0 ff ff
GPT    fe50:    f  0  0 43  0 fa 27 10  0 20
SPI    fea0:    0  0  0  0  0 64 24  0  0  0  0  0  0  4  0  0
WDT    fe80:    3  0 50 25 9f  b
LPC    fe90:    2 30  3 80 a0 fd  0 80  0 62  0  0  0 82 c0 1d
PS2    fee0:   2f  0 21 5a  1 af 2f
EC     ff00:   a0  0  f 50  3 80  0  0 8d f0 83  1 17 94 52 95  0  0 1f 11  2  3 3e 83  0 1f  0  0  0 20 37  0
GPWUEN ff30:   10  0  0  0
GPWUPF ff40:    9 49 fe  d
GPWUPS ff50:    0  0  0  0
GPWUEL ff60:    0  0  0  0
  • EC dump Q2C26
GPIOO  fc00:   68  0 1e  0  
GPIOE  fc10:    7 d7 fe  1  b bd
GPIOD  fc20:    e 95  1  0  1 60
GPIOIN fc30:   f6 bf f7  e ff 71 27
GPIOPU fc40:    0  0  0  0  0  0
GPIOOD fc50:    0 80  0  0
GPIOIE fc60:   99 68 1e  f f4 c0 3c
GPIOM  fc70:    1
KBC    fc80:   60 43  0 ff ae f4 10
PWM    fe00:    0  0  0  0  0  0 cf cf  0 80 80  0 ff ff
GPT    fe50:    f  0  0 43  0 fa 27 10  0 20
SPI    fea0:    0  0  0  0  0 64 24  0  0  0  0  0  0  4  0  0
WDT    fe80:    0  0 50 1e 4d  9
LPC    fe90:    2 30  3 80 a0 fd  0 80  0 62  0  0  0 82 c0 1d
PS2    fee0:   2f  0 21 5a  1 af 2f
EC     ff00:   a0  0  f 50  3 80  0  0 8d f0 83  1 12 94 52 95  0  0 1f 11  2  3 3e 83  4 49  0  0  0 20 37  0
GPWUEN ff30:   10  0  0  0
GPWUPF ff40:   89 48 1e  d
GPWUPS ff50:    0  8  0  0
GPWUEL ff60:    0  8  0  0

Register settings

GPIO General Purpose IO (include ADC, DAC)

GPIOO

Output Function Select

1 - Alt. output

0 - GPO 

fc00:   68  0 1e  0

GPIOE

Output Enable

1 - Enable

0 - Disable 

fc10:    7 d7 ff  1  b fd

GPIOD

Data Output 

fc20:    e 91  0  0  9 60

GPIOIN

Input Status 

fc30:   fe b7 f7  e ff 71 2b

GPIOPU

Pull Up Enable 

fc40:    0  0  0  0  0  0

GPIOOD

Open Drain Enable 

fc50:    0 80  0  0

GPIOIE

Input Enable 

fc60:   99 68 1e  f f4 c0 34

GPIOM

Misc 

fc70:    1


KBC Keyboard Controller

fc80:   60 43  0 ff ae f4 10

KBCCB

KBC Command Byte

Bit StateDescription
7 0 RSV
6 1 Scan Code Conversion
5 1 Auxiliary Device Disable
4 0 Keyboard Device Disable
3 0 Inhibit Override
2 0 System Flag
1 0 IRQ12 Enable
0 0 IRQ1 Enable


KBCCFG

KBC Configuration

Bit StateDescription
7 0 Keyboard Lock Enable
6 1 Fast Gate A20 Control
5 0 RSV
4 0 RSV
3 0 Keyboard Lock
2 0 RSV
1 1 IBF Interrupt Enable
0 1 OBF Interrupt Enable


KBCIF

KBC Interrupt Flag Pending Flag

Bit StateDescription
7~3 0 RSV
2 0 KBC Firmware mode in processing flag. Write 1 to exit firmware mode
1 0 IBF Interrupt pending flag
0 0 OBF Interrupt pending flag

KBCHWEN

KBC Hardware Command Enable

Bit StateDescription
7 1 FEh: KB Reset command processed by hardware
6 1 E0h: read test input command processed by hardware
5 1 D3h: write AUX output buffer
4 1 D2h: write KB output buffer
3 1 D1h: write P2 command command processed by hardware
2 1 D0h: read P2 command processed by hardware
1 1 C0h: read P0 command processed by hardware
0 1 20h: read command byte processed by hardware


KBCCMD

KBC Command Buffer The data written to IO port 64h will be stored in this register

KBCDAT

KBC Data IO Buffer' Writing to this register will cause OBF (Output Buffer Full) to set. Host reads this port through IO port 60h.

KBCSTS

KBC Host Status

Bit StateDescription
7 0 Parity Error
6 0 Timeout
5 0 Auxiliary Data Flag
4 0 Uninhibited
3 1 Address (A2)
2 0 System Flag
1 0 IBF
0 0 OBF

PWM Pulse Width Modulation

fe00:    0  0  0  0  0  0 cf cf  0 80 80  0 ff ff

PWMCFG

PWM Configuration

Bit StateDescription
7~6 0 PWM1 Clock source selection
5 0 RSV
4 0 PWM1 Enable
3~2 0 PWM0 Clock source selection
1 0 RSV
0 0 PWM0 Enable

PWMHIGH0

PWM0 High Period Length 

0x00

PWMCYCL0

PWM0 Cycle Length 

0x00

PWMHIGH1

PWM1 High Period Length 

0x00

PWMCYCL1

PWM1 Cycle Length 

0x00

PWMCFG2

PWM2 Configuration

Bit StateDescription
7 0 PWM2 Enable
6 0 PWM prescaler clock select (0: peripheral clock, 1: 1Mhz clock)
5~0 0 6-bit prescaler for PWM by selected clock

PWMCFG3

PWM3 Configuration

Bit StateDescription
7 1 PWM3 Enable
6 1 PWM prescaler clock select (0: peripheral clock, 1: 1Mhz clock)
5~0 1111 6-bit prescaler for PWM by selected clock

PWMCFG4

PWM4 Configuration

Bit StateDescription
7 1 PWM4 Enable
6 1 PWM prescaler clock select (0: peripheral clock, 1: 1Mhz clock)
5~0 1111 6-bit prescaler for PWM by selected clock


PWMHIGH2

PWM2 High Period Length High byte 

0x00

PWMHIGH3

PWM3 High Period Length High byte 

0x80

PWMHIGH4

PWM4 High Period Length High byte 

0x80

PWMCYC2

PWM2 Cycle Length High byte 

0x00

PWMCYC3

PWM3 Cycle Length High byte 

0xFF

PWMCYC4

PWM4 Cycle Length High byte 

0xFF

GPT General Purpose 16-bit timer

fe50:    f  0  0 43  0 fa 27 10  0 20

GPTCFG

GTP Configuration

Bit StateDescription
7~5 0 RSV
4 0 GPT Test mode - GPT base clock will be system lcok
3 1 Enable GPT3 counting and interrupt
2 1 Enable GPT2 counting and interrupt
1 1 Enable GPT1 counting and interrupt
0 1 Enable GPT0 counting and interrupt


GPTPF

GPT Pending Flag

Bit StateDescription
7 0 Write 1 to start GPT3
6 0 Write 1 to start GPT2
5 0 Write 1 to start GPT1
4 0 Write 1 to start GPT0
3 0 GPT3 interrupt pending flag
2 0 GPT2 interrupt pending flag
1 0 GPT1 interrupt pending flag
0 0 GPT0 interrupt pending flag


GPT0

GPT0 Count Value Once timer has reached this level, interrupt will occur and timer will restart from zero. 

0x00

GPT1

GPT1 Count Value 

0x43

GPT2H,L

GPT2 Count Value 

0x00fa

GPT3H,L

GPT3 Count Value 

0x2710

SPI

fea0:    0  0  0  0  0 64  4  0  0  0  0  0  0  4  0  0

Watchdog Timer

WDT    fe80:    0  0  0 70 5a  7

WDTCFG

WDT Configuration

Bit State Description
7 0 WDT Extended Bits Enable (0=20 bit timer)
6~3 0000Force disable/set test mode/unset test mode
2 0 WDT Clock Selection for testing (0=normal)
1 0 Enable WDT interrupt
0 0 WDT timer reset

WDTPF

WDT Pending Flag

Bit State Description
7~5 0 RSV
1 0If set, next WDT timeout event will cause WDT reset signal
0 0 WDT reset event pending

WTDCNT

WDT 8-bit Count Value Once WDT reaches this value, interrupt will occur.

WTD Testing Counter Value

For testing WDT 

fe83 19->12
fe84 11->04
fe85 03->00

LPC Low Pin Count

Low Pin Count / Firmware Hub 

fe90:    2 30  3 80 a0 fd  0 80  0 62  0  0  0 82 c0 1d

PS2

PS2 Controller 

fee0:   2f  0 21 76  1 af 2f

PS2CFG

PS2 Configuration

Bit StateDescription
7 0 RSV
6 0 Enable PS2 port 2
5 1 Enable PS2 port 1
4 0 RSV
3 1 Enable interrupt of PS2 parity error
2 1 Enable interrupt of PS2 TX timeout
1 1 Enable interrupt of PS2 transmitted byte
0 1 Enable interrupt of PS2 received byte

PS2PF

PS2 Pending Flag

Bit StateDescription
7 0 RSV
6 0 Received byte port is PS2 port 2
5 0 Received byte port is PS2 port 1
4 0 RSV
3 0 Interrupt pending flag of PS2 parity error
2 0 Interrupt pending flag of PS2 TX timeout
1 0 Interrupt pending flag of PS2 PS2 transmitted byte
0 0 Interrupt pending flag of PS2 received byte

PS2CTRL

PS2 Transmitter / Receiver Control

Bit StateDescription
7 0 RSV
6 0 Transmit byte port is PS2 port 1
5 1 Transmit byte port is PS2 port 1
4 0 RSV
3 0 Force reset of PS2 transmitter state
2 0 Force reset of PS2 reciever state
1 0 Flag of PS2 RX timeout
0 1 Enable PS2 transmit data port - set to transmit byte over PS2DATA

PS2DATA

PS2 Data

Read to get data of recieved byte from a PS2 device.

Write to transmit to a PS2 device. Will clear previous state.

PS2CFG2

PS2 Configuration 2

Bit StateDescription
7~2 0 RSV
1 0 PS2 protocol waiting time enable
0 1 PS2CLK/PS2DAT input de-bounce enable (0: 1us, 1: 2us)

PS2PINS

PS2 pin input status

Bit StateDescription
7 1 RSV
6 0 PS2 port 2 clock
5 1 PS2 port 1 clock
4 0 RSV
3 1 RSV
2 1 PS2 port 2 data
1 1 PS2 port 1 data
0 1 RSV

PS2PINO

PS2 pin output status

Bit StateDescription
7 0 RSV
6 0 PS2 port 2 clock
5 1 PS2 port 1 clock
4 0 RSV
3 1 RSV
2 1 PS2 port 2 data
1 1 PS2 port 1 data
0 1 RSV

EC Embedded Controller (hardware EC Space)

EC Registers 

ff00:   a0  0  f 50  3 80  0  0 8c f0 83 20 12 94 52 95  0  0 1f 11  0  b 3e 83  9  0  0  0  0 20 37  0

ECHV

EC Hardware Revision ID A0 (default)

  • OFWDUMP same

ECFV

EC Firmware Revision ID 0 (default)

  • OFWDUMP same

ECHA

EC High Address default (F)

Bit StateDescription
7~4 0 foo
3-0 1111 High-byte address of 64Kbyte EC address base.
  • OFWDUMP same

SCICFG

SCI Configuration default (90)

Bit StateDescription
7 0 Enable generation of SCI by standard EC commands (default enable)
6 1 Enable SCID port (Firmware generated SCI)
5 0 EC SCI pulse polarity (1 low active (default), 0 high active)
4 1 Enable EC SCI (set 1) from SCIIFx (default enabled)
3~0 0 SCI pluse width = SCIPW x 64us. if 0, pluse width is system clock
  • OFWDUMP 50
    • diff
      • EC SCI pulse polarity low active
      • disabled EC SCI

ECCFG

EC Configuration default (0)

Bit StateDescription
7 0 Enable EPB Fast Access
6 0 Test mode (Set to 0 for normal operation)
5 0 Enable hardware EC Read/Write command
4 0 Enable hardware EC Burst Enable/Disable command
3 0 Enable hardware EC Query command
2 0 Enable Extended IO port interrupt to 8051
1 1 IBF Interrupt Enable. also be the Firmware Mode Enable. This bit enables KBC to generate interrupt to the 8051 at the rising edge of IBF, when the KBC command being received will be bypassed to firmware for processing.
0 1 OBF Interrupt enable. This bit enables KBC to generate interrupt to the core processor at the falling edge of OBF.
  • OFWDUMP 3
    • diff

SCIE0

Enable extended 8051 Port0 interrupt to SCI default (0)

SCIE1

Enable extended 8051 Port1 interrupt to SCI default (0)

SCIE3

Enable extended 8051 Port3 interrupt to SCI default (0)

SCIF0

Flag for extended 8051 Port0 interrupt to SCI default (0)

SCIF1

Flag for extended 8051 Port1 interrupt to SCI default (0)

SCIF3

Flag for extended 8051 Port3 interrupt to SCI default (0)

SCID

EC SCI_ID Write port for 8051 firmware to generate SCI event default (0)

PMUCFG

PMU Control / Configuration default (2F)

Bit StateDescription
7 1 Enable PLL enter low speed state in STOP mode
6 0 Flash (SPI) Interface Clock Control
5 0 Enable PLL to generate 32.768Mhz
4 1 Enable PLL enter low power state in STOP mode
3~2 01 8051/Peripherals Normal Run Clock Selection

10: 22/8 MHz
01: 16/8 MHz
00: 8/4 MHz (default) the SPI clock is 16Mhz in this setting.

Clock rate is fixed in 2/1MHz when 8051 in IDE if CLKCFG.0 is set. The flash interface (SPI or ISA) is fixed at 32.768 Mhz or higher by CLCKCFG.6 setting.
1 0 Enable Peripheral Auto Slow Clock control to be 1Mhz
0 0 Enable 8051 IDLE mode slow clock control to be 1/2 Mhz

CLKCFG

Clock Configuration default (00)

Bit StateDescription
7 0 Enable PLL enter low speed state in STOP mode.

Set PLL frequency control value to be PLLLOW in STOP mode. The CLKCFG bit 4 should also be enabled for this option.

6 0 Flash (SPI) Interface Clock Control
  • 1: full speed (Internal clock is 66(+-%25) MHz )
  • 0: half speed (default, ½ of supplied clock)
  • SPI clock is 16MHz if CLKCFG set to 8 / 4 MHz.
  • SPI clock is stopped when 8051 in IDLE if CLKCFG.0 is set.
5 0 Enable PLL to generate a good 32.768MHz. (default reset PLL)

This bit should be set after PCICLK is stable.

4 0 Enable PLL enter low power state in STOP mode
3-2 0 8051 / Peripherals Normal Run Clock Selection.
  • 10: 22 / 8 MHz
  • 01: 16 / 8 MHz
  • 00: 8 / 4 MHz (default) The SPI clock is 16MHz in this setting.

Clock rate is fixed in 2/1MHz when 8051 in IDLE if CLKCFG.0 is set. The flash interface (SPI or ISA) is fixed in 32.768 MHz or higher by CLKCFG.6 setting.

1 0 Enable Peripheral Auto Slow Clock Control to be 1 MHz.

The Peripheral's clock will be 1 MHz when no host accessing.

0 0 Enable 8051 IDLE Mode Slow Clock Control to be 2 / 1 MHz.

When 8051 enters IDLE state, the clock of 8051 and peripherals will changed automatically to 2 / 1 MHz. And the flash interface clock will be stop if this bit is set.

EXTIO

EC Extended Write IO Data default (0)

PLLCFG

PLL Configuration default (70)

RSV

foo

CLKCFG2

Clock Configuration 2 default (1F)

PLLCFG2

PLL Configuration 2 default (11)

Bit StateDescription
7-6 0 PLLINIT High Bits (PLLINITH)

High 2 bits of PLL frequency control initial value(PLLINIT). Combine with FF0Fh to be 10 bits frequency control value.

5 0 PLL Reference Selection
  • 0: select PCI clock(LPC clock) as reference clock of PLL.(default)
  • 1: select alternative clock source from GPIO02 Alt. input.
4 0 PLL Source Clock Divider
  • 0: Disable
  • 1: Enable (default)

The PLL build-in a 1024(10-bit) divider for source clock.For PLL reference clock is high speed, as PCICLK, the divider should be enabled. For PLL reference clock is low speed, as 32KHz from GPIO02 Alt. Input, the divider should be disabled.

3~0 0 PLL Low Speed State Setting

As Enable PLL enter low speed state in STOP mode, Use this value as PLL frequency control.

PXCFG

8051 on-chip Control default (0)

Bit StateDescription
7~2 0 RSV
1 0 Enable WDT timeout only reset 8051
  • 1: WDT timeout event only resets 8051.
  • 0: The WDT timeout event resets whole chip

(not including GPIO module)

0 0 Reset 8051 and 8051 internal peripherals(8051 serial port, timer, interrupt controller) . After reset, the 8051 will restart from reset vector if this bit is reset

to '0'. Write '1' to reset 8051. Write '0' to restart 8051.

ADDAEN

ADC/DAC Enable default (0)

Bit StateDescription
7 0 Select converting ADC channel 5 (Valid in A1 Version only)
6 0 Select converting ADC channel 4 (Valid in A1 Version only)
5-0 0 Enable ADC5~0

PLLFRH

PLL Frequency Register High Byte default (3E)

PLLFRL

PLL Frequency Register Low Byte default (83)

Bit StateDescription
7~4 0 32MHz clock count 32.768KHz value[3:0]
3 0 Enable show PLL lock value in CHIP ID reg
2 0 Enable PLL logic from test mode clock for testing.
1~0 0 Set PLL frequency count don't care bits
  • 0: all comparing
  • 1: don't care bit 1
  • 2: don't care bit 1~0
  • 3: don't care bit 2~0

ADCTRL

ADC Control Register default (0)

Bit StateDescription
7-5 0 RSV
4-2 0 Select converting ADC channel (ADC5~0)

NOTE: ONLY Channel 3~0 is valid in A0 and A1 version. All these three bit need to set ZERO if channel 4 or 5 selected using ADDAEN.

1 0 ADC test mode
0 0 Start (write 1 action ) ADC converter and Enable ADC converted interrupt

ADCDAT

ADC Data output port After ADC converted, the value is held here. default (0)

ECIF

EC Interrupt Pending Flag default (0)

Bit StateDescription
7-3 0 RSV
2 0 EC firmware mode in processing flag

Exit EC firmware mode and re-enable hardware mode by writing 1

1 0 IBF interrupt pending flag, as ECSTS IBF is set by host write
0 0 OBF interrupt pending flag, as ECSTS OBF is clear by host read ECDAT

0

ECDAT

EC Data Port Window between host and EC default (0)

ECCMD

EC Command Port Stores the latest EC command from host. default (0)

ECSTS

EC Status port default (0)

Bit StateDescription
7 0 Free r/w bit for host interface
6 0 Free r/w bit for host interface
5 0 SCI pending flag
4 0 Burst Enable Status
3 0

A2 (Command or Data Flag)

  • =0, previous host write is Data
  • =1, previous host write is Command
2 0 RSV
1 0 IBF, write IBF = 1 to clear IBF
0 0 OBF, write port ECDAT will set OBF to 1. Write OBF = 1 to clear OBF

PLLVAL

Chip Part No. / PLL lock value (works if bit 3 of PLLFRL is enabled)

GPWU (hardware EC Space)

General Purpose Wake Up 

GPWUEN ff30:   10  0  0  0
GPWUPF ff40:   89  8 16  c
GPWUPS ff50:    0  8  0  0
GPWUEL ff60:    0  8  0  0
GPWU 0001020304050607 0809101112131415 1617181920212223 2425262728293031
Event Enable 00010000 00000000 00000000 00000000
Event Pending Flag 10001001 00001000 00010110 00001100
Polarity Selection 00001000 00000000 00000000 00000000
Edge/Level Trigger Selection 00001000 00000000 00000000 00000000
Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=EC_Register_Settings&oldid=275178"