fformat.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
  2. <HTML>
  3. <HEAD>
  4. <META NAME="GENERATOR" Content="Visual Page 1.0 for Windows">
  5. <META HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">
  6. <TITLE>TI-83 Link Protocol Guide - File formats</TITLE>
  7. </HEAD>
  8. <BODY BGCOLOR="#FFFFE8">
  9. <P><B>TI-83 Link Protocol Guide v1.0</B> - File formats</P>
  10. <CENTER>
  11. <H2>
  12. <HR ALIGN="CENTER">
  13. File Formats</H2>
  14. </CENTER>
  15. <P>The TI-83 Graph Link software stores variables in several types of files. Single variables are stored in files
  16. that have an extension that corresponds with their type. Groups of variables are stored in files with the extension
  17. &quot;.83g&quot;. However, all of these file types have a common format.</P>
  18. <P>The different file types and contents that the TI-83 Graph Link software can read and write are shown below.</P>
  19. <P>
  20. <TABLE BORDER="1" CELLSPACING="0" WIDTH="66%">
  21. <TR>
  22. <TH WIDTH="13%" BGCOLOR="#DDDDDD">Extension</TH>
  23. <TH BGCOLOR="#DDDDDD">Description</TH>
  24. </TR>
  25. <TR>
  26. <TD WIDTH="13%">
  27. <P ALIGN="CENTER">.83b
  28. </TD>
  29. <TD>TI-83 system backup</TD>
  30. </TR>
  31. <TR>
  32. <TD WIDTH="13%">
  33. <P ALIGN="CENTER">.83b
  34. </TD>
  35. <TD>TI-83 complex number</TD>
  36. </TR>
  37. <TR>
  38. <TD WIDTH="13%">
  39. <P ALIGN="CENTER">.83d
  40. </TD>
  41. <TD>TI-83 GDB (function, polar, parametric or sequence)</TD>
  42. </TR>
  43. <TR>
  44. <TD WIDTH="13%">
  45. <P ALIGN="CENTER">.83g
  46. </TD>
  47. <TD>Multiple TI-83 variables of varying types (group)</TD>
  48. </TR>
  49. <TR>
  50. <TD WIDTH="13%">
  51. <P ALIGN="CENTER">.83i
  52. </TD>
  53. <TD>TI-83 picture (image)</TD>
  54. </TR>
  55. <TR>
  56. <TD WIDTH="13%">
  57. <P ALIGN="CENTER">.83l
  58. </TD>
  59. <TD>TI-83 list</TD>
  60. </TR>
  61. <TR>
  62. <TD WIDTH="13%">
  63. <P ALIGN="CENTER">.83m
  64. </TD>
  65. <TD>TI-83 matrix</TD>
  66. </TR>
  67. <TR>
  68. <TD WIDTH="13%">
  69. <P ALIGN="CENTER">.83n
  70. </TD>
  71. <TD>TI-83 real number</TD>
  72. </TR>
  73. <TR>
  74. <TD WIDTH="13%">
  75. <P ALIGN="CENTER">.83p
  76. </TD>
  77. <TD>TI-83 program</TD>
  78. </TR>
  79. <TR>
  80. <TD WIDTH="13%">
  81. <P ALIGN="CENTER">.83s
  82. </TD>
  83. <TD>TI-83 string</TD>
  84. </TR>
  85. <TR>
  86. <TD WIDTH="13%">
  87. <P ALIGN="CENTER">.83t
  88. </TD>
  89. <TD>TI-83 table setup</TD>
  90. </TR>
  91. <TR>
  92. <TD WIDTH="13%">
  93. <P ALIGN="CENTER">.83w
  94. </TD>
  95. <TD>TI-83 window settings (Window or RclWindow)</TD>
  96. </TR>
  97. <TR>
  98. <TD WIDTH="13%">
  99. <P ALIGN="CENTER">.83y
  100. </TD>
  101. <TD>TI-83 Y-Variable (equation)</TD>
  102. </TR>
  103. <TR>
  104. <TD WIDTH="13%">
  105. <P ALIGN="CENTER">.83z
  106. </TD>
  107. <TD>TI-83 zoom (saved window settings)</TD>
  108. </TR>
  109. </TABLE>
  110. <p></P>
  111. <P>
  112. <HR ALIGN="CENTER">
  113. <p></P>
  114. <H3>The TI-83 variable file format</H3>
  115. <P>The TI-83 variable file format has two parts: a header and several variable entries.</P>
  116. <P>The header appears at the beginning of the file and takes the following format:<BR>
  117. <I>Note - All 2-byte integers are stored little-endian Intel-style (least significant byte first).</I></P>
  118. <P>
  119. <TABLE BORDER="1" CELLSPACING="0" WIDTH="92%">
  120. <TR>
  121. <TH WIDTH="8%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Offset</FONT></TH>
  122. <TH WIDTH="11%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Length</FONT></TH>
  123. <TH WIDTH="81%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Description</FONT></TH>
  124. </TR>
  125. <TR>
  126. <TD WIDTH="8%" BGCOLOR="#FFFFFF">0</TD>
  127. <TD WIDTH="11%" BGCOLOR="#FFFFFF">8 bytes</TD>
  128. <TD WIDTH="81%" BGCOLOR="#FFFFFF">8-character signature. The signature is always &quot;<TT>**TI83**</TT>&quot;.</TD>
  129. </TR>
  130. <TR>
  131. <TD WIDTH="8%" BGCOLOR="#FFFFFF">8</TD>
  132. <TD WIDTH="11%" BGCOLOR="#FFFFFF">3 bytes</TD>
  133. <TD WIDTH="81%" BGCOLOR="#FFFFFF">3-byte further signature. These three bytes always contain {1Ah, 0Ah, 00h} = {26, 10, 0}</TD>
  134. </TR>
  135. <TR>
  136. <TD WIDTH="8%" BGCOLOR="#FFFFFF">11 (Bh)</TD>
  137. <TD WIDTH="11%" BGCOLOR="#FFFFFF">42&nbsp;(2Ah)&nbsp;bytes</TD>
  138. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Comment. The comment is either zero-terminated or padded on the right with space characters.</TD>
  139. </TR>
  140. <TR>
  141. <TD WIDTH="8%" BGCOLOR="#FFFFFF">53 (35h)</TD>
  142. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  143. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the data section of the file. This number should be 57 (39h) bytes less than the file size.</TD>
  144. </TR>
  145. <TR>
  146. <TD WIDTH="8%" BGCOLOR="#FFFFFF">55 (37h)</TD>
  147. <TD WIDTH="11%" BGCOLOR="#FFFFFF"><I>n</I> bytes</TD>
  148. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Data section - consists of a number of variable entries (described below).</TD>
  149. </TR>
  150. <TR>
  151. <TD WIDTH="8%" BGCOLOR="#FFFFFF">55&nbsp;(37h)+<I>n</I></TD>
  152. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  153. <TD WIDTH="81%" BGCOLOR="#FFFFFF">File checksum. This is the lower 16 bits of the sum of all bytes in the data section.</TD>
  154. </TR>
  155. </TABLE>
  156. <p></P>
  157. <P>Each variable entry follows this format:</P>
  158. <P>
  159. <TABLE BORDER="1" CELLSPACING="0" WIDTH="92%">
  160. <TR>
  161. <TH WIDTH="8%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Offset</FONT></TH>
  162. <TH WIDTH="11%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Length</FONT></TH>
  163. <TH WIDTH="81%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Description</FONT></TH>
  164. </TR>
  165. <TR>
  166. <TD WIDTH="8%" BGCOLOR="#FFFFFF">0</TD>
  167. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  168. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Always has a value of 11 (Bh).</TD>
  169. </TR>
  170. <TR>
  171. <TD WIDTH="8%" BGCOLOR="#FFFFFF">2</TD>
  172. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  173. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the variable data.</TD>
  174. </TR>
  175. <TR>
  176. <TD WIDTH="8%" BGCOLOR="#FFFFFF">4</TD>
  177. <TD WIDTH="11%" BGCOLOR="#FFFFFF">1 byte</TD>
  178. <TD WIDTH="81%" BGCOLOR="#FFFFFF">variable type ID byte (see <A HREF="vars.html#vartypes">variable type ID's</A>)</TD>
  179. </TR>
  180. <TR>
  181. <TD WIDTH="8%" BGCOLOR="#FFFFFF">5</TD>
  182. <TD WIDTH="11%" BGCOLOR="#FFFFFF">8 bytes</TD>
  183. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Variable name, padded with NULL characters (0h) on the right.</TD>
  184. </TR>
  185. <TR>
  186. <TD WIDTH="8%" BGCOLOR="#FFFFFF">13 (Dh)</TD>
  187. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  188. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the variable data. (This is a copy of the value in offset 2)</TD>
  189. </TR>
  190. <TR>
  191. <TD WIDTH="8%" BGCOLOR="#FFFFFF">15 (Fh)</TD>
  192. <TD WIDTH="11%" BGCOLOR="#FFFFFF"><I>n</I> bytes</TD>
  193. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Variable data. <A HREF="vars.html">Click here</A> for variable data formats.</TD>
  194. </TR>
  195. </TABLE>
  196. <p></P>
  197. <P>
  198. <HR ALIGN="CENTER">
  199. <p></P>
  200. <H3>The TI-83 backup file format</H3>
  201. <P>Most link programs allow a user to download and save system backups with the extension &quot;.82b&quot;.</P>
  202. <P>Here is the format for backup files:</P>
  203. <P>
  204. <TABLE BORDER="1" CELLSPACING="0" WIDTH="92%">
  205. <TR>
  206. <TH WIDTH="15%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Offset</FONT></TH>
  207. <TH WIDTH="11%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Length</FONT></TH>
  208. <TH WIDTH="74%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Description</FONT></TH>
  209. </TR>
  210. <TR>
  211. <TD WIDTH="15%" BGCOLOR="#FFFFFF">0</TD>
  212. <TD WIDTH="11%" BGCOLOR="#FFFFFF">8 bytes</TD>
  213. <TD WIDTH="74%" BGCOLOR="#FFFFFF">8-character signature. The signature is
  214. always &quot;<TT>**TI83**</TT>&quot;.</TD>
  215. </TR>
  216. <TR>
  217. <TD WIDTH="15%" BGCOLOR="#FFFFFF">8</TD>
  218. <TD WIDTH="11%" BGCOLOR="#FFFFFF">3 bytes</TD>
  219. <TD WIDTH="74%" BGCOLOR="#FFFFFF">3-byte further signature. These three bytes
  220. always contain {1Ah, 0Ah, 00h} = {26, 10, 0}</TD>
  221. </TR>
  222. <TR>
  223. <TD WIDTH="15%" BGCOLOR="#FFFFFF">11 (Bh)</TD>
  224. <TD WIDTH="11%" BGCOLOR="#FFFFFF">42&nbsp;(2Ah)&nbsp;bytes</TD>
  225. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Comment. The comment is either zero-terminated
  226. or padded on the right with space characters.</TD>
  227. </TR>
  228. <TR>
  229. <TD WIDTH="15%" BGCOLOR="#FFFFFF">53 (35h)</TD>
  230. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  231. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Length, in bytes, of the backup header and
  232. the data sections. This number should be 17 (11h) bytes more than the sum
  233. of the lengths of the three data sections as reported in the backup header.</TD>
  234. </TR>
  235. <TR>
  236. <TD WIDTH="15%" BGCOLOR="#FFFFFF">55 (37h)</TD>
  237. <TD WIDTH="11%" BGCOLOR="#FFFFFF">11 bytes</TD>
  238. <TD WIDTH="74%" BGCOLOR="#FFFFFF">The backup header (format described below).</TD>
  239. </TR>
  240. <TR>
  241. <TD WIDTH="15%" BGCOLOR="#FFFFFF">66 (42h)</TD>
  242. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  243. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Length, in bytes, of the first data section</TD>
  244. </TR>
  245. <TR>
  246. <TD WIDTH="15%" BGCOLOR="#FFFFFF">68&nbsp;(44h)</TD>
  247. <TD WIDTH="11%" BGCOLOR="#FFFFFF"><I>x</I> bytes</TD>
  248. <TD WIDTH="74%" BGCOLOR="#FFFFFF">First data section.</TD>
  249. </TR>
  250. <TR>
  251. <TD WIDTH="15%" BGCOLOR="#EEEEEE">68 (44h)+<I>x</I></TD>
  252. <TD WIDTH="11%" BGCOLOR="#EEEEEE">2 bytes</TD>
  253. <TD WIDTH="74%" BGCOLOR="#EEEEEE">Length, in bytes, of the second data section</TD>
  254. </TR>
  255. <TR>
  256. <TD WIDTH="15%" BGCOLOR="#EEEEEE">70 (46h)+<I>x</I></TD>
  257. <TD WIDTH="11%" BGCOLOR="#EEEEEE"><I>y</I> bytes</TD>
  258. <TD WIDTH="74%" BGCOLOR="#EEEEEE">Second data section.</TD>
  259. </TR>
  260. <TR>
  261. <TD WIDTH="15%" BGCOLOR="#FFFFFF">70 (46h)+<I>x</I>+<I>y</I></TD>
  262. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  263. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Length, in bytes, of the third data section</TD>
  264. </TR>
  265. <TR>
  266. <TD WIDTH="15%" BGCOLOR="#FFFFFF">72 (48h)+<I>x</I>+<I>y</I></TD>
  267. <TD WIDTH="11%" BGCOLOR="#FFFFFF"><I>z</I> bytes</TD>
  268. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Third data section</TD>
  269. </TR>
  270. <TR>
  271. <TD WIDTH="15%" BGCOLOR="#FFFFFF">72 (48h)+<I>x</I>+<I>y</I>+<I>z</I></TD>
  272. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  273. <TD WIDTH="74%" BGCOLOR="#FFFFFF">Checksum. This is the lower 16 bits of the
  274. sum of all bytes in the backup header and data sections.</TD>
  275. </TR>
  276. </TABLE>
  277. <p></P>
  278. <P>The backup header has this format:</P>
  279. <P>
  280. <TABLE BORDER="1" CELLSPACING="0" WIDTH="92%">
  281. <TR>
  282. <TH WIDTH="8%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Offset</FONT></TH>
  283. <TH WIDTH="11%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Length</FONT></TH>
  284. <TH WIDTH="81%" BGCOLOR="#008800"><FONT COLOR="#FFFFFF">Description</FONT></TH>
  285. </TR>
  286. <TR>
  287. <TD WIDTH="8%" BGCOLOR="#FFFFFF">0</TD>
  288. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  289. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Offset to data length: Always has a value
  290. of 9.</TD>
  291. </TR>
  292. <TR>
  293. <TD WIDTH="8%" BGCOLOR="#FFFFFF">2</TD>
  294. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  295. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the first data section.</TD>
  296. </TR>
  297. <TR>
  298. <TD WIDTH="8%" BGCOLOR="#FFFFFF">4</TD>
  299. <TD WIDTH="11%" BGCOLOR="#FFFFFF">1&nbsp;byte</TD>
  300. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Type ID: Always has a value of 15 (Fh).</TD>
  301. </TR>
  302. <TR>
  303. <TD WIDTH="8%" BGCOLOR="#FFFFFF">5</TD>
  304. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  305. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the second data section.</TD>
  306. </TR>
  307. <TR>
  308. <TD WIDTH="8%" BGCOLOR="#FFFFFF">7</TD>
  309. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  310. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Length, in bytes, of the third data section.</TD>
  311. </TR>
  312. <TR>
  313. <TD WIDTH="8%" BGCOLOR="#FFFFFF">9</TD>
  314. <TD WIDTH="11%" BGCOLOR="#FFFFFF">2 bytes</TD>
  315. <TD WIDTH="81%" BGCOLOR="#FFFFFF">Memory address of the second data section</TD>
  316. </TR>
  317. </TABLE>
  318. <BR>
  319. <TABLE BORDER="0" CELLSPACING="0" WIDTH="100%">
  320. <TR>
  321. <TD WIDTH="32%">
  322. <P ALIGN="CENTER"><A HREF="vars.html"><IMG SRC="graphics/prevpage.gif" WIDTH="32" HEIGHT="32" ALIGN="BOTTOM" ALT="[previous page]"
  323. BORDER="2"><BR>
  324. Variable Formats</A>
  325. </TD>
  326. <TD WIDTH="34%">
  327. <P ALIGN="CENTER"><A HREF="index.html"><IMG SRC="graphics/home.gif" WIDTH="32" HEIGHT="32" ALIGN="BOTTOM" ALT="[home]"
  328. BORDER="2"><BR>
  329. Table of Contents</A>
  330. </TD>
  331. <TD WIDTH="34%">
  332. <P ALIGN="CENTER"><A HREF="tokens.html"><IMG SRC="graphics/nextpage.gif" WIDTH="32" HEIGHT="32" ALIGN="BOTTOM"
  333. ALT="[next page]" BORDER="2"><BR>
  334. Tokens and Characters</A>
  335. </TD>
  336. </TR>
  337. </TABLE>
  338. <HR ALIGN="CENTER">
  339. <I>Site maintained by Romain Li&eacute;vin (</I><A HREF="mailto:roms@lpg.ticalc.org"><I>roms@lpg.ticalc.org</I></A><I>)
  340. and Tim Singer (</I><A HREF="mailto:tsinger@gladstone.uoregon.edu"><I>tsinger@gladstone.uoregon.edu</I></A><I>)</I>
  341. </BODY>
  342. </HTML>