ExperimentalAmiga emulator in pure JavaScript and HTML5

• 
  Requirements
  
  
  
  • 
    A very fast computer
    
  • 
    A browser capable of HTML5 with:
    
    
    
    • 
      WegGL or Canvas 2D (optional)
      
    • 
      WebAudio (optional)
      
    • 
      FileReader (GUI)
      
    • 
      Typed arrays
      
    
    
    
  • 
    A ROM:
    
    
    
    • 
      Amiga Kickstart 1.0-2.05 (not included for copyright reasons)
      
    • 
      AROS Kickstart (included)
      
    
    
    
     
    
  • 
    And a bunch of ADF-files to test (optional)
    
  
  
  

Supported browsers



Chrome

Very fast



Firefox

Medium speed



Opera

Slow speed, no audio



IE

No support



Other

Untested

• 
  Goals
  
  
  
  • 
    Make Amiga Classic Emulation available for browsers.
    
  • 
    Easy integration into websites.
    
  • 
    API for control from background, useful e.g. for a demo-player.
    
  • 
    Browsers-plugins should not be required, just HTML5 and javascript.
    
  
  
  

• 
  Possible usage
  
  
  
  • 
    Demo/Intro/Mod-player
    
  • 
    Playing games
    
  • 
    Browser benchmark
    
  
  
  

• 
  Usage/Hints
  
  
  
  • 
    Press F11 for fullscreen. Most browsers support that.
    
  • 
    If something does crash, try another memory setting or a different ROM.
    The original kickstart (1.3) does work best.
    
  
  
  

• 
  Known bugs/problems
  
  
  
  • 
    Blinking sprites are not shown if "Frameskip" is active.
    
  • 
    There may be short and heavy speed-fluctuations in the beginning of the emulation.
    
  • 
    Left/right shift/alt/ctrl are the same. That's a browser "feature" and can't be fixed.
    
  
  
  

• 
  Written and ported by
  
  
  
  • 
    Rupert Hausberger <rupert_hausberger@gmx.net> (donate)
    
  
  
  

• 
  Source-code
  
  
  
  • 
    github.com/naTmeg/ScriptedAmigaEmulator
    
  
  
  

• 
  Thanks
  
  
  
  • 
    Bernd Schmidt
    
  • 
    WinUAE team
    
  • 
    AROS team
    
  
  
  

• 
  License
  
  
  
  • 
    This is a free project.
    
  • 
    You may use the emulator in your own website.
    
  • 
    If you use the emulator in your own website, you must provide a link to this homepage.
    
  • 
    If you use the emulator in your own website, you must not change the copyright header in the source-files.
    
  • 
    Commercial use in any form is prohibited. This includes donations.
    
  • 
    No warranty expressed or implied. Use at your own risk.
    
  
  
  

