git.sesse.net Git - pistorm/blob - platforms/amiga/pistorm-dev/pistorm_dev_amiga/README.md

   1 # PiStorm Interaction Tool
   2
   3 ## Cross-Compiling
   4
   5 Compiling the tool requires VBCC setup with the kickstart 1.3 libraries. For information on how to set this up in Linux please see https://linuxjedi.co.uk/2021/02/27/using-vbcc-as-an-amiga-cross-compiler-in-linux/
   6
   7 Once you have the tooling setup, just run `make`.
   8
   9 ## Installation
  10
  11 You will need `reqtools.library` in the `libs:` drive. Some Workbench builds come with this. If you don't have it use the version in libs13 for Workbench 1.3 and libs20 for Workbench 2.0 onwards.
  12
  13 ## Tools
  14
  15 ### PiSimple
  16
  17 PiSimple is a command line tool to interact with PiStorm. Running it without any parameters will give you detailed usage information for the tool.
  18
  19 ### PiStorm
  20
  21 The PiStorm tool is a GUI tool that implements the same interaction API as the command line tool. It is compatible with Workbench 1.3 onwards.
  22
  23 #### RTG
  24
  25 You can enable / disable RTG on-the-fly with the "Enable/Disable RTG" button. This will have a status next to it which indicates the current state of the RTG.
  26
  27 ### Config file
  28
  29 It is possible to switch the configuration file PiStorm is using. You can either type a name for the config file relative to the PiStorm's execution directory and hit "Commit" or hit "Load Default". If the config file is valid the PiStorm will load it in and the Amiga will immediately reboot.
  30
  31 ### Get file
  32
  33 You can copy a file from the PiStorm to the Amiga. First of all, type in the filename and path relative to the pistorm directory. Then optionally set the destination directory (can be left blank for the same directory PiStorm was executed in) and hit "Retrieve".
  34
  35 ### Reboot
  36
  37 Reboots the Amiga (not PiStorm).