X-Git-Url: https://mograsim.net/gitweb/?a=blobdiff_plain;f=docs%2Fgetting_started.md;h=aa4df892bb5173f74b04eb63bd44264d1c33774a;hb=73011f36b64c89be5d57768611fd63c53bc32a61;hp=f8ee36ac94b58dd32d8430ce1873874050abbca3;hpb=39a9cc869cbf3e1c7fc3a61ea6552d5d078e1d66;p=Mograsim.git diff --git a/docs/getting_started.md b/docs/getting_started.md index f8ee36ac..aa4df892 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -3,16 +3,22 @@ ## Prerequisites - [Java](http://jdk.java.net/) 11 or later (or [Oracle Implementation](https://www.oracle.com/technetwork/java/javase/downloads/index.html)) -- [Eclipse](https://www.eclipse.org/downloads/) 2019-03 or later (TODO: do earlier versions work?) +- [Eclipse](https://www.eclipse.org/downloads/) 2019-03 or later (Open question: do earlier versions work?) ## Install Mograsim +### Via the Eclipse Marketplace +1. Start Eclipse. +2. Go to "Help" -> "Eclipse Marketplace...". +3. Search for "Mograsim" +4. Click on "Install" and follow the instructions. + +### Manually via an updatesite 1. Start Eclipse. 2. Go to "Help" -> "Install New Software...". 3. Add the Mograsim update site: 1. Click on "Add...". - 2. Next to "Location:", enter the update site address. -Note: Currently, there is no online update site for Mograsim. You have to build Mograsim yourself as described in [Building Mograsim](building_mograsim.md). + 2. Next to "Location:", enter the update site address. Currently, this is https://mograsim.net/updatesite/. This address could, however, change in the future. 3. Click on "Add". 1. Tick "Mograsim". 2. Click on "Next >" two times, read and accept the license, and click on "Finish". @@ -21,19 +27,23 @@ Note: Currently, there is no online update site for Mograsim. You have to build ## Enable the Launch action set -1. Go to "Window" -> "Perspective" -> "Customize Perspective...". -2. Go to the tab "Action Set Availability". -3. Under "Available action sets", enable "Launch" (if it is not already enabled); click on "Apply and Close". +1. Go to "Window" -> "Perspective" -> "Open Perspective" + and select "Mograsim" or click "Other..." and then select Mograsim.
+ This can also be done by the perspective switcher on the right. ## Create a new Mograsim project -1. Create a new Eclipse project. (Go to "File" -> "New" -> "Project...", select "General" -> "Project".) -2. Add the Mograsim nature to the new project and set it up: - 1. Open the properties dialog of the new project. (Right-click on it, select Properties.) - 2. Go to the "Project Natures" page, click on "Add...". If a confirmation dialog pops up, confirm. - 3. Select "Mograsim Project Nature"; click on "OK". - 4. Click on "Apply and Close" and re-open the properties dialog. - 5. Go to the new "Mograsim" page, select "Am2900Simple", click on "Apply and Close". +1. Create a new Mograsim project. (Go to "File" -> "New" -> "Project...", select "Mograsim" -> "Mograsim + Project".) +2. Give it a project name and a Mograsim machine and finish. + +Alternatively, you can create a general Project and add the Mograsim nature to the new project and set it up: + +1. Open the properties dialog of the new project. (Right-click on it, select Properties.) +2. Go to the "Project Natures" page, click on "Add...". If a confirmation dialog pops up, confirm. +3. Select "Mograsim Project Nature"; click on "OK". +4. Click on "Apply and Close" and re-open the properties dialog. +5. Go to the new "Mograsim" page, select "Am2900Teaching", click on "Apply and Close". ## Write a MPM file (containing the microprogram) @@ -86,7 +96,7 @@ The MPM can be modified by this line. This is not recommended, however, because ### Memory view -1. In the Memory view, click on the green +, enter 0 and click on "OK". +1. Select the preferred numerical representation 2. Right-click on the table -> "Format...". 3. Select 16 units per row and one unit per column. (8 units per row if 16 don't fit on the screen.) @@ -94,7 +104,7 @@ The table now displays the contents of the currently running machine. At this mo ### Register view -1. Expand the pseudo register group. +1. Expand the register group you would like to view. It should contain the registers R0-R15 as well as the Q register. All of them should be 0, displayed as a bitstring @@ -130,4 +140,4 @@ Slowly increase the simulation speed until the wires in the Simulation view star - If nothing Mograsim-related seems to be installed after installing Mograsim, make sure Eclipse uses Java 11 or later. 1. Go to "Help" -> "About Eclipse IDE", click on "Installation Details", go to the tab "Configuration". 2. Search the line starting with "java.version=". (This line is in the "System properties" block, which usually occupies the first 200 lines.) -3. If this line specifies a version less than 11, configure your Eclipse installation to use a Java 11 JRE (or later). See https://wiki.eclipse.org/FAQ_How_do_I_run_Eclipse%3F#Find_the_JVM. \ No newline at end of file +3. If this line specifies a version less than 11, configure your Eclipse installation to use a Java 11 JRE (or later). See https://wiki.eclipse.org/FAQ_How_do_I_run_Eclipse%3F#Find_the_JVM.