BASIC Script Tools

Basic Editor

Recommended: Sublime Text

Sublime Text is a cross-platform editor, which has special features that are useful for BASIC editing. Namely, if the script and samlib.bas are open in separate tabs in the same window, Option/Command/Down Arrow will jump to the definition in samlib.bas and Ctrl - (control hyphen) will jump back to the call in the main script.

To configure syntax highlighting, install the Basic package:

Mac OS X Installation

• Press Option key and select Go/Library from Finder menu
• Navigate to Application Support/Sublime Text 3/Packages/User
• Drag "Basic" folder into this directory
• Select from language menu in lower right of Sublime window for the relevant mission:
  • User/SAM Basic
  • User/MAVEN Basic

Windows Installation

• Download either the 32 or the 64 bit Windows version
• Run the executable file to install Sublime
• Relocate the contents of the "Basic" folder into: 'C:\Users\UserName\AppData\Roaming\Sublime Text 2\Packages\User'
• From the drop down menus: View>Syntax>User> SAM or MAVEN

Syntax Checker (basicyy)

Any modifications to Basic scripts should be validated using command line tool, basicyy.

Mac OS X Installation

Tested on Mac OS 10.6, 10.7, and 10.8

• Download the app package: basicyy.app
• Move basicyy.app into your /Applications directory
• Edit the .bash_profile file in your home directory to add a new alias:

alias basicyy="/Applications/basicyy.app/Contents/MacOS/basicyy --sam"

Omit the --sam flag if you write scripts for other missions.

In lieu of a mission flag, you may set the DEFAULT_MISSION environmental variable.

• Edit the .699config.INI file to have a script_lib_dir or script_lib_file keyword. For example:

script_lib_dir = /Users/micah/ops/eeprom_effective/80_samlib
script_lib_file = /Users/micah/maven/mavlib_rev555.bas

The default is to look for the Basic library in the ScriptsCDH directory inside the gse path defined in .699config.INI.