Skip to content
This repository
Home.md
... ... @@ -3,20 +3,61 @@
3 3 Visual Studio 2010 based IDE for creating programs for vingate 8-bit computers.
4 4
5 5 Supported platforms:
6   -* Commodore 64
7   -* Commodore VIC 20
8   -* Atari 8-bit
  6 +
  7 +* Commodore 64
  8 +* Commodore VIC 20
  9 +* Atari 8-bit
9 10
10 11 Support for 6502/6510 based platforms can be added without modifying sources (requires some hacking though).
11 12
12 13 ## Set up
13 14
14   -Requirements
15   -- Visual Studio 2010 Professional edition (or higher)
16   -- Compiler:
17   - - 64tass compiler - manual and link to download here: http://singularcrew.hu/64tass/
18   -- Emulator:
19   - - Commodore 64 / VIC-20 Vice emulator - http://www.viceteam.org/ Hint: make sure you download the "Binary for MS-Windows" and NOT the "SDL based binary for Ms-Windows" - Atari 8-bit Atari800Win emulator - http://atariarea.krap.pl/PLus/index_us.htm Setup instructions - http://www.myatari.co.uk/issues/jun2002/emulate.htm Hint: If you see "BOOT ERROR" in the Atari emulator some settings are probably screwed up (e.g. you have spaces in the path but the path is not enclosed in quotes (")) you need to fix the problem and then start the emulator and detach all disks (File -> Disks -> Detach All (Alt + 0)), and try again.
20   - •It is useful to add paths to the compiler and emulator(s) to your %PATH%. (for non-administrator accounts here is how to do that: http://superuser.com/questions/165909/how-can-i-set-user-environmental-variables-such-as-path-from-a-non-administrato). If you don't you will have to set full paths to the compiler and the emulator in the project settings for each new proejct. Otherwise it should work pretty much "out of the box".
21   -
  15 +Requirements:
  16 +
  17 +* Visual Studio 2010 Professional edition (or higher)
  18 +* Compiler
  19 +64tass compiler - manual and link to download here: http://singularcrew.hu/64tass/
  20 +* Emulator
  21 +**Commodore 64 / VIC-20**
  22 +Vice emulator - http://www.viceteam.org/
  23 +HINT: make sure you download the "Binary for MS-Windows" and NOT the "SDL based binary for Ms-Windows"
  24 +**Atari 8-bit**
  25 +Atari800Win emulator - http://atariarea.krap.pl/PLus/index_us.htm
  26 +Setup instructions - http://www.myatari.co.uk/issues/jun2002/emulate.htm
  27 +HINT: If you see "BOOT ERROR" in the Atari emulator some settings are probably screwed up (e.g. you have spaces in the path but the path is not enclosed in quotes (")) you need to fix the problem and then start the emulator and detach all disks (File -> Disks -> Detach All (Alt + 0)), and try again.
  28 +
  29 +It is useful to add paths to the compiler and emulator(s) to your %PATH%. (for non-administrator accounts here is how to do that: http://superuser.com/questions/165909/how-can-i-set-user-environmental-variables-such-as-path-from-a-non-administrato). If you don't you will have to set full paths to the compiler and the emulator in the project settings for each new proejct. Otherwise it should work pretty much "out of the box".
  30 +
  31 +## Extensions Installation
  32 +Download extensions from the [Downloads](https://github.com/moozzyk/VintageStudio/downloads) page, double click *.vsix files and follow instructions.
  33 +
  34 +## How To Use
  35 +
  36 +### Creating New Projects
  37 +
  38 +* File->New->Project (Ctrl+Shift+N)
  39 +* Open "Vintage Studio" in Installed Templates
  40 +* Select plaftorm
  41 +* Enter name of the project
  42 +* Press OK
  43 +
  44 +### Building
  45 +* Build->Build Solution (F6 or Ctrl+Shift+B)
  46 +If the path to the compiler is set correctly it should build without errors. Compiler output is written to the Output window.
  47 +
  48 +### Running
  49 +* Debug->Start Without Debugging (Ctrl+F5)
  50 +If the path to the emulator is set correctly the emulator will open and the program will run in the emulator.
  51 +
  52 +### Debugging (only in Vice)
  53 +* Debug->Start Debugging
  54 +If the path to the emulator is set correctly the emulator will open in the debug mode and break on the first instruction of the program
  55 +
22 56 Hint: If you change the start address of the program (at the moment it is $1000) you may need to set it in the settings as well to be able to debug your program in Vice. Atari800Win does not support starting in debug mode
  57 +
  58 +### Settings
  59 +* Right click the project node in the solution explorer and select Properties (Alt+Enter)
  60 +
  61 +## Unistalling extensions
  62 +* Tools->Extension Manager...
  63 +* Disable/Uninstall extension
23 64 \ No newline at end of file
Something went wrong with that request. Please try again.