Difference between revisions of "84PCE:Ports:A000"

From WikiTI
Jump to: navigation, search
(Added documentation about OS behavior, fixed some CE-specific things)
Line 22: Line 22:
 
! Bit 6
 
! Bit 6
 
! Bit 7
 
! Bit 7
! Bit 8
 
! Bit 9
 
! Bit 10
 
 
|-
 
|-
 
| F50010
 
| F50010
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
Line 48: Line 42:
 
| mode
 
| mode
 
| del
 
| del
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
|-
 
|-
 
| F50014
 
| F50014
Line 61: Line 52:
 
| math
 
| math
 
| alpha
 
| alpha
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
|-
 
|-
 
| F50016
 
| F50016
Line 74: Line 62:
 
| apps
 
| apps
 
| X
 
| X
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
|-
 
|-
 
| F50018
 
| F50018
Line 87: Line 72:
 
| prgm
 
| prgm
 
| stat
 
| stat
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
|-
 
|-
 
| F5001A
 
| F5001A
Line 99: Line 81:
 
| tan
 
| tan
 
| vars
 
| vars
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
|-
 
|-
Line 112: Line 91:
 
| ^
 
| ^
 
| clear
 
| clear
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
|-
 
|-
Line 122: Line 98:
 
| right
 
| right
 
| up
 
| up
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
 
| bgcolor=lightgray |
Line 131: Line 104:
 
|}
 
|}
  
The controller works by scanning lines; not by selecting a row and column like previous versions.
+
The controller works by scanning multiple rows into data registers; rather than manually selecting rows like previous versions.
 
+
For example, if you set the controller to scan 3 lines, it will affect only the data in F00010h, F00012h, F00014h, and leave the others alone.
+
  
You will want to disable interrupts when reading, as OS interrupts can cause garbage to be read.
+
For example, if you set the controller to scan 3 rows, it will affect only the data in F00010h, F00012h, F00014h, and leave the others alone. There's not really a reason to set anything other than 8 rows, though.
  
Before you exit your program, if you have modified the keypad controller in any way, it is '''crucial''' to restore the keypad controller back to its original state.
+
You will want to disable interrupts when performing your own scans, as OS interrupts will modify the controller's state.
  
