Installation

The Sphinx distribution consists of three directories: sphinx0, sphinx1, and sphinx2.

• • sphinx0 contains files that you compile on your PC.

  • sphinx1 contains the core Sphinx system.

  • sphinx2 contains the source code for Sphinx.

The following installation instructions also serve as an introductory tutorial to Sphinx. Please read and follow them carefully.

Part 1

• 1. Open sphinx0\sphinx.spin in the Propeller Tool (or equivalent).

  2. Edit the clock settings and pin assignments at the top of the file to match your Propeller system.

  3. Compile and save to your Propeller's EEPROM (press F11 in PropTool).

Part 2

• 1. Insert an SD card into your PC. If necessary, format it as FAT16 with clusters at least 32k bytes in size. If you are running Windows, you can format the card by opening a command prompt and entering the following command (change f: as appropriate):

  2. format f: /fs:fat /a:32k

  3. Copy the contents of the sphinx1 directory to the SD card. There should be two dozen or so files in the root directory of the SD card.

  4. If you are interested in compiling Sphinx with Sphinx, copy the contents of the sphinx2 directory to the SD card. This step is optional.

  5. Move the SD card to your Propeller.

Part 3

• 1. Boot up your Propeller. On the screen you should see something like this:

  2. ============ Sphinx xxxxxx ============

  3. video @ pin 24

  4. keyboard @ pin 13

  5. SD @ pin 16

  6. >_

  7. The underscore is the cursor.

  8. Now it's time to build the editor. Most of the editor's sub-objects are already compiled, but you have to compile a couple of files to get some practice. Enter the following commands:

  9. c tvtexted (this will compile the editor's video driver)

  10. cl ed (this compiles and links the editor, producing the file ed.bin)

  11. Now use the program you just built to edit a simple Spin program:

  12. ed hello1.spn

  13. Note that source files end with ".spn" (Sphinx only supports short (8.3) filenames).

  14. Ed is a simple full-screen editor. Use the arrow keys to move the cursor. Edit the clock settings and video pin as appropriate for your Propeller and change "<your name>" to your name.

  15. Hit control-Q to quit. Ed will give you the choice to save the file as hello1.spn. Hit Enter to save your changes.

  16. Enter the following commands:

  17. cl hello1

  18. run hello1

  19. The run command effectively performs a reset before running hello1. You should see a blue screen with your name on it. After a couple of seconds your Propeller will reboot back to Sphinx.

Part 4

• 1. Edit hello2.spn, changing "<your name>" to your name, and save. hello2 is "Sphinx-aware" and uses Sphinx I/O.

  2. Compile and link hello2 using the following commands:

  3. c hello2

  4. link hello2

  5. Here we compiled and linked in two steps. If you ever mistype c when you meant cl, don't panic—you can always run the linker separately as you did here.

  6. Run hello2 by simply entering its name (do not use the run command):

  7. hello2

  8. Note that the output from hello2 appears on the Sphinx screen and the Sphinx prompt appears immediately after hello2 terminates.

Part 5

• 1. Compile and link the rest of the utility programs.

  2. cl cogcheck

  3. cl copy

  4. cl del

  5. cl dir

  6. cl echo

1. Try running the utilities by entering their names at the command prompt. These are Sphinx-aware programs like hello2, so do not use the run command.

Part 6 (optional)

At this point you already have a functional Sphinx system. This next section is completely optional. It shows you how to build Sphinx with Sphinx.

• 1. Copy the contents of the sphinx2 directory to the SD card if you did not do so in Part 2.

  2. Enter the following commands to build codegen.bin:

  3. c stringx

  4. c bintree

  5. c kwdefs

  6. c isxfs

  7. c tokenrdr

  8. c symbols

  9. c eval

  10. c methods (this will take about 40 seconds)

  11. c sxfile

  12. c isxtv

  13. cl codegen (this is another big one)

  14. Enter the following commands to build lex.bin and link.bin:

  15. c fltmath

  16. c fltstr

  17. c keywords

  18. c tokenizr

  19. cl lex

  20. cl link

  21. Enter the following commands to build sphinx.bin:

  22. c sxkb

  23. c sxtv

  24. c sxsdspiq

  25. c sxfs2

  26. c sxfs

  27. cl sphinx

Next: Documentation