| Download Link | Version | Size | Upload Date |
|---|---|---|---|
| MIPSym_Win_Installer.exe | v2.05.1520 | 36.89M | 2021-05-26 |
| All releases | |||
This is the Windows version of MIPSym, a simulator for the MIPS R2000/R3000 processor.
Please run the program MIPSym_x.xx.xxxx_Installer.exe. This will install the program and an uninstaller at C:\Program Files (x86)\MIPSym2 by default.
The installer includes a checkbox option to associate .asm files with MIPSym.
After you begin using the program, it will store some settings data at: C:\Users\%username%\AppData\Roaming\MIPSym\prefs.json
Please note that MIPSym is a university research project, and it has not been signed by Microsoft. Windows will warn you of this fact the first time you run it. Your antivirus software may flag the installer as 'suspicious', because it has not been signed, and because the installer can modify Windows registry files if you allow it to associate .asm files with MIPSym.
After installation, there will be two shortcuts in your Start Menu, under a folder labelled MIPSym2. The MIPSym shortcut will run the GUI version of MIPSym; the MIPSymCLI shortcut will launch a Windows terminal with an environment set up to make it easier to run MIPSym from the command line. See the MIPSym documentation for more details.
Please see the bug tracker for a list of known issues with MIPSym. If you discover new issues, please submit them there.
In your install directory, you will find a file called MIPSasmNotepad++.xml. To enable MIPS highlighting, open Notepad++ and click 'Language > Define your language...' From here, click on 'Import'. Navigate to your install directory, select the file MIPSasmNotepad++.xml, and click the 'Open' button. Notepad++ should automatically highlight every .asm file as MIPS assembly; if it does not, you will be able to click 'Language > MIPSasm' to highlight a file manually.
This language definition file is developed and supported by the developers of MIPSym.
Open the Command Palette (Ctrl-Shift-P, or 'Tools > Command Palette...'), select 'Package Control: Install Package', and choose 'MIPS Syntax'. This package is documented at https://packagecontrol.io/packages/MIPS%20Syntax.
The authors of MIPSym claim no ownership or endorsement of this package; they simply note that SublimeText is a popular multiplatform text editor that has an easily accessible MIPS syntax package.
Click 'View > Extensions', and search for 'MIPS'. Several MIPS syntax highlighters are available in the Marketplace.
MIPSym was built using the Qt GUI framework. https://www.qt.io/. MIPSym uses the open source font Deja Vu Sans Mono, copyright Bitstream Vera Fonts. It is freely available for distribution at https://dejavu-fonts.github.io/. A copy of the license is available in your install directory at DejaVuSansMono_LICENSE.
| Download Link | Version | Size | Upload Date |
|---|---|---|---|
| MIPSym_Mac-x86_64.dmg | v2.05.1520 | 19.64M | 2021-05-26 |
| All releases | |||
This is the Mac version of MIPSym, a simulator for the MIPS R2000/R3000 processor.
Please download the MIPSym_x.xx.xxxx.dmg file and open it. You will find the MIPSym application inside. To install, drag the application to your Applications folder on the right. Drag the example_code directory to your Documents folder. You will be able to build the example code once it has been copied to your hard disk, but you cannot build it directly from the mounted .dmg file (it's a read-only dmg).
After you begin using the program, it will store some settings data at: /Users/$USER/Library/Application Support/MIPSym/prefs.json
Please note that the application has not been signed by Apple, which means that OSX may complain when you try to run it. To convince OSX to run the program, right click on MIPSym, click on 'Open', and then click on 'OK'. The next time you need to run MIPSym, you will be able to double-click on it.
Please see the bug tracker for a list of known issues with MIPSym. If you discover new issues, please submit them there.
Open the Command Palette (Ctrl-Shift-P, or 'Tools > Command Palette...'), select 'Package Control: Install Package', and choose 'MIPS Syntax'. This package is documented at https://packagecontrol.io/packages/MIPS%20Syntax.
The authors of MIPSym claim no ownership or endorsement of this package; they simply note that SublimeText is a popular multiplatform text editor that has an easily accessible MIPS syntax package.
Click 'View > Extensions', and search for 'MIPS'. Several different MIPS syntax highlighters are available in the Marketplace.
MIPSym was built using the Qt GUI framework. https://www.qt.io/. MIPSym uses the open source font Deja Vu Sans Mono, copyright Bitstream Vera Fonts. It is freely available for distribution at https://dejavu-fonts.github.io/. A copy of the license is available in the .dmg archive at DejaVuSansMono_LICENSE.
| Download Link | Version | Size | Upload Date |
|---|---|---|---|
| MIPSym_Linux-x86_64.tar.gz | v2.05.1520 | 40.04M | 2021-05-26 |
| All releases | |||
This is the Linux version of MIPSym, a simulator for the MIPS R2000/R3000 processor.
MIPSym is intended to be run on any currently-maintained Linux distribution. If your Linux distribution has reached end-of-life and is not receiving new updates, you should not expect that MIPSym will run on your system.
MIPSym is tested on the following distributions. If your distribution is derived from an older version of these, or not related in any way to these distributions, the developers of MIPSym cannot be certain that it will run on your system.
If your Linux distribution is not derived from any of the distributions on the list above, or is older than the versions listed here, you may still be able to get MIPSym to run if you can install the following shared objects.
libstdc++.so.6: Unless your OS is very old, you will have this installed by default. The easiest way to install this is to use your package manager to install g++ version 5.3 or greater. You can see which version of g++ you have installed with this command:
$ g++ --version
libcrypt.so.1.1 and libssl.so.1.1: MIPSym expects that OpenSSL version 1.1 or greater is installed. Unless your OS is very old, you will have OpenSSL 1.1 installed by default. You can see which version of OpenSSL you have installed with this command:
$ openssl version
If this command reports an earlier version of OpenSSL, you will most likely need to build OpenSSL from source; see https://wiki.openssl.org/index.php/Compilation_and_Installation for details.
When MIPSym starts up, it uses OpenSSL to check if there are new versions of MIPSym available. If you don't have a compatible OpenSSL installed, MIPSym will print some error messages to stderr and fail to check for new versions. Everything else should still work properly. Note that you can turn off the check for new versions with the --private command line flag, or by unchecking the 'Settings > Check for new version on launch' menu item.
There is no official installation process. Simply download the MIPSym_x.xx.xxxx.tar.gz archive, extract it, and run the MIPSym-x86_64.AppImage file contained inside. You are free to move this file to any location you wish, and it should run without any problems. The other files in the MIPSym_x.xx.xxxx directory may be useful to you, but the AppImage does not require them to run.
You can find out more about AppImages at https://docs.appimage.org.
You can integrate AppImages into your desktop by using appimaged or AppImageLauncher, as described in the AppImage docs.
Alternately, you can try using the MIPSym.desktop file to make the program available from desktop menus:
MIPSym.desktop in a text editor and modify the line Exec=MIPSym-x86_64.AppImage. You will need to insert the absolute path to the folder that contains MIPSym-x86_64.AppImage.MIPSym.desktop to the /usr/share/applications directory. To make it available only to yourself, move it to ~/.local/share/applications. This approach works with GNOME and other freedesktop.org-compliant desktops, and is documented in more detail at developer.gnome.org.
Please see the bug tracker for a list of known issues with MIPSym. If you discover new issues, please submit them there.
If you are unable to open MIPSym at all, your system may be unable to open AppImages. If you suspect that this is the problem, you can look into it at the AppImage docs. It may be helpful to install the fuse package from your package manager, but it is unlikely that you do not already have it installed.
The MIPSym AppImage compresses a large directory structure into a single file. You will be able to work with the contents of the AppImage more easily by extracting them. You can accomplish this with:
$ MIPSym-x86_64.AppImage --appimage-extract
This will place a directory called squashfs-root in the current working directory. The MIPSym executable is at squashfs-root/usr/bin/MIPSym, and the assembler is at squashfs-root/usr/asm/assembler. You can run both of these from a terminal, and if they fail to run, you should see some explanatory error messages.
If you are running MIPSym on a distribution on which it has not been tested, you may run into errors when your dynamic linker is unable to find shared objects required by MIPSym or the assembler.
The most common dynamic linker problem that the developers have seen is a failure to link libstdc++.so.6. This object was left out of the AppImage to conserve disk space. This shared object can be installed by installing g++-5 or newer using your package manager.
You can run ldd to see the full list of what shared objects these programs need in order to run:
$ ldd ./squashfs-root/usr/bin/MIPSym # show objects required by MIPSym
$ ldd ./squashfs-root/usr/asm/MIPSymAssembler # show objects required by assembler
Many, but not all, of these shared objects are packaged in the AppImage at squashfs-root/usr/lib. Any shared objects that are not included are expected to be installed on your system. They are installed in the supported Linux distributions by default.
If ldd cannot find a shared object that MIPSym needs to run, it will print a line that looks like some_library.so -> ???, and MIPSym will fail to start up. If you are seeing output like this, and your Linux distribution is up-to-date, please let the developers know via the bug tracker!
When you build an assembly program, MIPSym should be able to find the assembler on its own, but it will prompt you for a location if it cannot. You can also set the assembler path manually by clicking 'Settings > Set Assembler Path'.
If you are having trouble getting the assembler to run, make sure to click on 'View > Messages'; this display may give you some idea of what's going wrong.
If all else fails, you can run the assembler from a terminal, after extracting the AppImage (described above). The syntax is:
$ MIPSymAssembler AsmProgram.asm
MIPSym saves some preferences to a json file at ~/.local/share/MIPSym.AppImage; you may wish to edit this file if you are having trouble.
As of 2018, Ubuntu's package manager offers the Windows version of Notepad++, wrapped in the WINE compatibility layer. As a result, it should be compatible with our existing Windows Notepad++ plugin.
In the MIPSym_x.xx.xxxx.tar.gz archive, you will find a file called MIPSasmNotepad++.xml. To enable MIPS highlighting, open Notepad++ and click 'Language > Define your language...'. From here, click on 'Import'. Select the file MIPSasmNotepad++.xml, and click the 'Open' button. Notepad++ should automatically highlight every .asm file as MIPS assembly; if it does not, you will be able to click 'Language > MIPSasm' to highlight a file manually.
This language definition file is developed and supported by the developers of MIPSym.
Open the Command Palette (Ctrl-Shift-P, or 'Tools > Command Palette...'), select 'Package Control: Install Package', and choose 'MIPS Syntax'. This package is documented at https://packagecontrol.io/packages/MIPS%20Syntax.
The authors of MIPSym claim no ownership or endorsement of this package; they simply note that SublimeText is a popular multiplatform text editor that has an easily accessible MIPS syntax package.
Click 'View > Extensions', and search for 'MIPS'. Several different MIPS syntax highlighters are available in the Marketplace.
MIPSym was built using the Qt GUI framework. https://www.qt.io/. MIPSym uses the open source font Deja Vu Sans Mono, copyright Bitstream Vera Fonts. It is freely available for distribution at https://dejavu-fonts.github.io/. A copy of the license is available in your install directory at DejaVuSansMono_LICENSE.