You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Language support for DOS assembly,may be suitable for studying MASM/TASM and the course <*principles& peripheral technology of microprocessor*>.
6
6
@@ -9,50 +9,50 @@ Language support for DOS assembly,may be suitable for studying MASM/TASM and the
9
9
- In **Editor Menu**: run and debug assembly with right click on the VSCode editor panel
10
10
-**Diagnose**: process the output of ASM tools and display them in VSCode
11
11
-**For windows**, all needed tools have been packaged in the extension.Just install and enjoy!
12
-
-[For other systems](#for-linux): you need to install DOSBox first
12
+
-[For other systems](#for-linux): you need to install [DOSBox](https://www.dosbox.com) first
13
13
14
14
Thanks to [Roncho](https://marketplace.visualstudio.com/publishers/Roncho) 's extension [Assembly (TASM)](https://marketplace.visualstudio.com/items?itemName=Roncho.assembly-8086),[blindtiger](https://github.com/9176324)'s [masm](https://github.com/9176324/bltg-team.masm) and [Woodykaixa](https://github.com/Woodykaixa)'s [masm-code](https://github.com/Woodykaixa/masm-code). Welcome [issue](https://github.com/xsro/masm-tasm/issues) and PR to build a better extension with your help.
15
15
16
16
## Features
17
17
18
18
when you are editing `assembly` files ,you can right click at the editor panel,then you will see several choices listed below:
19
19
20
-
1."Open dosbox": Open the dosbox, prepare the environment(copy file to dosbox's D:\ and add tools to path)
21
-
2."Run ASM code": Compile and Run the program
22
-
3."Debug ASM code": Compile and Debug the program
20
+
1.**Open dosbox**: Open the dosbox, prepare the environment(copy file to dosbox's D:\ and add tools to path)
21
+
2.**Run ASM code**: Assemble,link and Run the program
22
+
3.**Debug ASM code**: Assemble,link and Debug the program
23
23
24
24
## Demo
25
25
26
26
### Demo 1: Run and Debug Assembly
27
27
28
-
| using TASM via DOSBox | using MASM via msdos-player|
When opened a ASM file in Editor, Right click on the Editor, then run or debug the code. Default mode is using `DOSBox` and `TASM`, you can change it in `preference->settings` like the second gif(using MASM via msdos-palyer).
32
+
When opened a ASM file in Editor, Right click on the Editor, then run or debug the code. Default mode is using `DOSBox` and `TASM`, you can change them in `preference->settings` like the second gif(using MASM via msdos-palyer).
||[](https://github.com/dpisdaniel/assembly-pacman)|
||[](https://github.com/dpisdaniel/assembly-pacman)|
47
47
48
-
- some ASM commands you may need: [ASM_commands](https://github.com/xsro/masm-tasm/blob/master/doc/ASM_commands.md).
49
-
- Some interesting assembly codes you may need: [DOSBox ASM codes](https://github.com/xsro/masm-tasm/wiki/dosbox)
50
48
- Command "`Open DOSBox`": Your file will be copied as `D:\T.ASM` in DOSBox. (The extension will copy your file to work space and mount this space to DOSbox disk `D:`)
51
-
- Command "`Doxbox here`": The extension will mount your active editor's file to dosbox's disk `E:` and will not copy your file
49
+
- Command "`Doxbox here`": The extension will mount your active editor file's folder directly to dosbox's disk `E:`.
50
+
- some ASM commands you may need: [ASM_commands](https://github.com/xsro/masm-tasm/wiki/ASM_commands).
51
+
- Some interesting assembly codes you may need: [DOSBox ASM codes](https://github.com/xsro/masm-tasm/wiki/dosbox)
52
52
53
53
## For linux
54
54
55
-
The extension is packaged with all needed [tools](#about-tools) inside,but some of these tools are for windows.So **Linux and other OS** users *should* make sure DOSBox can be opened by shell command `dosbox` (node: child_process.exec("dosbox")). Use command like
55
+
The extension is packaged with all needed [tools](#about-tools) inside,but some of these tools are for windows.So **Linux and other OS** users *should* make sure DOSBox can be opened by shell command `dosbox` (node: child_process.exec("dosbox")). Use command like
56
56
57
57
```sh
58
58
sudo apt install dosbox #install dosbox
@@ -63,23 +63,23 @@ dosbox #if successfully opened the dosbox, it is largely possible for the extens
63
63
64
64
for more,please see the `preference->settings`
65
65
66
-
-`masmtasm.ASM.MASMorTASM` use `MASM` or `TASM` assembler in DOS emulator to run and debug assembly
67
-
-`masmtasm.ASM.emulator` use dosbox or msdos-player as DOS emulator,defalut is DOSBox
66
+
-`masmtasm.ASM.MASMorTASM` use *MASM* or *TASM* assembler in DOS emulator to run and debug assembly
67
+
-`masmtasm.ASM.emulator` use dosbox or msdos-player as DOS emulator
68
68
-`DOSBox` (default) more stable
69
69
-`msdos-player`quiet, it runs in command prompt(CMD). So it cannot support GUI like `TD.exe`
70
-
-`auto`(recommand)auto select
70
+
-`auto` auto select
71
71
1. use msdos-player to compile and link
72
72
2. use DOSBox to run
73
73
3. use msdos-player for MASM(debug)
74
74
4. use DOSBox for TASM(TD)
75
75
-`masmtasm.ASM.savefirst` save file first before using
76
-
-`masmtasm.ASM.toolspath` custom path of your ASM tools. [more info](#about-tools)
76
+
-`masmtasm.dosbox.run`：what to do after run your code in DOSBox
77
77
-`masmtasm.dosbox.CustomResolution`: size(resolution) of the dosbox window,for example `1024x960`
78
+
-`masmtasm.ASM.toolspath` custom path of your ASM tools. [more info](#about-tools)
78
79
79
80
### About Tools
80
81
81
-
The assembler MASM and TASM can only run in 16-bit environment. So the extension use DOSBox and MSDOS-player to emulate the 16-bit environment.
82
-
the extension has built in tools for windows. But if you need to use assembler or emulator of different version. You can oragnize your tools follow the structure bellow and add your folder's path to `masmtasm.ASM.toolspath`
82
+
the extension has built in tools for windows. But if you need to use assembler or emulator of different version. You can organize your tools following the structure bellow and add your folder's path to `masmtasm.ASM.toolspath`, see [more info](https://github.com/xsro/masm-tasm/blob/main/doc/Toolspath.md)
83
83
84
84
- tools:your tools folder name, you can add the path of it to settings `masmtasm.ASM.toolspath`
85
85
1.`TASM`: TASM tools including `tasm.exe`,`tlink.exe`,`td.exe`
@@ -101,9 +101,8 @@ The extension will mount some folder to DOSBox 's disk. Please don't modify them
101
101
102
102
## Docs & Thanks & Licenses
103
103
104
-
- This extension is [MIT license](https://github.com/xsro/masm-tasm/blob/master/LICENSE).
104
+
- This extension is [MIT license](https://github.com/xsro/masm-tasm/blob/main/LICENSE).
105
105
- Thanks for [Roncho](https://marketplace.visualstudio.com/publishers/Roncho)'s [Assembly (TASM)](https://marketplace.visualstudio.com/items?itemName=Roncho.assembly-8086),[Woodykaixa](https://github.com/Woodykaixa)'s [masm-code](https://github.com/Woodykaixa/masm-code),[blindtiger](https://github.com/9176324)'s [masm](https://github.com/9176324/bltg-team.masm),[msdos player](http://takeda-toshiya.my.coocan.jp/msdos),[dosbox](https://www.dosbox.com)
106
-
-[about the assembly and emulator tools](https://github.com/xsro/masm-tasm/blob/master/doc/Toolspath.md)
0 commit comments