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.