___________________________________________ / Sandpaper v1.0 /\ / by Christopher "Kerm Martian" Mitchell / / / http://www.cemetech.net / / / August 2011 - June 2013 / / /__________________________________________/ / \__________________________________________\/ / / / / Table of Contents / / / I. Introduction / / / II. Installation / / / III. Browsing ticalc.org / / / IV. Problems? / / / V. More Info / / /__________________________/ / \__________________________\/ --------------------------------------------------------===-- I. Introducing Sandpaper: A CALCnet FTP Client/Server --------------------------------------------------------===-- Sandpaper is an FTP client and server for TI-83+/84+ graphing calculators. It uses the CALCnet 2.2 networking protocol to communicate and the Doors CS 7 GUI system for display. It can be used to transfer files between two directly-connected calculators, between many calculators across a large network, between calculators connected via globalCALCnet (gCn), and can even be used to download files from the file archives of ticalc.org and Cemetech via gCn. Sandpaper provides the following abbreviated list of features: = Use your calculator as an FTP client or server = Fetch files from other calculators = Send files to other calculators = Use the native Doors CS 6+ folder system for easy navigation = Support programs, appvars, groups, lists, matrices, GDBs, strings, and picture variables = Store programs to RAM or Archive = Get programs from RAM or Archive - no unarchiving necessary = Robust failure recovery will protect your calculator from crashes if disconnected during transfer, insufficient space, or other problems occur. = Use of the DCS GUI allows for an attractive interface while maintaining small program size. = Can use globalCALCnet (gCn) to connect directly to archives like ticalc.org and fetch files --------------------------------------------------------===-- II. Installing Sandpaper, Connecting and Transferring --------------------------------------------------------===-- Requirements: = TI-83+, TI-83+SE, TI-84+, or TI-84+SE graphing calculator (OS 1.13 or higher or OS 2.41 or higher) = 7KB free RAM or Archive = Doors CS 7.1.1 or later (DCS 7.2 Beta 3 or higher recommended) = (Optional) Arduino-based globalCALCnet (gCn) bridge or direct miniUSB cable with computer-side gCnClient executable. Recommended Emulator Testing Setup: = PindurTI (http://sgate.emt.bme.hu/patai/pindurti/) = Two or more TI-83+ ROMs loaded onto two to four of the LCDs = The link icon selected for all connected calculators Doors CS 7 is required for CALCnet and the GUI system. You can use the included DoorsCS7.8xk or download Doors CS 7 from: http://dcs.cemetech.net Send prgmSANDPAPR to your calculator. You can run Sandpaper via Doors CS's HomeRun feature, or run SANDPAPR from the Doors CS desktop. When you start up Sandpaper, you will be presented with several main areas of the screen: +---------- Connect/Disconnect | +------- About | | +---- Disconnect & Quit v v v +========================================+ | Sandpaper [o][?][X]| +===================+====================+ | Local Fldr Top | Remote Fldr Top | +===================+====================+ | ^ | ^ | | | | | | | | | | | Local fldrs/files | Remote fldrs/files | | | | | | | | | | | V | V | +===================+====================+ Click the Connect/Disconnect icon to connect to another calc. You can choose what calculator to connect to, if several are on the network, then the target calculator will pop up a window where its owner can allow the connection or reject it. If you are connected to globalCALCnet, you may see the ticalc.org and/or Cemetech archives as possible peers to connect to. When you are connected, the local filesystem is on the left side of the screen, and the remote filesystem is on the right side. Click a local or remote folder to go into that folder, or the "Top" icon to return to the main folder list. The main list includes pseudo-folders of all the types that Sandpaper can list, send, and receive. To send a file to the "slave" (remote) calculator, click it in the local view (the left pane), and then choose whether to send it to the RAM or Archive of the slave. To get a file from the remote slave to the local master, click the file in the remote view (the right pane), and choose whether to store it into the local calculator's RAM or Archive. If an error occurs, including missed data, insufficient space to store the file on the local or remote device, an invalid file type, or some other problem, an error message is displayed and any pending transfers are aborted. You can disconnect by clicking the broken chain icon (the left- most of the three window buttons at the top-right of the screen). You can disconnect and quit Sandpaper by clicking the X icon or holding the [CLEAR] button. If the calculator appears stuck or hung because of a failed transfer or disconnected cable, simply hold [CLEAR] to force it to exit. --------------------------------------------------------===-- III. Browsing the ticalc.org and Cemetech file archives --------------------------------------------------------===-- Using globalCALCnet (gCn), Sandpaper can directly download programs, lists, appvars, pictures, and other variables from files on ticalc.org and Cemetech. Currently, the ticalc.org archives are live and available to be used. Using the gCnClient program, connect to hub "FTPHub", then launch Sandpaper on your calculator and connect to target "ticalc". You will be able to browse the entirety of the /pub/83plus/ directory, dive into zip files, view readme files, and download any file type that Sandpaper supports. Be sure that you have the filter driver installed if you're trying to use Direct USB gCn, otherwise gCn will not work. --------------------------------------------------------===-- IV. Troubleshooting --------------------------------------------------------===-- Q: Sandpaper seems to be frozen! A: Not to worry, just hold [CLEAR] to quit safely. Q: Why does a folder say #ERROR## instead of its name? A: Somehow the folder got archived; DCS folders are not supposed to be archived. You should be able to unarchive it at the Doors CS desktop. Q: A cryptic error message appears when I try to send or receive a file. A: I haven't gotten to more detailed errors yet. This means one of the following: 1. The receiving calculator doesn't have enough memory 2. The filetype you tried to send can't be sent properly yet (currently only programs are supported) 3. The file you tried to send already exists on the receiving calculator. Q: Send to Archive doesn't seem to be working. A: You need TI-83+ OS 1.13 or higher. OS 1.12 has bugs. --------------------------------------------------------===-- V. More Information --------------------------------------------------------===-- If you need help with Sandpaper, your first reference should be this README. If it does not answer your question, then stop by the Cemetech forum, and the Cemetech community will be happy to answer intelligent questions. Bug reports and feature requests are also welcome: http://www.cemetech.net/forum Questions about Doors CS can also be directed to the forum. You can chat with Cemetech's SAX chat widget directly from the website or from channel #cemetech on IRC network irc.efnet.net. As a last resort, you may email me: sandpaper@cemetech.net (c) 2011-2013 Christopher Mitchell