This is how TI does it (Not really; ports are used instead, but it's the same idea)
+
Alternatively, if you want to make use of the OS's scans, you will want to first check the scan mode to ensure the data registers are valid. The OS leaves the controller in mode 1 when no keys are pressed, which renders the data registers useless.
<pre>RestoreKeyboard:
+
ld bc,0F50000h
+
xor a ; Mode 0
+
ld (bc),a
+
inc c ; 0F50001h
+
ld a,15 ; Wait 15 APB cycles before scanning each row
+
ld (bc),a
+
inc c ; 0F50002h
+
xor a
+
ld (bc),a
+
inc c ; 0F50003h
+
ld a,15 ; Wait 15 APB cycles before each scan
+
ld (bc),a
+
inc c ; 0F50004h
+
ld a,8 ; Number of rows to scan
+
ld (bc),a
+
inc c ; 0F50005h
+
ld (bc),a ; Number of columns to scan
+
ret</pre>
+
  
 
----
 
----
'''Controller Address Uses:'''
+
'''Controller Registers:'''
  
 
* F50000 (R/W):
 
* F50000 (R/W):
 
** Bits 0-1: Scan mode
 
** Bits 0-1: Scan mode
 
*** Mode 0: Idle.
 
*** Mode 0: Idle.
*** Mode 1: Indiscriminate key detection. Data registers are not updated, but whenever any key is pressed, interrupt bit 2 is set (and cannot be cleared until the key is released).
+
*** Mode 1: Indiscriminate key detection. Data registers are invalid, but whenever any key is pressed, interrupt bit 2 is set (and cannot be cleared until the key is released).
 
*** Mode 2: Single scan. The keypad is scanned once, and then the mode returns to 0.
 
*** Mode 2: Single scan. The keypad is scanned once, and then the mode returns to 0.
 
*** Mode 3: Continuous scan. When scanning completes, it just starts over again after a delay.
 
*** Mode 3: Continuous scan. When scanning completes, it just starts over again after a delay.
** Bits 2-15: Number of APB cycles to wait before scanning each row
+
** Bits 2-15: Number of APB cycles to wait before scanning each row (default value is 960; bits 2-7 are 0 so the mode can be written directly to F50000)
** Bits 16-31: Number of APB cycles to wait between scans
+
** Bits 16-31: Number of APB cycles to wait between scans (default value is 3840)
  
 
* F50004 (R/W):
 
* F50004 (R/W):
 
** Bits 0-7: Number of rows to read (later rows are not updated in F50010-F5002F, and just read as whatever they were before being disabled)
 
** Bits 0-7: Number of rows to read (later rows are not updated in F50010-F5002F, and just read as whatever they were before being disabled)
** Bits 8-15: Number of columns to read (later column bits in a row are set to 1 when it is updated)
+
** Bits 8-15: Number of columns to read (later column bits in a row are set to 0 when it is updated)
 
* F50008 (R/W): Keypad interrupt status/acknowledge (3-bit). Write "1" bits to acknowledge.
 
* F50008 (R/W): Keypad interrupt status/acknowledge (3-bit). Write "1" bits to acknowledge.
 
** Bit 0: Keypad scan complete
 
** Bit 0: Keypad scan complete

Revision as of 22:38, 1 April 2015

Synopsis

Port Number: A000-?

Memory-mapped address: F50000-?

Function: Keypad Controller options

Using the keypad

  • This is the layout of what the keypad looks like according to the controller:
Address Bit 0 Bit 1 Bit 2 Bit 3 Bit 4 Bit 5 Bit 6 Bit 7
F50010
F50012 graph trace zoom wind y= 2nd mode del
F50014 on sto ln log x^2 x^-1 math alpha
F50016 0 1 4 7 , sin apps X
F50018 . 2 5 8 ( cos prgm stat
F5001A (-) 3 6 9 ) tan vars
F5001C enter + - * / ^ clear
F5001E down left right up

The controller works by scanning multiple rows into data registers; rather than manually selecting rows like previous versions.

For example, if you set the controller to scan 3 rows, it will affect only the data in F00010h, F00012h, F00014h, and leave the others alone. There's not really a reason to set anything other than 8 rows, though.

You will want to disable interrupts when performing your own scans, as OS interrupts will modify the controller's state.

Alternatively, if you want to make use of the OS's scans, you will want to first check the scan mode to ensure the data registers are valid. The OS leaves the controller in mode 1 when no keys are pressed, which renders the data registers useless.


Controller Registers:

  • F50000 (R/W):
    • Bits 0-1: Scan mode
      • Mode 0: Idle.
      • Mode 1: Indiscriminate key detection. Data registers are invalid, but whenever any key is pressed, interrupt bit 2 is set (and cannot be cleared until the key is released).
      • Mode 2: Single scan. The keypad is scanned once, and then the mode returns to 0.
      • Mode 3: Continuous scan. When scanning completes, it just starts over again after a delay.
    • Bits 2-15: Number of APB cycles to wait before scanning each row (default value is 960; bits 2-7 are 0 so the mode can be written directly to F50000)
    • Bits 16-31: Number of APB cycles to wait between scans (default value is 3840)
  • F50004 (R/W):
    • Bits 0-7: Number of rows to read (later rows are not updated in F50010-F5002F, and just read as whatever they were before being disabled)
    • Bits 8-15: Number of columns to read (later column bits in a row are set to 0 when it is updated)
  • F50008 (R/W): Keypad interrupt status/acknowledge (3-bit). Write "1" bits to acknowledge.
    • Bit 0: Keypad scan complete
    • Bit 1: Keypad data register changed
    • Bit 2: Key pressed in mode 1
  • F5000C (R/W): Keypad interrupt mask (3-bit). Set each bit to 1 if the corresponding event in [F50008] should cause an interrupt.
  • F50010-F5002F (R): Keypad data, one halfword per row.
  • F50030-F5003F (R/W): Keypad GPIOs. Each register is 20 bits, with one bit per GPIO. The role of each register is unknown.

NOTE: The CE appears to use the same keypad controller as the nSpire CX.