Recent changes to Home

Home modified by Nima Alamatsaz

Nima Alamatsaz — Thu, 15 May 2014 14:51:39 -0000

--- v7
+++ v8
@@ -2,7 +2,7 @@

 What is BASM?
 -------------
-BASM is a user friendly and easy to use assembler for Mano's Basic Computer, capable of creating the object, list and hex file and giving detailed error reports. It's more of academic use for students who wish to understand how does Mano's Basic Computer actually work. Alongside this assembler, soon a simulator will also be available at BASM's SourceForge page.
+BASM is a user friendly and easy to use assembler for The Basic Computer, capable of creating the object, list and hex file and giving detailed error reports. It's more of academic use for students who wish to understand how does The Basic Computer actually work. Alongside this assembler, soon a simulator will also be available at BASM's SourceForge page.

 How to use?
 -----------

Home modified by Nima Alamatsaz

Nima Alamatsaz — Wed, 14 May 2014 16:18:24 -0000

--- v6
+++ v7
@@ -84,6 +84,3 @@
 Ask questions, report bugs and give suggestions here:
     http://sf.net/p/basm/discussion
     http://sf.net/p/basm/tickets
-
-Feel free to email me about anything:
-    nnalamat+sf@gmail.com

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Wed, 01 Feb 2012 20:52:15 -0000

--- v5 
+++ v6 
@@ -13,7 +13,7 @@
 

 The output will be written to files 'test.obj', 'test.lst' and 'test.hex', respective to their source file name. You may want to change them:
 
-    $ basm test.asm -o objectfile.obj -l listfile.lst
+    $ basm test.asm -o objectfile.obj -l listfile.lst -h hexfile.hex
 
 

 Follow these links and see how to add a location to the 'PATH':

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Wed, 01 Feb 2012 20:51:13 -0000

--- v4 
+++ v5 
@@ -1,19 +1,17 @@
-
 Welcome to BASM wiki!
 
 What is BASM?
 -------------
-BASM is a user friendly and easy to use assembler for Mano's Basic Computer, capable of creating the object and list file and giving detailed error reports. It's more of academic use for students who wish to understand how does Mano's Basic Computer actually work. Alongside this assembler, soon a simulator will also be available at BASM's SourceForge page.
+BASM is a user friendly and easy to use assembler for Mano's Basic Computer, capable of creating the object, list and hex file and giving detailed error reports. It's more of academic use for students who wish to understand how does Mano's Basic Computer actually work. Alongside this assembler, soon a simulator will also be available at BASM's SourceForge page.
 
 How to use?
 -----------
-It is much more preferable to add BASM's binary folder location to 'PATH' environment variable for both MS Windows and Linux users. You can also copy the binary into a folder that is already added to 'PATH', like 'C:\Windows\' or '/bin/'. Then simply open a terminal and type:
+It is much more preferable to add BASM's 'bin' folder location to 'PATH' environment variable for both MS Windows and Linux users. You can also do it the easy way by copying the executable into a folder that is already added to 'PATH', like 'C:\Windows\' or '/bin/' (Windows users should also copy two .dll files). Then simply open a terminal and type:
 
     $ basm test.asm
 
 

-The output will be written to files 'test.obj' and 'test.lst', respective to
-their source file name. You may want to change them:
+The output will be written to files 'test.obj', 'test.lst' and 'test.hex', respective to their source file name. You may want to change them:
 
     $ basm test.asm -o objectfile.obj -l listfile.lst

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Fri, 20 Jan 2012 21:01:27 -0000

--- v3 
+++ v4 
@@ -1,43 +1,91 @@
-Summary
--------
+
 Welcome to BASM wiki!
-Started as a course project, BASM aims at creating a user friendly and easy to use assembler for Mano's Basic Computer. The project is still in its early stages, as version 1.0 is only capable of creating the object and list file. More features like advanced error handling, detailed list file and FPGA compatible output generation are to be added soon.
-
-Instruction List
+
+What is BASM?
+-------------
+BASM is a user friendly and easy to use assembler for Mano's Basic Computer, capable of creating the object and list file and giving detailed error reports. It's more of academic use for students who wish to understand how does Mano's Basic Computer actually work. Alongside this assembler, soon a simulator will also be available at BASM's SourceForge page.
+
+How to use?
+-----------
+It is much more preferable to add BASM's binary folder location to 'PATH' environment variable for both MS Windows and Linux users. You can also copy the binary into a folder that is already added to 'PATH', like 'C:\Windows\' or '/bin/'. Then simply open a terminal and type:
+
+    $ basm test.asm
+
+

+The output will be written to files 'test.obj' and 'test.lst', respective to
+their source file name. You may want to change them:
+
+    $ basm test.asm -o objectfile.obj -l listfile.lst
+
+

+Follow these links and see how to add a location to the 'PATH': 
+http://windows7hacker.com/index.php/2010/05/how-to-addedit-environment-variables-in-windows-7/
+http://linuxheadquarters.com/howto/basic/path.shtml
+
+How to compile from source?
+---------------------------
+MS Windows users can open 'basm.sln' under 'prj\vs10' with Visual Studio 2010
+or later (either the express or full version), and simply compile the solution.
+The executable binary output will be saved as 'bin\basm.exe'.
+Under linux, if you have g++ (GNU C++ Compiler), just run 'compile.sh' script:
+
+    $ ./compile.sh
+
+

+In case something went wrong, change the script's permissions:
+
+    $ chmod 755 compile.sh
+
+

+Then try running it again. The binary output will be saved as 'bin/basm'.
+
+Instruction Set
 ----------------
 Instruction        | Description
 -------------------|------------
 MRI         | 
