WikiTI - User contributions [en]

83Plus:BCALLs:42B5

2014-04-05T13:42:45Z

Buckeye Dude: Created page with 'LCDSetXAutoInc LCDSetXAutoInc 42B5 - LCDSetXAutoInc == Synopsi…'

[[Category:83Plus:BCALLs:By Name|LCDSetXAutoInc]]
[[Category:83Plus:BCALLs:By Name:Display|LCDSetXAutoInc]]
[[Category:83Plus:BCALLs:By Address|42B5 - LCDSetXAutoInc]]
== Synopsis ==
'''Unofficial Name:''' LCDSetXAutoInc

'''BCALL Address:''' 42B5

LCD cursor is set to auto increment along the X axis.

=== Inputs ===
* None

=== Outputs ===
* LCD cursor mode is changed.

=== Registers Destroyed ===
* None

== Comments ==
This checks and makes sure its safe to write to the LCD.

83Plus:BCALLs:42B2

2014-04-05T13:41:51Z

Buckeye Dude: Created page with 'LCDSetYAutoInc LCDSetYAutoInc 42B2 - LCDSetYAutoInc == Synopsi…'

[[Category:83Plus:BCALLs:By Name|LCDSetYAutoInc]]
[[Category:83Plus:BCALLs:By Name:Display|LCDSetYAutoInc]]
[[Category:83Plus:BCALLs:By Address|42B2 - LCDSetYAutoInc]]
== Synopsis ==
'''Unofficial Name:''' LCDSetYAutoInc

'''BCALL Address:''' 42B2

LCD cursor is set to auto increment along the Y axis.

=== Inputs ===
* None

=== Outputs ===
* LCD cursor mode is changed.

=== Registers Destroyed ===
* None

== Comments ==
This checks and makes sure its safe to write to the LCD.

83Plus:Ports:28

2011-06-29T06:34:14Z

Buckeye Dude:

[[Category:83Plus:Ports:By Address|28 - Block Memory Mapping 8000h]]
[[Category:83Plus:Ports:By Name|Block Memory Mapping 8000h]]
{{SE-Only Port|00}}

== Synopsis ==
'''Port Number:''' 28h

'''Function:''' Block Memory Mapping 8000h

By an order of 64 bytes per block, this port can re-map data from RAM page 1 to the memory addresses 8000h - BFFFh without regard to the contents of port 7. This port does not map the entire page but only 64 bytes times the value in this port. It maps it starting from low memory (8000h) to high (BFFFh).

=== Read Values ===
* This port reads the last value written to it.

=== Write Values ===
* [00h - FFh]: The value times 64 equals the number of bytes that get re-mapped starting from 8000h. So a vaule of 18h would re-map data in 8000h - 85FFh.

== Comments ==
I can image this port having slightly more purpose than port 27, however it is still unusual.

calc84maniac says: This port seems to have no effect whatsoever during memory map mode 1, but I may be wrong about that.

== Credits and Contributions ==
* '''James Montelongo'''

== See Also ==
* [[83Plus:Ports:27|Port 27]]

83Plus:Ports:27

2011-06-29T06:33:58Z

Buckeye Dude:

[[Category:83Plus:Ports:By Address|27 - Block Memory Mapping C000h]][[Category:83Plus:Ports:By Name|Block Memory Mapping C000h]]
{{SE-Only Port|07}}

== Synopsis ==
'''Port Number:''' 27h

'''Function:''' Block Memory Mapping C000h

By an order of 64 bytes per block, this port can re-map data from ram page 0 to reflect the memory C000h - FFFFh addresses without regard to the contents of port 5. This port does not map the entire page, but only 64 bytes times the value in this port. It maps it starting from high memory (FFFFh) to low.

=== Read Values ===
* This port reads the last value written to it.

=== Write Values ===
* [00h - 12h]: The value times 64 equals the number of bytes that get re-mapped starting from FFFFh. So a value of 12h would re-map data in FB80h - FFFFh.

* [13h - FFh]: Any value 13h or greater will only re-map data in FB64h - FFFFh

== Comments ==
I have no clue why TI thinks it may be necessary to make 1180 bytes from ram page 0 at FB64h, but who knows it could be useful. This also bares more than resemblance to port 28h so I guess they were meant to be used together.