• 
  History
  
  
  
  • 
    0.8.0 (16.01.2013):
    
    
    
    • 
      Display
      
      
      
      • 
        Ported and optimized playfield-code from WinUAE.
        This adds ECS and AGA support and fixes graphics-errors.
        The AGA part is commented out, because there is no 68020 yet.
        
      • 
        Added support for drawing via 'Canvas 2D' if 'WebGL' is not avail.
        
      • 
        Added support for auto-driver detection.
        
      
      
      
    • 
      Audio
      
      
      
      • 
        While disk access, audio performance is much better now.
        
      • 
        Added support for the A500 lowpass-filter. Not enabled by default.
        
      • 
        Added support for auto-driver detection.
        
      
      
      
    • 
      Memory
      
      
      
      • 
        To gain speed, all memory is now accessed directly and not via functions.
        So, don't care for a possible illegal memory access.
        
      • 
        Fixed bug, where kickstart 1.2 failed to load.
        
      • 
        Fixed incorrect extended-address bug.
        
      
      
      
    • 
      CPU
      
      
      
      • 
        Splitted address-types of ADDQ/SUBQ into separate functions for more speed.
        
      • 
        Added bus-read/write cycles tables. For internal use only.
        
      
      
      
    • 
      CIA
      
      
      
      • 
        I decided to port the latest cia-code from WinUAE while i was trying to find a bug.
        Well, the bug is still there. Let's keep the code nevertheless.
        
      
      
      
    • 
      GUI
      
      
      
      • 
        Added info box of supported drivers.
        
      • 
        Added a 'Chipset'-section and various options.
        
      • 
        Packed the main GUI.
        
      
      
      
    • 
      Common
      
      
      
      • 
        Added support for easy URL sharing. E.g. to show the Multica-demo to a friend,
        one may send the link "http://scriptedamigaemulator.net/#Multica"
        and the demo will start immediately. (thanks mrdoob)
        
      • 
        Many small optimizations.
        
      
      
      
    
    
    
     
    
  • 
    0.7.0 (24.12.2012):
    
    
    
    • 
      Common
      
      
      
      • 
        Chaned the project-name from 'Janus' to 'SAE' (Scripted Amiga Emulator).
        This step is necessary because i did'nt enough research before the initial release.
        There is already a project with that name in it. (janus-uae) I'm sorry for that, that was kinda stupid
        
      • 
        Separated the GUI form the core and rewrote most of it.
        
      • 
        Simplified the whole code. This means, that functions are called faster.
        
      • 
        Ported new Copper-, Blitter-, Audio-, Disk- and event-handling code from WinUAE 2.5.0
        
      • 
        Moved all "beam-functions" to events.js, for faster access.
        
      • 
        Added "CPU-usage" to the GUI.
        
      • 
        Added "Hall of Fame".
        
      
      
      
    • 
      CPU
      
      
      
      • 
        Added support for exact cycling. The CPU have now 7.09 MHz on PAL and 7.16 MHz on NTSC resp.
        
      • 
        Added option for "Original"- and "Maximum"-speed.
        
      
      
      
    • 
      Audio
      
      
      
      • 
        Added a ring-buffer before output. No more "bagpipe"-like audio.
        
      • 
        Added a option to just emulate the hardware, but not to play any sound,
        e.g. "Agony" was not starting, if audio was disabled.
        
      
      
      
    • 
      Display
      
      
      
      • 
        Switched from the RGB to the 565 texture-format-encoding in WebGL, which gives a little more speed.
        
      • 
        Added support and a option for 4x scaling.
        
      • 
        Fixed screen-draging in lo-/hires-modes.
        
      • 
        Added a option to disable the output. Can be used to better play music-demos.
        
      
      
      
    • 
      Disk
      
      
      
      • 
        Added support for different speed-modes.
        
      • 
        Added support for extended ADF-files.
        
      • 
        Enabled write support. (to memory)
        
      
      
      
    • 
      Input
      
      
      
      • 
        The F-keys does work normaly now, i.e F5 does'nt reload the emulator, backspace does'nt go to the last page, etc...
        
      • 
        Fixed bug in the joystick-emulation.
        
      
      
      
    
    
    
     
    
  • 
    0.6.1 (05.11.2012):
    
    
    
    • 
      CPU
      
      
      
      • 
        Added missing TAS command. ('Wings of Death' game does use it)
        
      
      
      
    • 
      ROM
      
      
      
      • 
        Added a crc32-checksum test after download. (AROS)
        
      • 
        Changed transfer-mode from syncronous to asyncronous. (AROS)
        
      
      
      
    • 
      Display
      
      
      
      • 
        Optimized the line-drawing code of the blitter.
        
      • 
        Fixed decision whether the resulting image is scaled or not. ('Agony' game)
        
      • 
        Disabled 'Framedrop' in interlace-mode.
        
      
      
      
    • 
      Misc
      
      
      
      • 
        Fixed HTML5 doctype.
        
      • 
        Added ver/rev to the title.
        
      • 
        Changed revision to 3 digits.
        
      
      
      
    
    
    
     
    
  • 
    0.6 (25.10.2012):
    
    
    
    • 
      ROM
      
      
      
      • 
        Added support for extended-roms.
        
      • 
        AROS kickstart replacement is now the default-rom, and will be downloaded and used on the fly.
        
      
      
      
    • 
      RAM
      
      
      
      • 
        Changed internal memory alignment from 8 to 16 bit.
        
      • 
        Added fast-ram support, through a emulated Commodore A2058 in Zorro2-mode.
        
      • 
        Removed the D8DC-memory-option from the GUI. This memory space is now always allocated.
        
      • 
        Sorted access of the memory-routines by priority.
        
      
      
      
    • 
      CPU
      
      
      
      • 
        Fixed sign-extension for memory to address-register transfers in MOVEM.
        
      • 
        Fixed sign-extension for absolute-word addresses in exEA.
        
      • 
        Fixed wrong address when writing a byte to the stack in ldEA.
        
      • 
        Fixed 32bit calculations for address-regsiters in ADDQ/SUBQ.
        
      • 
        Fixed remainder calculation in DIVU.
        
      • 
        Optimized integer-arithmetic functions. Size depending calcalations are now used.
        
      • 
        Improved exception 2/3 handling.
        
      • 
        More small cleanups not listed here.
        
      
      
      
    • 
      Disk
      
      
      
      • 
        Ported latest disk-code from WinUAE. Disk-based problems should be gone now, e.g. floopy shown as BAD or read errors.
        
      • 
        Diskchange does now work.
        
      • 
        Drives can be disabled now.
        
      • 
        DD/HD types are now supported.
        
      
      
      
    • 
      Display
      
      
      
      • 
        Added missing support for HAM6.
        
      • 
        Fixed horizontal and vertical screen-centering.
        
      • 
        Fixed screen-draging, almost, read the "Known bugs" section.
        
      • 
        Added better screen-scrolling.
        
      
      
      
    • 
      Input
      
      
      
      • 
        Fixed key-mapping to the amiga key-layout, at least in Chrome. Firefox does not like "öäü", it seems.
        
      • 
        Added support for individual configurations of joystick-movement and fire-buttons.
        
      • 
        Fixed bug, that made the fire 1 button on joystick 0 not working.
        
      • 
        Fixed bug in the mouse-movement function, that calculates the wrong coordinates in some cases.
        
      
      
      
    • 
      GUI
      
      
      
      • 
        Added eject-button in the disk-change requester.
        
      • 
        Removed the CPU and OCS/ECS options. They are useless so far.
        
      • 
        The "Pause" and "Resume" buttons are once now.
        
      • 
        Made some options to only apear when selected.
        
      • 
        Did some cosmetics.
        
      
      
      
    • 
      Misc
      
      
      
      • 
        Added support for Zorro2-expansion cards.
        
      • 
        Added a more precise event-handling. This makes the audio-output a little smoother.
        
      • 
        Changed the ratio of CPU-/Chipset-time from 1:8 to 1:4
        
      • 
        Fixed a bug in the RTC. "Year" is now calculated correctly.
        
      • 
        Fixed incorrect response of serial.device. Now crashed programms does reset (and show the guru), instead of idle.
        
      • 
        Any output on the serial.device is now redirected to the debug-log. (dev only)
        
      • 
        Kickstart/Workbench 2.04 and AROS does now work.
        
      • 
        Overall about 10-30% more speed, as long as the blitter is not used too much.
        
      
      
      
    
    
    
     
    
  • 
    0.5 (01.09.2012):
    
    
    
    • 
      Initial.