-AND X              | and MEM[X] with AC and store the result in AC
-ADD X              | add MEM[X] to AC and store the result in AC
-LDA X              | copy MEM[X] into AC
-STA X              | copy AC into MEM[X]
-BUN X              | jump to X unconditionally ( PC <- X )
-BSA X              | save current PC in MEM[X] and jump to X+1 unconditionally ( MEM[X] <- PC, PC <- X+1 )
-ISZ X              | increase MEM[X] by one, and skip the next instruction if MEM[X] equals zero
+AND X              | and MEM\[X\] with AC and store the result in AC
+ADD X              | add MEM\[X\] to AC and store the result in AC
+LDA X              | copy MEM\[X\] into AC
+STA X              | copy AC into MEM\[X\]
+BUN X              | jump to X unconditionally ( PC ← X )
+BSA X              | save current PC in MEM\[X\] and jump to X+1 unconditionally ( MEM\[X\] ← PC, PC ← X+1 )
+ISZ X              | increase MEM\[X\] by one, and skip the next instruction if MEM\[X\] equals zero
 Non MRI     |
 CLA                | clear AC                                                          
 CLE                | clear E flag
 CMA                | complement AC
 CME                | complement E flag
 CIR                | circular shift AC to right
 CIL                | circular shift AC to left
 INC                | increase AC by one
 SPA                | skip next line if AC is positive
 SNA                | skip next line if AC is negative
 SZA                | skip next line if AC equals zero
 SZE                | skip next line if E flag equals zero
 HLT                | halt execution of the program
 I/O         | 
 INP                | read the input register (INPR) and store it in the lower 8 bit of AC
 OUT                | write the lower 8 bit of AC to output register (OUTR)
 SKI                | skip next line if input flag (I) is set
 SKO                | skip next line if output flag (O) is set
 ION                | set the interrupt flag (R)
 IOF                | clear the interrupt flag (R)                               
 Pseudo      |
 ORG N              | sets the next line's address to N                                  
 END                | indicates the end of program
 DEC N              | interpreting N as a decimal data, assembler stores it in the memory
 HEX N              | interpreting N as a hexadecimal data, assembler stores it in the memory
 BIN N              | interpreting N as a binary data, assembler stores it in the memory
+
+Web and contact
+---------------
+Visit BASM's page at SourceForge:
+    http://sf.net/p/basm
+
+Ask questions, report bugs and give suggestions here:
+    http://sf.net/p/basm/discussion
+    http://sf.net/p/basm/tickets
+
+Feel free to email me about anything:
+    nnalamat+sf@gmail.com

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Mon, 02 Jan 2012 21:17:02 -0000

--- v2 
+++ v3 
@@ -1,7 +1,7 @@
 Summary
 -------
 Welcome to BASM wiki!
-Started as a course project, BASM aims at creating a user friendly and easy to use assembler for Mano's basic computer. The project is still in its early stages, as version 1.0 is only capable of creating the object file. More features like list file and FPGA compatible output generation are to be added soon.
+Started as a course project, BASM aims at creating a user friendly and easy to use assembler for Mano's Basic Computer. The project is still in its early stages, as version 1.0 is only capable of creating the object and list file. More features like advanced error handling, detailed list file and FPGA compatible output generation are to be added soon.
 
 Instruction List
 ----------------

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Fri, 30 Dec 2011 20:39:22 -0000

--- v1 
+++ v2 
@@ -1,7 +1,7 @@
 Summary
 -------
 Welcome to BASM wiki!
-Started as a course project, BASM aims on creating a user friendly and easy to use assembler for Mano's basic computer. The project is still in its early stages, as version 1.0 is only capable of creating the object file. More features like list file and FPGA compatible output generation are to be added soon.
+Started as a course project, BASM aims at creating a user friendly and easy to use assembler for Mano's basic computer. The project is still in its early stages, as version 1.0 is only capable of creating the object file. More features like list file and FPGA compatible output generation are to be added soon.
 
 Instruction List
 ----------------

WikiPage Home modified by Nima Alamatsaz

Nima Alamatsaz — Fri, 30 Dec 2011 08:50:32 -0000

Summary ------- Welcome to BASM wiki! Started as a course project, BASM aims on creating a user friendly and easy to use assembler for Mano's basic computer. The project is still in its early stages, as version 1.0 is only capable of creating the object file. More features like list file and FPGA compatible output generation are to be added soon. Instruction List ---------------- Instruction | Description -------------------|------------ MRI | AND X | and MEM[X] with AC and store the result in AC ADD X | add MEM[X] to AC and store the result in AC LDA X | copy MEM[X] into AC STA X | copy AC into MEM[X] BUN X | jump to X unconditionally ( PC <- X ) BSA X | save current PC in MEM[X] and jump to X+1 unconditionally ( MEM[X] <- PC, PC <- X+1 ) ISZ X | increase MEM[X] by one, and skip the next instruction if MEM[X] equals zero Non MRI | CLA | clear AC CLE | clear E flag CMA | complement AC CME | complement E flag CIR | circular shift AC to right CIL | circular shift AC to left INC | increase AC by one SPA | skip next line if AC is positive SNA | skip next line if AC is negative SZA | skip next line if AC equals zero SZE | skip next line if E flag equals zero HLT | halt execution of the program I/O | INP | read the input register (INPR) and store it in the lower 8 bit of AC OUT | write the lower 8 bit of AC to output register (OUTR) SKI | skip next line if input flag (I) is set SKO | skip next line if output flag (O) is set ION | set the interrupt flag (R) IOF | clear the interrupt flag (R) Pseudo | ORG N | sets the next line's address to N END | indicates the end of program DEC N | interpreting N as a decimal data, assembler stores it in the memory HEX N | interpreting N as a hexadecimal data, assembler stores it in the memory BIN N | interpreting N as a binary data, assembler stores it in the memory