== Credits and Contributions ==
* '''James Montelongo'''

== See Also ==
* [[83Plus:Ports:28|Port 28]]

Z80 Routines:Optimized:reverseA

2011-05-22T05:11:07Z

Buckeye Dude: Commented the black magiks

[[Category:Z80 Routines:Optimized|ReverseA]]
[[Category:Z80 Routines:Graphic|ReverseA]]
[[Category:Z80 Routines|ReverseA]]
This is a faster/smaller (and also obfuscated) replacement for the normal reverse a.

Typical routine:
<nowiki>;input: b
;output: a
;25 bytes, 96 clock cycles
typicalreversea:
rr b
rla
rr b
rla
rr b
rla
rr b
rla
rr b
rla
rr b
rla
rr b
rla
rr b
rla
ret</nowiki>

Better routine:
<nowiki>;- Reverse a
;input: byte in A
;output: Reversed byte in A
;destroys B
;18 bytes and 66 clock cycles
;author: calcmaniac84
ReverseA:
ld b,a ;b=ABCDEFGH
rrca ;a=HABCDEFG
rrca ;a=GHABCDEF
xor b \ and %10101010 \ xor b ;a=GBADCFEH
ld b,a ;b=GBADCFEH
rrca ;a=HGBADCFE
rrca ;a=EHGBADCF
rrca ;a=FEHGBADC
rrca ;a=CFEHGBAD
xor b \ and %01100110 \ xor b ;a=GFEDCBAH
rrca ;a=HGFEDCBA</nowiki>

Category:Emulators

2010-12-30T01:07:53Z

Buckeye Dude:

[[Category:PC Software|Emulators]]

A software emulator allows computer programs to run on a platform (computer architecture and/or operating system) other than the one for which they were originally written. Unlike a simulation, which only attempts to reproduce a program's behaviour, an emulation attempts to precisely model the state of the device being emulated.

