amishell

    1.0.0 • Public • Published

    AmiShell

    A shell for the WinUAE and FS-UAE Amiga emulators. If you are into retro crossdev, you can use this to ease the "test the created executable in the emulator" part, among other purposes.

    Installation

    To install from npm:

    npm i -g amishell
    

    To install from a local package:

    npm i -g amishell-1.0.0.tgz
    

    To verify that the command is correctly installed:

    amishell --help
    

    To uninstall the package:

    npm un -g amishell
    

    Setup

    The Amiga emulator needs to be properly configured for communication through a virtual serial port.

    FS-UAE

    Include the following property in your .fs-uae configuration file:

    serial_port = tcp://0.0.0.0:1234
    

    WinUAE

    Include the following lines in your .uae configuration file:

    win32.serial_port=TCP://0.0.0.0:1234
    serial_translate=crlf_cr
    serial_direct=true
    

    User-Startup

    Add the following lines to your Amiga S:User-Startup file:

    mount AUX:
    newshell AUX:
    

    You will need to have the AUX mountlist in the DEVS:DosDrivers directory.

    You may want to rename the AUX mountlist as AUXI under Windows if you have any problems with that particular name.

    Serial Preferences

    Execute the Prefs:Serial (2.0+) or Prefs:Preferences (1.3) program in your Amiga hard drive and set the serial preferences to these values:

    • Baud Rate: 31250
    • Input Buffer Size: 512
    • Handshaking: XON/XOFF
    • Parity: None
    • Bits/Char: 8
    • Stop Bits: 1

    Usage

    1. Open your properly-configured Amiga emulator of choice.
    2. Open a Terminal or Command Prompt window in the host machine.
    3. To execute a single command (like dir) in the emulator and exit:
    amishell dir
    
    1. To start an interactive shell session:
    amishell
    
    1. Use Up/Down arrows for command history.
    2. Use Ctrl+C to exit.

    License

    MIT Licensed. Copyright (c) Xeleh 2020.

    Credits

    Install

    npm i amishell

    Homepage

    xeleh.com

    DownloadsWeekly Downloads

    4

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    15.2 kB

    Total Files

    9

    Last publish

    Collaborators

    • xeleh