WikiTI - User contributions [en]

Category:84PCE:General Hardware Information

2015-04-02T17:24:29Z

Ahelper: Adding PL111 doc links

The TI-84 Plus CE and TI-83 Premium are two models new in 2015. The former is for the USA region (maybe all of North American?) and the latter is for France. The hardware is virtually identical between the two models.

Known hardware facts:
* eZ80 CPU
** Physical clock speed believed to be 48 MHz
** Effective clock speed between 12-15 MHz
** CPU might be clocked faster but have a lot of wait states
* 4 MB flash chip
** Bottom-boot organization this time
* 256 K main RAM
* Memory-mapped LCD
** 153600 bytes of VRAM confirmed, unknown if more exists
** Possibly an ARM Primecell PL111[http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0293c/index.html <nowiki>[HTML]</nowiki>][http://infocenter.arm.com/help/topic/com.arm.doc.ddi0293c/DDI0293.pdf <nowiki>[PDF]</nowiki>]
* French version has testing LED; American version may get a testing LED in the future
* User programs are prohibited from using any IN/OUT instructions
** OUT causes a reset
** IN produces a constant value
*** Rather, ports are now memory mapped to certain RAM addresses
*** However, ports controlling items such as the testing LED remain off-limits, for good reasons.
* Flash starts at $000000
** There is also still a flash unlock sequence
* RAM starts at $D00000
* Assembly programs and TI-BASIC programs are limited to one sector (64KB)
* VRAM starts at $D40000
** VRAM is executable

Compilers

2015-02-12T06:07:11Z

Ahelper:

{{stub}}

== z80 ==
* '''SDCC''' is an open source C compiler for microcontrollers. It can output z80 assembly. However, the code is bloated and inefficient.
* '''z88dk''' is a derivative of the Small-C compiler. It is targeted specifically at the z80 line of processors and even has dedicated TI file format outputs. The code is very bloated and can be less efficient than SDCC.
* The '''HI-TECH Z80 C Compiler''' is a very old and unsupported compiler by HI-TECH that produces much better-quality code than the two compilers mentioned above (Although recent SDCC versions are able to generate code comparable to the HI-TECH C compiler). However, HI-TECH has discontinued this compiler and it is very difficult to obtain a copy. Furthermore, it is a commercial, not open-source, compiler, so using it without a license is of questionable legality.

== 68k ==
* '''TIGCC''' is the original C compiler for 68k calculators. It is a patched version of the GNU Compiler Collection, and only supports C.
* '''GCC4TI''' is a 2009 fork of TIGCC.

Compilers

2015-02-12T06:06:06Z

Ahelper: z88dk is based on Small-C, not the same as SDCC

{{stub}}

== z80 ==
* '''SDCC''' is an open source C compiler for microcontrollers. It can output z80 assembly. However, as the compiler is retargetable, the code is bloated and inefficient.
* '''z88dk''' is a derivative of the Small-C compiler. It is targeted specifically at the z80 line of processors and even has dedicated TI file format outputs. The code is very bloated and less efficient than SDCC.
* The '''HI-TECH Z80 C Compiler''' is a very old and unsupported compiler by HI-TECH that produces much better-quality code than the two compilers mentioned above (Although recent SDCC versions are able to generate code comparable to the HI-TECH C compiler). However, HI-TECH has discontinued this compiler and it is very difficult to obtain a copy. Furthermore, it is a commercial, not open-source, compiler, so using it without a license is of questionable legality.

== 68k ==
* '''TIGCC''' is the original C compiler for 68k calculators. It is a patched version of the GNU Compiler Collection, and only supports C.
* '''GCC4TI''' is a 2009 fork of TIGCC.

Calculator Documentation

2015-02-12T05:56:03Z

Ahelper: Placeholder for 84P CE

== TI-83 (Regular) ==

* [[:Category:83:ROMCalls:By_Name|ROMCalls (System Entrypoints)]]
* [[:Category:83:Flags:By_Name|Flags]]
* [[:Category:83:OS_Information|General OS Documentation]]
* [[:Category:83:Ports:By_Address|Ports]]
* [[:Category:83:RAM:By_Name|RAM Areas]]

== TI-83 Plus Family ==

* [[:Category:83Plus:BCALLs:By_Name|B_CALLs (System Entrypoints)]]
* [[:Category:83Plus:Flags:By_Name|Flags]]
* [[:Category:83Plus:OS_Information|General OS Documentation]]
* [[:Category:83Plus:General_Hardware_Information|General Hardware Documentation]]
* [[:Category:83Plus:Hooks:By_Name|Hooks]]
* [[:Category:83Plus:Ports:By_Address|Ports]]
* [[:Category:83Plus:RAM:By_Name|RAM Areas]]
* [[:Category:83Plus:Basic|TI-83+ Basic]]
* [[:Category:83Plus:Quirks|Quirks]]

== TI-84+CSE ==

* [[:Category:84PCSE:BCALLs:By_Name|B_CALLs (System Entrypoints)]]
* [[:Category:84PCSE:Flags:By_Name|Flags]]
* [[:Category:84PCSE:OS_Information|General OS Documentation]]
* [[:Category:84PCSE:General_Hardware_Information|General Hardware Documentation]]
* [[:Category:84PCSE:Hooks:By_Name|Hooks]]
* [[:Category:84PCSE:RAM:By_Name|RAM Areas]]
* [[:Category:84PCSE:Basic|TI-83+ Basic]]
N.b.: Because the TI-84+CSE is based on the older TI-84+ ASIC, much of the hardware related documentation is the same. Therefore, the port list for the TI-84+CSE shall be combined with the TI-83+ ports.

== TI-84 Plus CE ==
Since this calculator is yet to be released until Spring of 2015, there is limited known information on this model.

== TI-86 ==

* [[:Category:86:ROMCalls:By_Name|ROMCalls (System Entrypoints)]]
* [[:Category:86:Flags:By_Name|Flags]]
* [[:Category:86:OS_Information|General OS Documentation]]
* [[:Category:86:Ports:By_Address|Ports]]
* [[:Category:86:RAM:By_Name|RAM Areas]]

== M68K Family ==

* [[:Category:68k:Ports:By_Address|Ports]]

== Z80 programming ==
* [[Meta-tutorial]]
* [[:Category:Z80_Routines|Z80 Routines]]
* [[Z80 Instruction Set]]
* [[Z80 Good Programming Practices]]
* [[Z80 Optimization]]
* [[Programming cross z80 calculators]]
* [[Programming APPS vs. Ram Programs]]
* [[Programming under Unix-like operating systems]]
* [[Programming an OS for z80 calculators]]

== Calculator Software ==
* [[Notable programs]]
* [[:Category:83Plus:Software|83Plus Software Documentation]]
* [[Experiments]]

== Computer Software ==
* [[Link software]]
* [[:Category:Emulators|Emulators]]
* [[Assemblers]]
* [[Compilers]]
* [[IDEs]]
* [[Disassemblers]]

== TI Community ==

* [[Beginners|Beginners' manual]]
* [[Calculator General FAQ]]
* [[History of the TI Z80 community]]
* [[:Category:Teams|Programming Teams List]]
* [[TI websites|TI Web Sites List]]

== Contributing ==

Please read our page on [[Contributing]] before you start contributing to WikiTI.

If you feel like contributing but do not know where, see the [[To Do List]].

Programming under Unix-like operating systems

2012-12-07T17:47:00Z

Ahelper: Added 2 more emulators

Here are the different tools at your disposal:

= General Overviews =

==Emulators==
* [http://lpg.ticalc.org/prj_tilem/ TilEm]
* [http://wabbit.codeplex.com/releases/view/44625 WabbitEmu] through Wine
* [http://www.cemetech.net/projects/jstified/ jsTIfied]
* VirtualTI through wine
* [[PindurTI]] through Wine
* [[PindurTI]] in non-interactive mode (with or without [http://kvince83.tengun.net/maxboard/viewtopic.php?t=2466 PTI frontend])

==Syntax highlighting==
Several editors have native or extensional support for editing Z80 assembly code with syntax highlighting:
* Kwrite and Kate can be made to syntax-highlight Z80 assembly with [http://www.ticalc.org/archives/files/fileinfo/391/39178.html the appropriate definition file]. The file must be placed in /usr/share/apps/katepart/syntax .
* SciTE and Emacs both have native modes for assembly code. For Emacs, one must make sure to turn on Font Lock mode as well.
* The [http://www.revsoft.org/phpBB2/viewforum.php?f=25 Z80 Assembly IDE] has simple syntax highlighting built-in.
* Users of Vim and WLA DX can use [http://www.cpcwiki.eu/index.php/How_to_use_VIM_for_CrossDev#Z80_files_detection this syntax file].

== Assembling ==

=== SPASM ===

'''Author''': Spencer Putt

'''Home Page''': [http://www.revsoft.org/phpBB3/viewforum.php?f=21 http://www.revsoft.org/phpBB3/viewforum.php?f=21]

SPASM is a portable Z80 assembler released under the GPL. Its distinguishing features are extremely fast assembly and powerful macro support. The output is only available in binary form, however with the use of [http://www.revsoft.org/phpBB2/viewforum.php?f=23 Wabbitsign], written by James Montelongo and Spencer Putt, it can easily be converted to any desired program type.

assembler foo.asm foo.bin
wabbit foo.bin foo.8xp

SPASM and Wabbitsign are included in [http://www.ticalc.org/archives/files/fileinfo/390/39009.html Z80 Assembly IDE 1.32] by burntfuse

=== tpasm ===

'''Author''': Todd Squires

'''Home page''': [http://www.sqrt.com/ http://www.sqrt.com/]

tpasm is a Free (GPL) assembler which supports the Z80 as well as the 6805, 6809, 68HC11, 6502, Sunplus, 8051, PIC, and AVR. It uses syntax very similar to ZMASM.

tpasm 1.2 does not support binary file output, but you can use ''objcopy'' (from the GNU binutils package) to convert its Intel Hex output into binary; e.g.

tpasm foo.asm -o intel foo.hex -l foo.lst
objcopy -I ihex foo.hex -O binary foo.bin

tpasm 1.4 has a bug where the set pseudo-opcode takes precedence over the Z80 set instruction. A quickfix is to disable the set pseudo-opcode by commenting line 86 of pseudo.c (.set is still available).

=== ASxxxx ===

'''Author''': Alan R. Baldwin

'''Home page''': [http://shop-pdp.kent.edu/ashtml/asxxxx.htm http://shop-pdp.kent.edu/ashtml/asxxxx.htm]

ASxxxx is a freeware assembler which supports the Z80 along with a large variety of other processors. It more closely resembles a modern PC assembler than a typical Z80 assembler, as it assembles each file into a relocatable object format which can then be linked with other files to produce the complete program. The linking is done by a separate program called ASlink (included with the package.)

To assemble and link a simple program you might do something like

asz80 -plogff foo.asm
aslink -u -b _CODE=0x9D95 -i foo.ihx foo.rel
objcopy -I ihex foo.ihx -O binary foo.bin

Note that the syntax is rather different from that of most Z80 assemblers. The important differences are
* Immediate values are marked with #.
* Indexed memory access is written as N(ix) rather than (ix+N).
* Constants are written differently: 0xAA, 0hAA, or $$AA for hexadecimal; 0o252, 0q252, or $&252 for octal; 0b10101010 or $%10101010 for binary.

For example,
ld hl,#str_hello
add a,3(ix)
xor #0x0f

There is also a modified version of ASxxxx distributed with the [http://sdcc.sf.net/ Small Device C Compiler]. This version is, if anything, more confusing to use due to the poorly-documented changes made by the SDCC team.

=== TASM ===

'''Author''': Thomas N. Anderson

'''Home page''': [http://home.comcast.net/~tasm/ http://home.comcast.net/~tasm/]

TASM is a shareware assembler which also supports a variety of processors.

There are several ways that you can use tasm under Linux:
* The TASM 3.1 for Linux shareware release is still in the wild. To use this you will need to enable "a.out" support in your kernel (it may be available as the module ''binfmt_aout''.) You will also need to obtain the ancient Linux libc version 4 (''not'' glibc) which can be found [http://ftp.linux.org.uk/pub/linux/libc/ here].
* You can use TASM 3.2 for Windows with [http://www.winehq.com Wine].
* You can pay the $40 and compile it yourself on the platform of your choice.

=== Brass ===
'''Author''': benryves

'''Home page''': [http://benryves.com/bin/brass/ http://benryves.com/bin/brass/]

Brass runs under Linux thanks to Mono.

=== Zasm ===
'''Author''': Steven Deprez

'''Home page''': [http://lpg.ticalc.org/prj_zasm/index.html http://lpg.ticalc.org/prj_zasm/index.html]

Zasm is an open source assembler that is almost fully compatible with Tasm and ZDS.

=== WLA DX ===
'''Author''': Ville Helin

'''Home page''': [http://www.villehelin.com/wla.html http://www.villehelin.com/wla.html]

WLA DX is another open-source (GNU GPL) cross-assembler with a primary focus on targeting video game consoles. It is a high-powered assembler with a wide variety of features such as, e.g. separate compilation, POSIX-like file I/O, and code sectioning. However it is cumbersome when assembling small projects, and semantics are unorthodox compared to other assemblers. (~ is the XOR operator, macro arguments are passed by value, etc.).

WLA DX has had an influence in the development of Brass.

=== Pasmo ===
'''Author''': Julián Albo

'''Home page''': [http://www.arrakis.es/~ninsesabe/pasmo/ http://www.arrakis.es/~ninsesabe/pasmo/]

Pasmo is another standalone Z80 cross-assembler with basic macro support, but without the ability to generate
relocatable object files. It is licensed under the GNU GPL, and exists as the package <tt>pasmo</tt> in the Debian pool.

=== z80asm ===
'''Author''': Bas Wijnen

'''Home page''': [http://savannah.nongnu.org/projects/z80asm/ http://savannah.nongnu.org/projects/z80asm/]

z80asm is a standalone Z80 cross-assembler similar in nature to Pasmo, in that it has macro support but cannot generate relocatable object files. It too is licensed under the GNU GPL (version 2 or later), and exists as the package <tt>z80asm</tt> in the Debian pool.

=== GNU as ===
'''Author''': the GNU binutils team

'''Home page''': [http://www.gnu.org/software/binutils/ http://www.gnu.org/software/binutils/]

Starting from version 2.17, the GNU assembler, part of the binutils package, is capable of cross-assembling Z80 code when configured for it at compile-time, such as with <tt>--target=z80-unknown-coff</tt>. binutils includes a powerful assembler and linker both, along with various utilities for handling object files, such as objcopy and objdump; for Z80, COFF is used for relocatable objects, with raw binary and Intel hex formats also supported. While this is probably one of the more powerful tools in the list for Z80 development, it also requires more work to start with, as the traditional way to get a cross-assembling binutils is to compile it oneself. Being a GNU package, binutils is naturally licensed under the GNU GPL (version 2 or later). Prepackaged binary versions of binutils are very common, but usually do not have cross-assembling capability.

==Sending programs to the calc==
* [http://www.ticalc.org/archives/files/fileinfo/374/37480.html TiLP-II] (requires [http://www.ticalc.org/archives/files/fileinfo/374/37479.html tilibs])
* [http://www.ticalc.org/archives/files/fileinfo/75/7588.html titranz] : commandline tool, only works for TI-83/TI-83+

= FreeBSD =
Much of the aforementioned software should compile independently without problem or with minor tweaking under FreeBSD, but it is best to utilize the ports collection whenever possible. Unfortunately, the current state of calculator-related software in the FreeBSD Ports Collection is lacking in variety.

* Development
{| width="75%" class="wikitable" style="margin: 1em auto 1em auto"
|- align="left"
!Port !! Current Version !! Location
|-
|tpasm || 1.2_1 || devel/tpasm
|-
|z80asm || 1.6_1 || devel/z80asm
|-
|z80-asm || 0.1_1 || devel/z80-asm
|-
|TI-GCC || 0.96.b8 || devel/tigcc
|-
|libtifiles2 || 1.0.1 || devel/libtifiles2
|}

* Communications
{| width="75%" class="wikitable" style="margin: 1em auto 1em auto"
|- align="left"
!Port !! Current Version !! Location
|-
|TiLP-II || 1.01 || comms/tilp2
|-
|libticables2 || 1.0.2 || comms/libticables2
|-
|libticalcs2 || 1.0.1 || comms/libticalcs2
|}

* Converters
{| width="75%" class="wikitable" style="margin: 1em auto 1em auto"
|- align="left"
!Port !! Current Version !! Location
|-
|libticonv || 1.0.0 || converters/libticonv
|}

* Emulation
{| width="75%" class="wikitable" style="margin: 1em auto 1em auto"
|- align="left"
!Port !! Current Version !! Location
|-
| TIEmu 2 || 2.08 || emulators/tiemu2
|}

= Mac OS X =
(Note that all of these assesments were made on a MacBook running 10.4.9 Intel. Mileage may vary on other versions and of course the Darwine stuff won't work on PPC.)

TiLP-II is known to compile and work properly with SilverLink and Direct USB cables with the 83+, 84+SE, and 89Ti, so there is no reason to believe it will not work with the other calculators. TI Connect X works well enough on Intel Macs even though it is not officially supported, however it seems to be more strict with the format of .8xk files than TiLP or TI Connect (Windows).

Brass works in Mono. Wabbitspasm compiles and works properly. ZDS works in Darwine.

TilEm compiles but seems to have some issues with multiple ROM versions. It is unclear to me if this is a problem with the build or TilEm itself. PindurTI is somewhat usable in Darwine: You must use the send.exe utility to send the ROM image, then it will emulate properly. However, it makes extensive use of the F-keys, including the ExposÃ© ones. Remapping the ExposÃ© keys is the only solution. TI FLASH Debugger runs in Darwine but the calculator windows are unskinned: You must either use the keyboard or click blindly in the window. The display output is fine, and other debugger windows appear to function properly. VirtualTI (2.5) should run OK after putting the ROM files somewhere Darwine knows about (I was lazy).

= Other Unixes =

This section is a stub. Please add it it.

83Plus:OS:TIOS Alternatives

2011-11-24T06:53:51Z

Ahelper: Added GlaßOS to the list, finally

[[Category:83Plus:OS_Information|TIOS Alternatives]]

== Introduction ==

The TIOS is the official, standard operating system for the
TI-83+ series of calculators (including the TI-83+ and TI-84+ and the respective Silver
Editions of each). The vast majority of programs for such calculators run on top of the
TIOS, or on top of some subsidiary program that runs from the TIOS, and thereby implicitly
depend on its functionality. However, some people have researched writing alternative
operating system code and sending it to the calculator to replace the TIOS.
Several such alternative operating systems are available on the Web, though most of them are
not yet at a production stage of development.

== List of alternative operating systems ==

*[http://michaelv.org/programs/calcs/ceptic.php CEPTIC], by Michael Vincent: a Control and Execute Program for TI Calculators. The current version of CEPTIC only runs on the TI-83+ SE, but can be modified to run on the TI-83+. Assembly source is available, but actually using the OS in its present state is considered non-practical, and the project has been discontinued for various reasons.
*[http://pongos.sourceforge.net/ PongOS], by FloppusMaximus: a simple, proof-of-concept system whose namesake feature is an embedded Pong game. Some other system utilities, mostly inspired by Dan Englender's Calcsys, are also available in PongOS, including a hex editor, memory mover (with flash capability), flash sector eraser, and port monitor. Link support is not provided.
*[[Vera]], by several members of different programming groups: dubbed the "true calc lover's OS". Vera is intended to consist of a very basic kernel which can be easily extended to include desired features. The original Vera project has been abandoned, but it has been picked up again in a different form, and seems to be progressing nicely.
*[http://www.ticalc.org/archives/files/fileinfo/349/34973.html CSX], by Sean McLaughlin: a command-line-based operating system with a screen layout similar to that of the TI-89 calculators. CSX provides a simple filesystem, send and receive of files over a link cable, hex editing of memory, and running of Z80 machine code programs.
*[http://forum.reaktix.com/viewtopic.php?pid=11 Nostalgy], originally by [http://katpro.xiondigital.net/ XDG Kat-Productions], now developed by [http://reaktix.com/ Reaktix Software]: an unofficial project started by XDG Kat-Productions, abandoned when the two main developers became involved in other projects, and later resumed by [[User:Saibot84|Saibot84]]. A pre-alpha working demo is available. Development is still underway, albeit extremely slowly. It currently features a task-switching environment inspired by [http://www.radicalsoft.org/ Radical Software's] TSE, although linking and a file system are not yet implemented.
*[http://lifos.sourceforge.net/ LIFOS], by Peter Marheine: a similar project to Vera, designed to offer minimal functionality (linking, memory management, and machine code execution) in its basic incarnation but meant to be easily extended into a near-seamless infrastructure of various functions. Currently (5-28-07) in early alpha stages. The name comes from the memory allocation system (LIFO OS, or LIFOs).
*[http://www.ticalc.org/archives/files/fileinfo/398/39863.html BAOS], by Erik van 't Wout: Basic Assembly Operating System. (excerpt from the ReadMe:) Being developed "to be a real Operating System for TI-83+ based calculators. It should turn your calculator into a real computer, which can be used for mathematical purposes, but not as main target. Additional functionality should be easy to implement trough the use of libraries."
*[http://www.brandonw.net/calcstuff/OS2 OS2], by Brandon Wilson: OS2 is "the TI-OS done right", a from-the-ground-up re-implementation of the TI-OS, designed to do everything the TI-OS can do and run everything it can, but with fewer restrictions and changes not normally possible due to the TI-OS' structure, such as being able to run BASIC programs directly from the archive. It also supports dual-booting with the TI-OS so a user can continue to use the original TI-OS while more and more is added to OS2. Currently only dual-booting and a basic system monitor are supported.
*[http://code.google.com/p/8xpos/ XOS] by Luc Bruant aka fullmetalcoder, XOS main targets are SE calcs (those with 128kb of RAM). It aims to provide a lot of power to application developer, larger storage capacity whenever possible and a minimal emulation layer to ensure a certain level of backward compatibility of TIOS programs and Apps so as to ease the transition for users.
*[[83Plus:Software:KnightOS|KnightOS]] by SirCmpwn: a completely different OS designed loosely around Linux. KnightOS has no compatibility with the TIOS and completely clobbers the TIOS's filesystems. KnightOS uses its own filesystem, KFS, which uses the ROM for storage and uses RAM entirely for program execution and the heap/stack. The kernel, KnightKernel, also has thread support. However, KnightOS has not been released. It is still under development.
*[http://sf.net/projects/glassos GlaßOS], by AHelper, is an OS written for the TI84PSE in C. It features a working USB driver; system-provided libc commands provided by sdcclib, such as floating point math, printf and friends, and others; GUI, graphics, and grayscale libraries; and more: all written either completely or mostly in C. Because of a radical approach, the OS provides no support for TIOS and is simple a core OS with no stand-alone functionality (packaged programs can be installed). The source of GlaßOS has been released and is stable to run on a calc. A final release date is pending.

[[Category:83Plus:OS_Information|TIOS Alternatives]]

User:Ahelper

2011-11-24T06:33:22Z

Ahelper: Rewrite

My entire z80 calc programming revolves around GlaßOS. This is a WIP

== GlaßOS ==
GlaßOS is a new operating system for the TI84PSE calcs, with and without extra RAM, that lets developers use C to quickly create programs and get results quickly from a friendly, high-level language. The OS is >95% C with the rest inline assembly. The OS is meant to be a kernel with C libraries that provides a C environment. This means, however, that it isn't completely assembly-friendly.
=== History ===
Too boring to write right now.
=== Friends ===
* glassKILL
* Islands
* gCAS2
* libgcas2
* launcher
* gFiler
* glassChat - Must be rewritten due to major USB API changes
=== Developing for GlaßOS ===
Writing programs for GlaßOS requires the use of the GlaßOS SDK, which provides information about supported svn revisions of SDCC, code examples, OS notes, and needed headers and libraries. Programs that are ready for public distribution will use a web tool to add the software to a repo that will be available to all OS users.
=== Notes ===
All hail Linky, letting me keep my assembly usage under 5%.

== glassKILL ==
== glassChat ==
== gFiler ==
== gCAS2 ==
== libgcas2 ==
== launcher ==
== Islands ==

83Plus:Software:usb8x/FAQ

2011-11-24T06:14:15Z

Ahelper: Touchups and mentioned Linky

If you have a question not answered here, please feel free to ask it on the [[Talk:83Plus:Software:usb8x/FAQ|Discussion Page]].

== General Questions ==
=== With which calculators is usb8x compatible? ===
usb8x is compatible with the TI-84 Plus and TI-84 Plus Silver Edition calculators. It appears to work best with calculators that have Boot Code 1.02. We're working on improving compatibility with Boot Code 1.00. '''usb8x is NOT compatible with the 89 Titanium''', but there is an app for the 89 Titanium, Linky, that reimplements the USB driver.

=== With which USB devices is usb8x compatible? ===
Please check the [[83Plus:Software:usb8x/Supported Devices|Supported Devices]] page for details on device compatibility.

=== How do I connect USB devices to my calculator? ===
The TI-84 calculators have a mini-USB port. This means you can connect devices that have a mini-A plug, such as [http://www.vernier.com/easy/easytemp.html Vernier EasyTemp], directly. To connect devices with a standard A or B USB plug (i.e. almost all other USB peripherals), you need to buy an adapter. The [http://www.goldxproducts.com/showproduct.asp?pid=GXQU GoldX Quick Connect] adapter cable is available in many stores, and this [https://serialio.com//store/product_info.php?cPath=54_61&products_id=141 SERIALiO cable] will also work.

=== How do I use usb8x? ===
usb8x is a driver and doesn't let you "do" anything by itself. You need to download (or [[#Developer_Questions|create]]) a program that uses usb8x, such as [[83Plus:Software:msd8x|msd8x]] or [[83Plus:Software:USBTools|USBTools]].

== Developer Questions ==
=== How do I use usb8x from a BASIC program? ===
usb8x can be accessed from BASIC via the OpenLib( and ExecLib commands. See the usb8x [[83Plus:Software:usb8x/BASIC_Interface|BASIC Documentation]] for more information.

=== How do I use usb8x from an assembly program? ===
usb8x can be accessed from RAM programs or applications via the U_CALL macro interface. See the usb8x [[83Plus:Software:usb8x/Asm_Interface|Assembly Documentation]] for more information.

83Plus:Software:USBTools/Stuff

2011-11-24T06:08:34Z

Ahelper: Even the back button didn't work -_-

Stuff is meant to implement usb8x driver integration into TIOS. Unfortunately it hasn't been coded yet, so nothing on this menu works, except for the Back button.

Stuff
1) KBD Action
2) Mouse Action
3) [[83Plus:Software:USBTools|Back]]

83Plus:Software:USBTools/Tools

2011-11-24T06:07:57Z

Ahelper:

The tools menu contains tools (hopefully) useful for the usb8x developer.

Tools
1) [[#Descriptors|Descriptors]]
2) [[#Log_Viewer|Log Viewer]]
3) [[#Start_Log|Start Log]]
4) [[83Plus:Software:USBTools|Back]]

== Descriptors ==
The descriptors tool allows you to read device, configuration, and string descriptors from an attached device. The descriptors are parsed for human readability. The descriptors tool can be used to test device compatibility with usb8x, to find the vendor and device IDs for a peripheral, or to determine configuration information for use with a manual setup.

The config descriptor tool reads/displays all descriptors that are part of the extended configuration descriptor, which includes: config, interface, endpoint, HID, and OTG. Not all of these descriptors will necessarily be present on all devices. The string descriptor tool requests the string number to fetch and will return an error if that string does not exist on the device.

Descriptors
1) Device
2) Config
3) String
4) Back

== Log Viewer ==
The log viewer parses and displays usb8x log data that has been saved by a program using [[83Plus:Software:usb8x/Asm_Interface/SetupLog|SetupLog]] or via the [[#Start_Log|Start Log]] tool in USBTools.

The log viewer will prompt for the page and address of the log, and if log data is present it will display log entries. Use UP/DOWN to scroll through the log display, and use ENTER to view detailed information on Data log entries.

== Start Log ==
Start log begins logging immediately at the specified page and address. This can be used to log and debug any errors that occur within USBTools while using the [[#Descriptors|descriptors tool]] or any of the [[83Plus:Software:USBTools/Demos|demos]].

Note that logging must be enabled in the usb8x binary for this tool to have any effect. You can check if logging is enabled via the USBTools [[83Plus:Software:USBTools/About|about screen]].

83Plus:Software:USBTools/Tools

2011-11-24T06:07:30Z

Ahelper: Touchups

The tools menu contains tools (hopefully) useful for the usb8x developer.

Tools
1) [[#Descriptors|Descriptors]]
2) [[#Log_Viewer|Log Viewer]]
3) [[#Start_Log|Start Log]]
4) [[83Plus:Software:USBTools/|Back]]

== Descriptors ==
The descriptors tool allows you to read device, configuration, and string descriptors from an attached device. The descriptors are parsed for human readability. The descriptors tool can be used to test device compatibility with usb8x, to find the vendor and device IDs for a peripheral, or to determine configuration information for use with a manual setup.

The config descriptor tool reads/displays all descriptors that are part of the extended configuration descriptor, which includes: config, interface, endpoint, HID, and OTG. Not all of these descriptors will necessarily be present on all devices. The string descriptor tool requests the string number to fetch and will return an error if that string does not exist on the device.

Descriptors
1) Device
2) Config
3) String
4) Back

== Log Viewer ==
The log viewer parses and displays usb8x log data that has been saved by a program using [[83Plus:Software:usb8x/Asm_Interface/SetupLog|SetupLog]] or via the [[#Start_Log|Start Log]] tool in USBTools.

The log viewer will prompt for the page and address of the log, and if log data is present it will display log entries. Use UP/DOWN to scroll through the log display, and use ENTER to view detailed information on Data log entries.

== Start Log ==
Start log begins logging immediately at the specified page and address. This can be used to log and debug any errors that occur within USBTools while using the [[#Descriptors|descriptors tool]] or any of the [[83Plus:Software:USBTools/Demos|demos]].

Note that logging must be enabled in the usb8x binary for this tool to have any effect. You can check if logging is enabled via the USBTools [[83Plus:Software:USBTools/About|about screen]].

83Plus:Software:USBTools/Demos

2011-11-24T06:06:18Z

Ahelper: Touchups

__NOTOC__
The demos menu lists demos for various USB devices. These demos can be used to test the compatibility of specific USB peripherals with usb8x.
Demos
1) [[#Mouse_Demo|Mouse Demo]]
2) [[#KBD_Demo|KBD Demo]]
3) [[#Gamepad_Demo|Gamepad Demo]]
4) [[#MSD_Demo|MSD Demo]]
5) [[#Silver_Demo|Silver Demo]]
6) [[83Plus:Software:USBTools|Back]]

== Mouse Demo ==
The mouse demo tests usb8x's [[83Plus:Software:usb8x/Asm_Interface/Mouse|mouse driver]]. Connect a mouse to the USB port, run the demo, and you should see a mouse cursor in the middle of the screen. Moving the mouse around should move the cursor, and pressing a mouse button should change the cursor graphic. Press the CLEAR button to quit the demo. Warning: the demo doesn't do bounds checking on the edge of the screen. Moving the cursor off the edge of the screen may crash your calculator!

The mouse demo is replicated in the usb8x [[83Plus:Software:usb8x/Sample_Code#Mouse_Demo_2|sample code]].

== KBD Demo ==
The kbd demo tests usb8x's [[83Plus:Software:usb8x/Asm_Interface/KBD|keyboard driver]]. Connect a keyboard to the USB port, run the demo, and start typing on the keyboard. The keys you type should be echoed on the calculator's screen. Pressing Caps Lock and Num Lock should light the appropriate LEDs on the keyboard and affect the key output accordingly. Press CLEAR on the calculator's keypad, or Esc on the keyboard to quit the demo.

== Gamepad Demo ==
The gamepad demo tests usb8x's [[83Plus:Software:usb8x/Asm_Interface/Pad|gamepad driver]]. The demo is the same as the mouse demo, but the cursor is controlled by a gamepad instead of a mouse. When you start the gamepad demo, you will be prompted to press Down, Up, Left, Right, and Fire on your gamepad to set the button mappings. Then the mouse cursor will appear on the screen and can be controlled by the buttons you mapped earlier. Note that not all gamepads may be compatible with the
driver. Please see the list of [[83Plus:Software:usb8x/Supported_Devices|supported devices]] for gamepads that have been tested to work with usb8x.

== MSD Demo ==
There is currently no MSD demo in USBTools. Use [[83Plus:Software:msd8x|msd8x]] to test the [[83Plus:Software:usb8x/Asm_Interface/MSD|mass storage driver]].

== Silver Demo ==
The silver demo tests usb8x's [[83Plus:Software:usb8x/Asm_Interface/Silver|silverlink driver]], which allows you to use the silver TI-Graphlink to communicate to another calculator via usb8x. In the demo, however, the calculator communicates with itself. Plug in the silverlink to the USB port, and then connect the serial end of the silverlink to the calculator's serial I/O port. When you run the demo, the calculator will transmit data for a few seconds, and then display the throughput, in bytes per second, of data transmitted.

83Plus:Software:USBTools/Tools

2011-11-24T06:04:23Z

Ahelper: Touchups

The tools menu contains tools (hopefully) useful for the usb8x developer.

Tools
1) [[#Descriptors|Descriptors]]
2) [[#Log_Viewer|Log Viewer]]
3) [[#Start_Log|Start Log]]
4) [[../|Back]]

== Descriptors ==
The descriptors tool allows you to read device, configuration, and string descriptors from an attached device. The descriptors are parsed for human readability. The descriptors tool can be used to test device compatibility with usb8x, to find the vendor and device IDs for a peripheral, or to determine configuration information for use with a manual setup.

The config descriptor tool reads/displays all descriptors that are part of the extended configuration descriptor, which includes: config, interface, endpoint, HID, and OTG. Not all of these descriptors will necessarily be present on all devices. The string descriptor tool requests the string number to fetch and will return an error if that string does not exist on the device.

Descriptors
1) Device
2) Config
3) String
4) Back

== Log Viewer ==
The log viewer parses and displays usb8x log data that has been saved by a program using [[83Plus:Software:usb8x/Asm_Interface/SetupLog|SetupLog]] or via the [[#Start_Log|Start Log]] tool in USBTools.

The log viewer will prompt for the page and address of the log, and if log data is present it will display log entries. Use UP/DOWN to scroll through the log display, and use ENTER to view detailed information on Data log entries.

== Start Log ==
Start log begins logging immediately at the specified page and address. This can be used to log and debug any errors that occur within USBTools while using the [[#Descriptors|descriptors tool]] or any of the [[83Plus:Software:USBTools/Demos|demos]].

Note that logging must be enabled in the usb8x binary for this tool to have any effect. You can check if logging is enabled via the USBTools [[83Plus:Software:USBTools/About|about screen]].

83Plus:Ports:02

2011-10-31T16:06:23Z

Ahelper: Typo - port 04 displayed port 02

[[Category:83Plus:Ports:By Address|02 - Status Port]] [[Category:83Plus:Ports:By Name|Status Port]]
== Synopsis ==
'''Port Number:''' 02h

'''Function:''' Calculator Status Information

This port reports various status information, including battery strength, LCD driver status, and calculator type.

=== Read Values ===
* Bit 0: Set if the batteries are good. Reset if the batteries are low. The calculator will refuse to Garbage Collect or receive a FLASH App or OS when the batteries are low. The voltage cutoff can be configured in [[83Plus:Ports:04|port 04]].
* '''83+SE / 84+(SE) only:''' Bit 1: At 15MHz this bit resets for a set delay after a command or data is sent to the LCD, otherwise this bit is always set. The amount of delay is controlled by [[83Plus:Ports:2F|port 2F]]. On the TI-73, this bit is always reset (this is how you distinguish between the 73 and 83+ series hardware).
* Bit 2: Set if Flash is currently unlocked.
* '''83+ only:''' Bits 3-5:
** Bit 3: Last value written to port 05 bit 0
** Bit 4: Last value written to port 05 bit 1
** Bit 5: Last value written to port 05 bit 2
* '''84+(SE) only:''' Bit 5: Set for TI-84+ and TI-84+ SE calculators. Reset for TI-83+ and TI-83+ SE calculators.
* Bit 7: Reset for a TI-83+ Basic. Set for everything else.

=== Write Values ===
* No useful effect.

== Comments ==
See [[83Plus:Ports:21|Port 21h]] for how to distinguish the 84+ Basic from the 84+ SE.

== Examples ==
=== Battery checking ===
<nowiki> push af
in a, (2)
and 01h
call nz, BatteriesGood
call z, BatteriesLow
pop af</nowiki>

=== LCD Testing ===
<nowiki> push af
WaitLoop:
in a, (2)
and 02h
jr z, WaitLoop
;Send a command, like 03 (LCD "On").
call LCDIsReady
pop af</nowiki>

=== Device checking ===

''This example also uses [[83Plus:Ports:21|Port 21h]].''
<nowiki> in a, (2)
rlca ;Roll bit 7 into carry.
jp nc, Regular83Plus
and 40h ;Test bit 5, now rotated into bit 6.
jp z, Silver83Plus
in a, (21h)
and 03h
jp z, Regular84Plus
jp nz, Silver84Plus</nowiki>

== Credits and Contributions ==
* '''Michael Vincent''': Documentation of port 2 located [http://www.michaelv.org/programs/calcs/ports/port2.html here].

Notable programs

2011-07-28T04:01:14Z

Ahelper: /* Utilities */ Adding Linky - above older USB libs

{{stub}}
Here is a list of notable programs released by the TI Z80 community.
If you think a program has been forgotten, just add it.

For each program, please indicate: author, last version and release date, ticalc.org (or other if not available) URL, 1 or 2 screenshots, and a few words about it.

=Games=

==Puzzle==
* Ztris 1.3.2 ~ by Tijl Coosemans ~ http://www.ticalc.org/archives/files/fileinfo/207/20791.html
* Crates3D 1.1 ~ by Badja ~ http://www.ticalc.org/archives/files/fileinfo/192/19293.html
* Orzunoid ~ by Patrick Davidson ~ http://www.ticalc.org/archives/files/fileinfo/110/11033.html

==Action==
* Acelgoyobis ~ by CoBB ~ http://www.ticalc.org/archives/files/fileinfo/355/35586.html
* Bubble Bobble ~ Dan "dwedit" Weiss ~ http://www.ticalc.org/archives/files/fileinfo/235/23536.html
* Invaded ~ by James Vernon ~ http://www.ticalc.org/archives/files/fileinfo/206/20692.html

==Adventure or RPG==
* Desolate ~ tr1p1ea ~ http://www.ticalc.org/archives/files/fileinfo/348/34879.html

==Racing==
* Tiny Carz ~ Léo Ducas ~ http://www.ticalc.org/archives/files/fileinfo/391/39185.html

==First person shooter==
* Gemini ~ Hans "Coelurus" Törnqvist ~ http://www.ticalc.org/archives/files/fileinfo/247/24743.html
* Wolfenstein83 ~ Peter Bucher ~ http://www.ticalc.org/archives/files/fileinfo/277/27767.html
* zDoom 0.12 ~ http://www.ticalc.org/archives/files/fileinfo/360/36062.html

==Platform==
* sqrxz ~ by Jimmy Mardell ~ http://www.ticalc.org/archives/files/fileinfo/144/14494.html
* Super Mario 1.2 ~ Sam Heald ~ http://www.ticalc.org/archives/files/fileinfo/192/19225.html

==Others==
* TI-Boy v0.1.04 ~ Brendan Fletcher ~ http://www.omnimaga.org/index.php?topic=7880.msg157069#msg157069

=Shells=
* Doors CS ~ Christopher "Kerm Martian" Mitchell ~ http://www.ticalc.org/archives/files/fileinfo/430/43068.html
* Ion ~ Joe Wingbermuehle ~ http://www.ticalc.org/archives/files/fileinfo/130/13059.html
* MirageOS ~ Dan Englender | Jason Kovacs ~ http://www.ticalc.org/archives/files/fileinfo/139/13949.html

=Utilities=
* Emu8x v1.00 ~ Michael Vincent ~ http://www.ticalc.org/archives/files/fileinfo/377/37796.html
* Omnicalc ~ Michael Vincent ~ http://www.ticalc.org/archives/files/fileinfo/226/22626.html
* Linky ~ Brandon Wilson ~ http://brandonw.net/svn/calcstuff/Linky/
* USB8X ~ Dan Englender ~ http://sourceforge.net/projects/usb8x/files/
* MSD8X ~ Michael Vincent | Brandon Wilson ~ http://www.ticalc.org/archives/files/fileinfo/390/39064.html
* Real Sound v1.0 ~ James Montelongo ~ http://www.ticalc.org/archives/files/fileinfo/385/38513.html
* Axe Parser ~ Kevin Horowitz ~ http://www.ticalc.org/archives/files/fileinfo/428/42813.html
* Calcsys ~ Dan Englender ~ http://www.ticalc.org/archives/files/fileinfo/97/9781.html
* ALCDFIX ~ James Montelongo ~ http://www.ticalc.org/archives/files/fileinfo/366/36608.html
* Rom8x ~ Andree Chea ~ http://www.ticalc.org/archives/files/fileinfo/373/37341.html

=School (Math and others)=
* Symbolic ~ Brandon Sterner ~ http://www.ticalc.org/archives/files/fileinfo/228/22851.html
* Omnicalc ~ Michael Vincent ~ http://www.ticalc.org/archives/files/fileinfo/226/22626.html
* Graph3D
* ZoomAlgebra (shareware) ~ Jeff Hatch ~ http://www.zoommath.com/Products/
* Cabamap v1.02 ~ Michael Vincent ~ http://www.ticalc.org/archives/files/fileinfo/323/32326.html
* DAWG v1.0 ~ Kirk Meyer ~ http://www.ticalc.org/archives/files/fileinfo/258/25844.html

=External links=
* Ticalc.org's Program Of The Year : [http://www.ticalc.org/community/awards/poty/2003.html 2003] [http://www.ticalc.org/community/awards/poty/2004.html 2004] [http://www.ticalc.org/community/awards/poty/2005.html 2005] [http://www.ticalc.org/community/awards/poty/2006.html 2006] [http://www.ticalc.org/community/awards/poty/2007.html 2007] [http://www.ticalc.org/community/awards/poty/2008.html 2008] [http://www.ticalc.org/community/awards/poty/2009.html 2009]
* [http://wikiti.brandonw.net/index.php?title=83Plus:OS:TIOS_Alternatives TIOS alternatives]

User:Ahelper

2011-02-20T20:57:11Z

Ahelper: Updated some stuff

Oh dear, where do I start?

== Projects ==
Well, I have two...
=== TIKill ===
A very simple game for 68k. It's a simple clone of Gnome Robots in text mode. I haven't released it, but I can do so under GPLv3.
=== GlassOS (and friends) ===
A complete replacement OS for specific ti-84pse with 8 RAM pages. It is written as a core-core lib-lib layout... Most (>%) of the code is in C and compiles with SDCC. Key features (already done and working):
* A system-wide GUI
* OS runs in high-speed and can change speeds when needed
* All programs can ''malloc'' to get around 14-15K of memory.
* IEEE floating point math libraries are included :-) Enjoy! They are BIG (32K for all math.h functions, along with printf)
* A standard way of calling user libraries to expand programs and break the 16K binary size.
* You call programs just like linux: ./program parameters "can be passed". You access them just like normal with int argc and char** argv.
* USB communication using libusb (from Linky, yay)
* Task-switching (not multitasking) for up to 6 user programs, and 1 system task (Launcher)

Features that '''will''' exist:
* A filesystem with little restrictions, such as:
** Unlimited filename length
** Folders with limitless depth
* a standard graphics library (maybe 3D)
* A way to prevent and recover from crashing (A Process manager that allow killing things, soft reset, or a reboot)

The OS has been loaded onto a ti84+se and has run fine (when the code became stable). The OS is not done yet, but will be soon, even though I haven't worked on the OS that long...

User:Ahelper

2011-01-27T01:23:54Z

Ahelper: Initial Commit of page

Oh dear, where do I start?

== Projects ==
Well, I have two...
=== TIKill ===
A very simple game for 68k. It's a simple clone of Gnome Robots in text mode. I haven't released it, but I can do so under GPLv3.
=== GlassOS (and friends) ===
A complete replacement OS for specific ti-84pse with 8 RAM pages. It is written as a core-core lib-lib layout... Most (>75%) of the code is in C and compiles with SDCC. Key features:
* A system-wide GUI
* A filesystem with little restrictions, such as:
** Unlimited filename length
** Folders with limitless depth
* OS runs in high-speed and slows with GUI library
* All programs can ''malloc'' to get around 14-15K of memory.
* IEEE floating point math libraries are included :-) Enjoy! They are BIG (32K for all math.h functions, along with printf)
* A standard way of calling user libraries to expand programs and break the 16K binary size.

Features that '''will''' exist:
* Multi-tasking with up to 4 user programs.
* Filesystem can compress files using libhuffman
* USB communication using libusb (from periph8x, yay)
* a standard graphics library (maybe 3D)
* A way to prevent and recover from crashing