Difference between revisions of "83Plus:Ports:21"

From WikiTI
Jump to: navigation, search
m
 
m (topic names)
 
(18 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''Note:''' Do not take the information on this template page as actual documentation!
+
[[Category:83Plus:Ports:By_Address:Protected|21 - Flash Size / RAM Size]] [[Category:83Plus:Ports:By_Address|21 - Flash Size/ RAM Size]] [[Category:83Plus:Ports:By_Name|Flash Size/ RAM Size]]
 +
{{SE-Only Port|01}}
 +
{{Protected Port}}
  
The Ports are named by their number, in hexadecimal. An example is [[83Plus:Ports:00]].
+
== Synopsis ==
 +
'''Port Number:''' 21h
  
You also must put a variation on the following code into your page to have it categorized:
+
'''Function:''' Flash Size / RAM Size
NaodW29-nowiki4e456ce16c2fc68b00000001
+
  
----
+
=== Read Values ===
 +
* Bits 0-1: Set flash chip size (see below)
 +
* Bits 4-5: Set RAM chip size (see below)
  
== Synopsis ==
+
=== Write Values ===
'''Port Number:''' 06h
+
* Bits 0, 1, 4, 5: set new values for these bits.
 +
* Bits 2, 3, 6, 7: ignored
  
'''Function:''' Flash Memory Paging
+
== Comments ==
 +
This port does not exist on the standard 83+.  See [[83Plus:Ports:02|port 2]].
  
This port controls what page is swapped into the 4000h to 7FFFh range. ('''DO NOT''' take this template page as real documentation on port 6!)
+
The value of this port is initialized by the boot code. On the TI-83+SE, TI-84+, and TI-84+SE, bit 0 can be used to determine the hardware type alone. On the TI-84+CSE, use bits 1 and 0. If want to run on the TI-83+SE through TI+84+CSE for some reason, check both bits. The OS likes to check both bits by doing AND 3.
  
=== Read Values ===
+
=== Flash Chip Size ===
* [00h - FFh]: The current port mapped to the memory range 4000h through 7FFFh.
+
The lower nibble controls the flash chip type. See also [[83Plus:Memory_Mapping]]. Flash pages have three different properties determined by this port: readable/censored, privileged/unprivileged, and mutable/immutable. The only censored page is the certificate page. Privileged pages can unlock flash via [[83Plus:Ports:14|port 14]]. Immutable pages cannot be written to even when flash is unlocked.
 +
{|-
 +
|<u>Value</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Chip Size</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Boot Page(s)</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Certificate</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Privileged</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Immutable</u>&nbsp;&nbsp;&nbsp;
 +
|-
 +
|0
 +
|1024 K
 +
|3F
 +
|3E
 +
|2C-2F & 3C-3F
 +
|2C-2F & 3F
 +
|-
 +
|1
 +
|2048 K
 +
|7F
 +
|7E
 +
|6C-6F & 7C-7F
 +
|6C-6F & 7F
 +
|-
 +
|2
 +
|4096 K
 +
|FF
 +
|FE
 +
|EC-EF & FC-FF
 +
|EC-EF & FF
 +
|-
 +
|3
 +
|8192 K
 +
|1FF
 +
|1FE
 +
|1EC-1EF & 1FC-1FF&nbsp;&nbsp;&nbsp;
 +
|1EC-1EF & 1FF
 +
|}
  
=== Write Values ===
 
* [00h - FFh]: The new page to swap in to the memory range 4000h through 7FFFh
 
  
''Note: if you would have bitwise flags for your port, label them "bit X".''
+
=== RAM Chip Size ===
 +
The TI-83+SE had an external RAM chip. This port therefore informs the ASIC what size RAM chip is installed.
  
== Comments ==
+
{|-
The behavior of this port changes in different memory map modes.
+
|<u>Value</u>&nbsp;&nbsp;&nbsp;
 +
|<u>Chip Size</u>&nbsp;&nbsp;&nbsp;
 +
|-
 +
|0
 +
|32K
 +
|-
 +
|1
 +
|64 K
 +
|-
 +
|2
 +
|128 K
 +
|-
 +
|3
 +
|256 K
 +
|-
 +
|}
  
== Example ==
+
The actual execution permissions of RAM pages are masked by this port. Because TI sets it 0 (instead of 2), the ASIC thinks there's 32 K of RAM, and allows execution on all odd-numbered pages, instead of just 81h like TI intended. (If you set this to 1, 2, or 3, execution is also allowed on the first 1024 bytes of each page immediately following an allowed page because TI screwed up on [[83Plus:Ports:26#Comments|port 26h]].) If you ever attempt to execute code from a non-executable page, the calculator resets.
NaodW29-nowiki4e456ce16c2fc68b00000002
+
  
== Credits and Contributions ==
+
== Example ==
* '''/dev/urandom:''' Because of your randomness, this project is possible.
+
in a,[[83Plus:Ports:02|(2)]]
 +
ld b,a
 +
and 80h
 +
jr z,TI83p_BE
 +
in a,(21h)
 +
and 3
 +
jr z,TI84p_BE
 +
bit 5,b
 +
jr z,TI83p_SE
 +
; calculator is an 84+ SE
 +
 +
TI84p_BE:
 +
; calculator is an 84+ BE
 +
 +
TI83p_SE:
 +
; calculator is an 83+ SE
 +
 +
TI83p_BE:
 +
; calculator is an 83+ BE

Latest revision as of 17:32, 20 February 2013

This port only exists as a distinct port on the TI-83 Plus Silver Edition, the TI-84 Plus, and the TI-84 Plus Silver Edition. On the standard TI-83 Plus, it acts as a shadow of port 01.
This port is protected, which means user programs cannot ordinarily write to it directly.

Synopsis

Port Number: 21h

Function: Flash Size / RAM Size

Read Values

  • Bits 0-1: Set flash chip size (see below)
  • Bits 4-5: Set RAM chip size (see below)

Write Values

  • Bits 0, 1, 4, 5: set new values for these bits.
  • Bits 2, 3, 6, 7: ignored

Comments

This port does not exist on the standard 83+. See port 2.

The value of this port is initialized by the boot code. On the TI-83+SE, TI-84+, and TI-84+SE, bit 0 can be used to determine the hardware type alone. On the TI-84+CSE, use bits 1 and 0. If want to run on the TI-83+SE through TI+84+CSE for some reason, check both bits. The OS likes to check both bits by doing AND 3.

Flash Chip Size

The lower nibble controls the flash chip type. See also 83Plus:Memory_Mapping. Flash pages have three different properties determined by this port: readable/censored, privileged/unprivileged, and mutable/immutable. The only censored page is the certificate page. Privileged pages can unlock flash via port 14. Immutable pages cannot be written to even when flash is unlocked.

Value    Chip Size    Boot Page(s)    Certificate    Privileged    Immutable   
0 1024 K 3F 3E 2C-2F & 3C-3F 2C-2F & 3F
1 2048 K 7F 7E 6C-6F & 7C-7F 6C-6F & 7F
2 4096 K FF FE EC-EF & FC-FF EC-EF & FF
3 8192 K 1FF 1FE 1EC-1EF & 1FC-1FF    1EC-1EF & 1FF


RAM Chip Size

The TI-83+SE had an external RAM chip. This port therefore informs the ASIC what size RAM chip is installed.

Value    Chip Size   
0 32K
1 64 K
2 128 K
3 256 K

The actual execution permissions of RAM pages are masked by this port. Because TI sets it 0 (instead of 2), the ASIC thinks there's 32 K of RAM, and allows execution on all odd-numbered pages, instead of just 81h like TI intended. (If you set this to 1, 2, or 3, execution is also allowed on the first 1024 bytes of each page immediately following an allowed page because TI screwed up on port 26h.) If you ever attempt to execute code from a non-executable page, the calculator resets.

Example

	in a,(2)
	ld b,a
	and 80h
	jr z,TI83p_BE
	in a,(21h)
	and 3
	jr z,TI84p_BE
	bit 5,b
	jr z,TI83p_SE
	; calculator is an 84+ SE

TI84p_BE:
	; calculator is an 84+ BE

TI83p_SE:
	; calculator is an 83+ SE

TI83p_BE:
	; calculator is an 83+ BE