Skip to content

v2.6.0

Compare
Choose a tag to compare
@PropGit PropGit released this 09 Dec 00:11
· 11 commits to master since this release
cb7eb4a

Supports P1 (P8X32A) and P2 (P2X8C4M64P Rev B & C)

IMPORTANT: If you have v2.4+ installed, see the "upgrading" instructions below.

See Debugging Tips below if this is your first time using v2.5 or later.

Enhancements

  • Includes P2 Compiler released 10/13/2021 which brings some of the features noted below
  • Adds Spin2 floating point support (except syntax highlighting; coming next release); operators include "+.", "-.", "*.", "/.", and more
  • Adds Sprite support (in Debug Plot window)
  • Reorganized and enhanced Help menu links
  • Compiler-related items:
    • First 16 LUT registers freed for streamer "imm->LUT" usage.
    • DEBUG_WINDOWS_OFF symbol added.
    • Added DEBUG_BAUD and DOWNLOAD_BAUD (See "...Changes" video above).
    • Main symbol table increased from 64KB to 256KB, others from 4KB to 32KB

Fixes

  • Exceptions due to floating point errors in DEBUG Displays
  • Line clipping works now
  • Fixed REPEAT-var so that var = last value after loop

Upgrading From v2.4+

The current installer will not update your existing Documents\Propeller Tool folder (where Propeller Libraries, examples, and perhaps your projects-in-progress). To get the additional libraries included with v2.5.2, perform the following steps:

  1. Install v2.5.2
  2. Close Propeller Tool v2.5.2 (if running after install)
  3. Use Windows Explorer to navigate to your Documents folder
  4. Rename the Propeller Tool folder (or any subfolder within it that you want to be replaced/updated) to preserve the original
  5. Run Propeller Tool v2.5.2; it will rebuild your Documents\Propeller Tool* folder(s) and include new libraries
  6. You may wish to copy your projects from your renamed/archive folder back into the new Propeller Tool folder
    A future version will make this more automatic.

Debugging Tips

This version of Propeller Tool supports P2 debugging. Here are some tips for use.

  • In Propeller Tool, Debug (for P2) is a mode that is toggled on or off (at user's will) and affects all further P2-compiled code accordingly
  • Use the Run > Enable DEBUG menu item (or press the shortcut key CTRL+D) to toggle Debug Mode on/off, then compile and download
    • Look at the yellow message on the status bar to realize the new debug mode
  • Upon download of debug-enabled code, debug displays will automatically appear and receive information from the running P2 code
  • Close the main Debug window (or press the ESC key with the main Debug window focused or the Editor focused) to close all debug displays and automatically close the serial port
  • While debugging, you can adjust your code and download again (without closing debug displays)
  • Try out and study the examples in Documents\Propeller Tool\Examples (see "Upgrading" instructions below, if necessary)

Known Issues

  • [WARNING] Object Info only partially supports P2 (currently). Application components, hex view, and save binary/flash supported. Does not yet support P2 clock metrics or Open binary/eeprom/flash.
  • [WARNING] Archive feature is not supported for P2 (currently).

Future Plans

  • Add Spin 2 syntax scheme selection and editing (via Preferences)
  • Finish Object Info (View Info function) window to fully support P2 objects
  • Add graphic button toolbar
  • Add deeper auto-detection of source type (Spin1/Spin2)
  • Address various customer requests
  • Various fixes and enhancements for internal verifications and optimizations
  • Add fast-loading protocol for P1 (currently in use by SimpleIDE, PropGCC, and BlocklyProp)
  • Address internal questions and code cleanup tasks