/vscode-amiga-blitzbasic

Primary LanguageJavaScriptMIT LicenseMIT

Amiga Blitz Basic 2 Language Support - Javascript Native Edition

This extension adds language support for the Amiga version of Blitz Basic 2 (and Amiblitz). The extension is in alpha state so syntax highlighting is still limited. Big thanks to Youen Chéné who has made a lot of improvements to this extension!

TL;DR

!! NEW KEY BINDING !!

To open and run your current blitz basic 2 program on UAE use the shortcut Ctrl-F6 (Win, Linux) or Cmd-F6(Mac).

To open all your current folder blitz basic 2 files (.bba) program on UAE use the shortcut Ctrl-F7 (Win, Linux) or Cmd-F7(Mac).

To open all your current folder blitz basic 2 files AND to run your current blitz basic 2 program on UAE use the shortcut Ctrl-F8 (Win, Linux) or Cmd-F8(Mac).

Run on real Amiga is deactivated (need the proper serial cable to test it).

Note

This version now includes the native javascript improvements by Youen Chéné: https://github.com/youenchene/vscode-amiga-blitzbasic so no external tools are needed now, except for UAE of course.

Compatibility

All OS support VSCode and UAE(or a real Amiga).

Getting Started

  1. Please process to the requirements to setup your UAE and Amiga OS.

  2. Add a file with the extension .bba (Blitz Basic Ascii), it's where you will write your Blitz Basic code.

  3. Code enjoy the inline help and snippets.

  4. Have your UAE and Amiga OS open.

  5. When you do the shortcut to run on UAE (command - F5), it will :

    • write a copy of your file with the extension .bb2 (so TED don't mess up your original .bba file),
    • copy all necessary files for Amiga OS,
    • launch AREXX script to launch TED/Blitz Basic 2 and then compile and run automatically your code.
    • sometimes it failed, just retry the shortcut, sometimes you need to reboot your Amiga OS.

  6. Enjoy coding in Blitz Basic 2 in a modern way!

Features

  • Syntax highlighting.
  • Snippets for most Blitz Basic 2 functions and methods.
  • Outline shows macros, labels, functions and statements.
  • Integrated help.

contextual help

  • Commands for running the app/game in WinUAE or FSUAE. (ony requires blitzbasic2.rexx and amiga os config in command line tools, see below).

compil and run into UAE

  • Commands for running the app/game on a real Amiga (requires command line tools, see below).
  • Settings to tune the integration to your UAE :

Extension Settings

  • Outline View and Go to Symbol (Cmd/Ctrl + Shift + O) integration.

Outline

GoToSymbol

Requirements

You only need to configure your UAE and Amiga OS :

  1. Ensure that AREXX is started with WorkBench. The line:
    SYS:System/RexxMast >NIL:

should exist in either S/startup-sequence or S/user-startup. If not, add it to the end of user-startup.

  1. In WinUae set serial port to TCP://0.0.0.0:1234 and select "Direct" below the drop down box (Settings / Host / IO ports). Save the WinUAE configuration and quit WinUAE, add the following to the configuration file manually (under the other lines concerning serial): serial_translate=crlf_cr

    (NOTE: You need to ensure that your firewall/antivirus allows network traffic for WinUAE.)

  2. Create the file DEVS:MountList on the virtual harddrive with the following content (if it does not already exist)

   AUX:
   Handler = L:Aux-Handler
   Stacksize = 1000
   Priority = 5
  1. Add the following commands to the end of S:user-startup
   mount aux:
   newshell aux:
  1. Add virtual hard disk pointing to the folders containing your code

This is the same folder that you added to your Visual Studio Code workspace.

By default, the folder is named SharedCode so the virtual harddrive can be called as SharedCode: in Amiga OS.

  1. Of Course Amiga OS (3.x) with Blitz Basic 2 installed.

Known Issues

Syntax highlighting is still very limited.

Run to Amiga is not implemented and tested yet in this version.

Random couldn't open file error on Ted/Blitz2.

Release Notes

0.6.0

  • Blitz Basic 2 Label, NewType, Statement, Function and Macro are now showing up in the Outline view and Go to Symbol..

0.5.0

  • New keybindings

0.4.0

  • Manage projet with multiple .bba files and includes.

0.3.3

  • Save document on run UAE.

0.3.2

  • Documentation

0.3.0

  • Extension Settings: shared folder volume name in AmigaOS.
  • Extension Settings: UAE serial port for direct connection.
  • blitzbasic2.rexx and BB2NagAway integrated in extension and copied automatically in AmigaOS.

0.2.0

  • Integrated help documentation (Hover Mode) - No external tool dependencies.
  • Launch bb2 compilation through arexx using native javascript - No external tool dependencies.

0.1.0

  • Initial alpha release