[http://www.wikipedia.org Source: wikipedia]

==Advantages==
Why using an emulator instead of the ''real'' calculator? There are several reasons for this:
* When crashing, you can recover the emulator with the ease of one/two-clicks.
* Sending files is a matter of drag 'n' dropping the file.
* Test on different calcs.
* Access to powerful debugging tools.
* Ability to take screen-shots.

==TI Emulators==
There are four major emulators available for the z80 series of calcs.
* [[Emulators:PindurTI|PindurTI]] (also known as PTI)
* [[Emulators:Virtual TI|Virtual TI]] (also known as VTI)
* [[Emulators:TilEm|TilEm]]
* [[Emulators:TI Flash Debugger|TI Flash Debugger]]
* [[Emulators:Wabbitemu|Wabbitemu]]

[[Emulators:PindurTI|PindurTI]] is one of the latest additions to emulators and has the most accurate emulation of all emulators available. However, its author, Patai Gergley has discontinued it due to lack of time, and the emergence of [[Emulators:Wabbitemu|Wabbitemu]]. Wabbitemu is the latest upcoming z80 emulator, emulating almost all z80 calcs. It is available for Windows and Mac, with a Linux version in progress. Linux users can use [[Emulators:TilEm|TilEm]]. [[Emulators:Virtual TI|Virtual TI]] is the oldest and most used emulator at the moment. It has however a lot problems because of incorrect emulation.

The major emulator for the m68k series is [[Emulators:TiEmu|TiEmu]], which supports all the 68k calcs.

==External info==
[http://www.ticalc.org/programming/emulators/software.html ticalc.org Emulators list]

Emulators:Wabbitemu

2010-12-30T01:05:44Z

Buckeye Dude: Updated links

[[Category:Emulators]]
'''Wabbitemu'''

Wabbitemu is the most complete Z80 TI emulator to date, although it is the most recent of the TI Z80 emulators. It emulates the TI-73, TI-82, TI-83, TI-83 Plus, TI-83 Plus Silver Edition, TI-84 Plus, TI-84 Plus Silver Edition, TI-85, and TI-86. It was initially developed by Spencer Putt and James Montelongo and development by Chris Shappell and Spencer is currently active. More documentation can be found on the official website, http://wabbit.codeplex.com

Forum : http://www.revsoft.org/phpBB3/viewforum.php?f=32

Source Code : http://wabbit.svn.codeplex.com/Wabbitstudio/Source/Wabbitemu

Current stable version (December 2010) : http://www.wabbit.codeplex.com (Windows and Mac)

Linux Test Version: http://code.google.com/p/wxwabbitemu/

== Features ==
* Send and receive files to and from the emulated calculator via drag and drop
* Run up to 8 running calculators at once
* Connect virtual calculators to each other
* Click buttons on beautifully rendered skins for each calculator model
* Use built-in screenshot recording to capture the display
* Grayscale support for 2-12 levels of gray
* Configurable options for all aspects of the emulator
* Copy output from TIOS
* Instantly save and restore compressed states of the calculator
* View the variables currently on each calculator
* Adjust the speed of the calculator from 1%-1600%
* Listen to sound output from the linkport
* A Graphical Debugger specifically for assembly programmers
** Place execution and data breakpoints
** View and change any part of the core cpu (registers,
** View up to five points in memory simultaneously
** Stack viewer for easy monitoring of the hardware stack
** Load label files from SPASM for easy debugging
** Rewinding up to 5 seconds of instructions

== Keys ==
Left Shift = 2nd

Right Shift = Clear

Ctrl = Alpha

Esc = Mode

F1 = Y=

F2 = Window

F3 = Zoom

F4 = Trace

F5 = Graph

F7 = Variable Tree

F8 = Toggle 400% speed

F10 = Load File

F11 = Debugger

F12 = On

Space = 0

Insert = VARS

Home = Math

Page Up = Apps

Page Down = Programs

End = Stats

Backspace = Save screenshot

+/= = X,T,theta,n

-/_ = negative

//? = negative

Numpad 1 = Stats

Numpad 2 = Down

Numpad 3 = Programs

Numpad 4 = Right

Numpad 6 = Left

Numpad 7 = Math

Numpad 8 = Up

Numpad 9 = Apps

Numpad 0 = Vars

Numpad + = +

Numpad – = –

Numpad * = *

Numpad / = /

A = Math

B = Apps

C = Programs

D = x^-1

E = sin(

F = cos(

G = tan(

H = ^

I = x^2

J = ,

K = (

L = )

M = /

N = log(

O = 7

P = 8

Q = 9

R = *

S = ln(

T = 4

U = 5

V = 6

W = –

X = sto>

Y = 1

Z = 2

0 = 0

1 = 1

2 = 2

3 = 3

4 = 4

5 = 5

6 = 6

7 = 7

8 = 8

9 = 9

IDEs

2010-10-21T16:50:53Z

Buckeye Dude: Added links

{{Stub}}

== Z80 ==
* [http://www.ticalc.org/archives/files/fileinfo/158/15892.html Assembly Studio 8x]
* [http://www.benryves.com/products/latenite Latenite]
* z80 ASM IDE
* [http://wabbit.codeplex.com/releases/view/45275 WabbitCode]
== M68K ==
* none

Emulators:Wabbitemu

2010-09-19T08:28:34Z

Buckeye Dude:

[[Category:Emulators]]
'''Wabbitemu'''

Wabbitemu is the most complete Z80 TI emulator to date, although it is the most recent of the TI Z80 emulators. It emulates the TI-73, TI-82, TI-83, TI-83 Plus, TI-83 Plus Silver Edition, TI-84 Plus, TI-84 Plus Silver Edition, TI-85, and TI-86. It was initially developed by Spencer Putt and James Montelongo and development by Chris Shappell and Spencer is currently active. More documentation can be found on the official website, http://wabbit.codeplex.com

Forum : http://www.revsoft.org/phpBB2/viewforum.php?f=32

Development version : http://wabbit.svn.codeplex.com/Wabbitstudio/Source/Wabbitemu

Current stable version (September 2010) : http://www.wabbit.codeplex.com (Windows)

Latest version: http://group.revsoft.org/wabbitemu.exe (Windows)

== Features ==
* Send and receive files to and from the emulated calculator via drag and drop
* Run up to 8 running calculators at once
* Connect virtual calculators to each other
* Click buttons on beautifully rendered skins for each calculator model
* Use built-in screenshot recording to capture the display
* Grayscale support for 2-12 levels of gray
* Configurable options for all aspects of the emulator
* Copy output from TIOS
* Instantly save and restore compressed states of the calculator
* View the variables currently on each calculator
* Adjust the speed of the calculator from 1%-1600%
* Listen to sound output from the linkport
* A Graphical Debugger specifically for assembly programmers
** Place execution and data breakpoints
** View and change any part of the core cpu (registers,
** View up to five points in memory simultaneously
** Stack viewer for easy monitoring of the hardware stack
** Load label files from SPASM for easy debugging
** Rewinding up to 5 seconds of instructions

== Keys ==
Left Shift = 2nd

Right Shift = Clear

Ctrl = Alpha

Esc = Mode

F1 = Y=

F2 = Window

F3 = Zoom

F4 = Trace

F5 = Graph

F7 = Variable Tree

F8 = Toggle 400% speed

F10 = Load File

F11 = Debugger

F12 = On

Space = 0

Insert = VARS

Home = Math

Page Up = Apps

Page Down = Programs

End = Stats

Backspace = Save screenshot

+/= = X,T,theta,n

-/_ = negative

//? = negative

Numpad 1 = Stats

Numpad 2 = Down

Numpad 3 = Programs

Numpad 4 = Right

Numpad 6 = Left

Numpad 7 = Math

Numpad 8 = Up

Numpad 9 = Apps

Numpad 0 = Vars

Numpad + = +

Numpad – = –

Numpad * = *

Numpad / = /

A = Math

B = Apps

C = Programs

D = x^-1

E = sin(

F = cos(

G = tan(

H = ^

I = x^2

J = ,

K = (

L = )

M = /

N = log(

O = 7

P = 8

Q = 9

R = *

S = ln(

T = 4

U = 5

V = 6

W = –

X = sto>

Y = 1

Z = 2

0 = 0

1 = 1

2 = 2

3 = 3

4 = 4

5 = 5

6 = 6

7 = 7

8 = 8

9 = 9

Emulators:Wabbitemu

2010-09-19T08:19:43Z

Buckeye Dude:

[[Category:Emulators]]
{{stub}}
'''Wabbitemu'''

Forum : http://www.revsoft.org/phpBB2/viewforum.php?f=32

Development version : http://wabbit.svn.codeplex.com/Wabbitstudio/Source/Wabbitemu

Current stable version (September 2010) : http://www.wabbit.codeplex.com (Windows)

Latest version: http://group.revsoft.org/wabbitemu.exe (Windows)

== Features ==
* Send and receive files to and from the emulated calculator via drag and drop
* Run up to 8 running calculators at once
* Connect virtual calculators to each other
* Click buttons on beautifully rendered skins for each calculator model
* Use built-in screenshot recording to capture the display
* Grayscale support for 2-12 levels of gray
* Configurable options for all aspects of the emulator
* Copy output from TIOS
* Instantly save and restore compressed states of the calculator
* View the variables currently on each calculator
* Adjust the speed of the calculator from 1%-1600%
* Listen to sound output from the linkport
* A Graphical Debugger specifically for assembly programmers
** Place execution and data breakpoints
** View and change any part of the core cpu (registers,
** View up to five points in memory simultaneously
** Stack viewer for easy monitoring of the hardware stack
** Load label files from SPASM for easy debugging
** Rewinding up to 5 seconds of instructions

== Description ==

== Keys ==
Left Shift = 2nd

Right Shift = Clear

Ctrl = Alpha

Esc = Mode

F1 = Y=

F2 = Window

F3 = Zoom

F4 = Trace

F5 = Graph

F7 = Variable Tree

F8 = Toggle 400% speed

F10 = Load File

F11 = Debugger

F12 = On

Space = 0

Insert = VARS

Home = Math

Page Up = Apps

Page Down = Programs

End = Stats

Backspace = Save screenshot

+/= = X,T,theta,n

-/_ = negative

//? = negative

Numpad 1 = Stats

Numpad 2 = Down

Numpad 3 = Programs

Numpad 4 = Right

Numpad 6 = Left

Numpad 7 = Math

Numpad 8 = Up

Numpad 9 = Apps

Numpad 0 = Vars

Numpad + = +

Numpad – = –

Numpad * = *

Numpad / = /

A = Math

B = Apps

C = Programs

D = x^-1

E = sin(

F = cos(

G = tan(

H = ^

I = x^2

J = ,

K = (

L = )

M = /

N = log(

O = 7

P = 8

Q = 9

R = *

S = ln(

T = 4

U = 5

V = 6

W = –

X = sto>

Y = 1

Z = 2

0 = 0

1 = 1

2 = 2

3 = 3

4 = 4

5 = 5

6 = 6

7 = 7

8 = 8

9 = 9

Beginners

2009-01-03T01:32:38Z

Buckeye Dude:

Starting with assembly programming can be quite a pain. You need to find yourself an assembler, preferably a nice emulator, and lots of documentation. While this wiki provides you with a lot of documentation, and many [[TI websites|websites]] and [[:Category:Teams|teams]] can provide you with links to good tutorials, people keep asking the community how to get started. I hope this will answer their questions once and for all :)

== Emulating ==

=== Getting a ROM dump ===

Getting a ROM dump is the essential first step of running a calculator emulator. Because the calculator operating system is intellectual property of Texas Instruments, it is illegal to distribute ROM images, but you can extract your own ROM image from your own calculator under "Fair use" regulations.

To download your own ROM image from your calculator to your PC you need some software. Your options are:
* [http://www.ticalc.org/archives/files/fileinfo/373/37341.html Rom8x]
* Uhm... need to find some more ;)

Ticalc.org has an excellent howto page on getting a ROM image [http://www.ticalc.org/programming/emulators/romdump.html here]. Or, you could do a Google search on something like TI83.rom, and see what comes up.

Of course, if you want to develop an operating system yourself (if you're working on [[Vera]] for example) you don't need a ROM image.

=== Choice of Emulator ===

The second step is selecting an [[:Category:Emulators|emulator]] that suits you:

* [[:Emulators:Virtual TI|Virtual TI]] - Long time favourite, but mostly because it was the only one
* [[:Emulators:PindurTI|PindurTI]] - Very basic emulator with very good hardware emulation and animated screenshotting
* [[:Emulators:Wabbitemu|WabbitEmu]] - The newest breed, with a very nice GUI and a port to MAC, Linux is on the way

There are a few more, but these are the most popular. Virtual TI's emulation is quite poor compared to the others, but the others are still under development. It's usually best to have a few around so that in case you run into something unexpected you can get a second opinion from another emulator.

Please read the respective README's on how to get your ROM image running in these emulators.

== Assembler ==

An assembler -- sometimes referred to as "compiler", though formally it is no such thing -- can assemble your source code into binaries for the Z80 processor that runs our calculators.

=== Choice of assembler ===

Once again, you'll have to make a choice. A few years ago, things were simple; there was TASM and nothing else, so you'd use TASM. These days we have TASM, Brass and Spasm (and probably a few others), all with subtle little differences and improvements, but the latter two are clearly superior to the old TASM. Brass is written in C# for .NET, and can run under Linux using Mono. Spasm was written in C, and will compile on most systems with the GNU toolchain.

* Brass [http://kvince83.tengun.net/maxboard/viewforum.php?f=25 subforum], [http://benryves.com/bin/brass/ website] and [http://benryves.com/bin/brass/Brass.exe latest download]
* Spasm [http://www.revsoft.org/phpBB2/viewforum.php?f=21 subforum] and [http://www.group.revsoft.org/spasm.exe latest download]

=== Assembling source to binaries ===

The syntax for assembling input.asm to either output.8xp or output.83p is:

Brass.exe input.asm output.8?p

or

spasm input.asm output.8?p

Both modern assemblers can output files in TI calculator specific formats, which TASM can not. Some versions of Spasm will do this automatically based on the output file extension, and in the case of Brass you can [http://benryves.com/bin/brass/directives/binarymode.htm specify] your output format in your source code:

.binarymode TI8X

=== Include files ===

Include files contain predefined memory locations, locations of TI-OS calls and macros to make your life easier. Strictly speaking you don't need any, but without them you'll have to type in every address by hand (and either memorize them or look them up each time).

Depending on which calculator model and which shell you want to develop for (Ion, MirageOS, Venus, etc.), you'll need to get some include files. For the sake of demonstration (and because most other shells can run them) we'll be choosing Ion for now. Developing for Ion also has the advantage that your applications can be compiled for Ti-83 and Ti-83+ (and relatives) without changing the source. Go [http://www.ticalc.org/archives/files/fileinfo/130/13058.html here] and download the zip file, which contains ion.inc. You'll also need the shell itself for testing.

=== Hello World ===

Save this file as hello.asm in the same directory as your assembler, for ease of testing:

<pre>#define TI83P ; If you want to compile for Ti-83+ family calcs
;#define TI83 ; If you want to compile for Ti-83, don't uncomment both!

#include "ion.inc"

; ====
; Start of Ion header

#ifdef TI83P
.binarymode TI8X ; only required if you use Brass
.org progstart-2
.db $BB,$6D
#else
.binarymode TI83 ; only required if you use Brass
.org progstart
#endif
ret
jr nc,main
title:
.db "Hello World Test",0

; End of Ion header
; ====

main:
; Program execution starts here:
bcall(_homeup)
ld hl,string
bcall(_puts)
bcall(_getkey)
ret

string:
.db "Hello world!",0
</pre>

Open a console, cd to your directory and issue:

<your assembler> hello.asm hello.8xp

Now load hello.8xp into your emulator and try to run it with Ion.

Beginners

2009-01-03T01:32:02Z

Buckeye Dude: Updated link to spasm

Starting with assembly programming can be quite a pain. You need to find yourself an assembler, preferably a nice emulator, and lots of documentation. While this wiki provides you with a lot of documentation, and many [[TI websites|websites]] and [[:Category:Teams|teams]] can provide you with links to good tutorials, people keep asking the community how to get started. I hope this will answer their questions once and for all :)

== Emulating ==

=== Getting a ROM dump ===

Getting a ROM dump is the essential first step of running a calculator emulator. Because the calculator operating system is intellectual property of Texas Instruments, it is illegal to distribute ROM images, but you can extract your own ROM image from your own calculator under "Fair use" regulations.

To download your own ROM image from your calculator to your PC you need some software. Your options are:
* [http://www.ticalc.org/archives/files/fileinfo/373/37341.html Rom8x]
* Uhm... need to find some more ;)

Ticalc.org has an excellent howto page on getting a ROM image [http://www.ticalc.org/programming/emulators/romdump.html here]. Or, you could do a Google search on something like TI83.rom, and see what comes up.

Of course, if you want to develop an operating system yourself (if you're working on [[Vera]] for example) you don't need a ROM image.

=== Choice of Emulator ===

The second step is selecting an [[:Category:Emulators|emulator]] that suits you:

* [[:Emulators:Virtual TI|Virtual TI]] - Long time favourite, but mostly because it was the only one
* [[:Emulators:PindurTI|PindurTI]] - Very basic emulator with very good hardware emulation and animated screenshotting
* [[:Emulators:Wabbitemu|WabbitEmu]] - The newest breed, with a very nice GUI and a port to MAC, Linux is on the way

There are a few more, but these are the most popular. Virtual TI's emulation is quite poor compared to the others, but the others are still under development. It's usually best to have a few around so that in case you run into something unexpected you can get a second opinion from another emulator.

Please read the respective README's on how to get your ROM image running in these emulators.

== Assembler ==

An assembler -- sometimes referred to as "compiler", though formally it is no such thing -- can assemble your source code into binaries for the Z80 processor that runs our calculators.

=== Choice of assembler ===

Once again, you'll have to make a choice. A few years ago, things were simple; there was TASM and nothing else, so you'd use TASM. These days we have TASM, Brass and Spasm (and probably a few others), all with subtle little differences and improvements, but the latter two are clearly superior to the old TASM. Brass is written in C# for .NET, and can run under Linux using Mono. Spasm was written in C, and will compile on most systems with the GNU toolchain.

* Brass [http://kvince83.tengun.net/maxboard/viewforum.php?f=25 subforum], [http://benryves.com/bin/brass/ website] and [http://benryves.com/bin/brass/Brass.exe latest download]
* Spasm [http://www.revsoft.org/phpBB2/viewforum.php?f=21 subforum] and [http://www.revsoft.org/spasm.exe latest download]

=== Assembling source to binaries ===

The syntax for assembling input.asm to either output.8xp or output.83p is:

Brass.exe input.asm output.8?p

or

spasm input.asm output.8?p

Both modern assemblers can output files in TI calculator specific formats, which TASM can not. Some versions of Spasm will do this automatically based on the output file extension, and in the case of Brass you can [http://benryves.com/bin/brass/directives/binarymode.htm specify] your output format in your source code:

.binarymode TI8X

=== Include files ===

Include files contain predefined memory locations, locations of TI-OS calls and macros to make your life easier. Strictly speaking you don't need any, but without them you'll have to type in every address by hand (and either memorize them or look them up each time).

Depending on which calculator model and which shell you want to develop for (Ion, MirageOS, Venus, etc.), you'll need to get some include files. For the sake of demonstration (and because most other shells can run them) we'll be choosing Ion for now. Developing for Ion also has the advantage that your applications can be compiled for Ti-83 and Ti-83+ (and relatives) without changing the source. Go [http://www.ticalc.org/archives/files/fileinfo/130/13058.html here] and download the zip file, which contains ion.inc. You'll also need the shell itself for testing.

=== Hello World ===

Save this file as hello.asm in the same directory as your assembler, for ease of testing:

<pre>#define TI83P ; If you want to compile for Ti-83+ family calcs
;#define TI83 ; If you want to compile for Ti-83, don't uncomment both!

#include "ion.inc"

; ====
; Start of Ion header

#ifdef TI83P
.binarymode TI8X ; only required if you use Brass
.org progstart-2
.db $BB,$6D
#else
.binarymode TI83 ; only required if you use Brass
.org progstart
#endif
ret
jr nc,main
title:
.db "Hello World Test",0

; End of Ion header
; ====

main:
; Program execution starts here:
bcall(_homeup)
ld hl,string
bcall(_puts)
bcall(_getkey)
ret

string:
.db "Hello world!",0
</pre>

Open a console, cd to your directory and issue:

<your assembler> hello.asm hello.8xp

Now load hello.8xp into your emulator and try to run it with Ion.

Category:Emulators

2008-10-06T08:06:56Z

Buckeye Dude: Added more general info about emulators

A software emulator allows computer programs to run on a platform (computer architecture and/or operating system) other than the one for which they were originally written. Unlike a simulation, which only attempts to reproduce a program's behavior, an emulation attempts to precisely model the state of the device being emulated.

[http://www.wikipedia.org Source: wikipedia]

==Advantages==
Why using an emulator instead of the ''real'' calculator? There are several reasons for this:
* When crashing, you can recover the emulator with the ease of one/two-clicks.
* Sending files is a matter of drag'n'droping the file.
* Test on different calcs.
* Access to powerfull debuging tools.
* Ability to take screenshots.

==TI Emulators==
There are four major emulators available for the z80 series of calcs.
* [[Emulators:PindurTI|PindurTI]] (also known as PTI)
* [[Emulators:Virtual TI|Virtual TI]] (also known as VTI)
* [[Emulators:TilEm|TilEm]]
* [[Emulators:TI Flash Debugger|TI Flash Debugger]]
* [[Emulators:Wabbitemu|Wabbitemu]]

[[Emulators:PindurTI|PindurTI]] is one of the latest additions to emulators and has the most accurate emulation of all emulators available. However, its author, Patai Gergley has discontinued it due to lack of time, and the emergence of [[Emulators:Wabbitemu|Wabbitemu]]. Wabbitemu is the lastest upcoming z80 emulator, emulating almost all z80 calcs. It is however only for Windows at the moment. Linux users can use [[Emulators:TilEm|TilEm]]. [[Emulators:Virtual TI|Virtual TI]] is the oldest and most used emulator at the moment. It has however a lot problems because of incorrect emulation.

The major emulator for the m68k series is [[Emulators:TiEmu|TiEmu]], which supports all the 68k calcs.