tag:blogger.com,1999:blog-20052393107854889172023-08-09T03:35:32.402-07:00EduMIPS64 development blogThe EduMIPS64 development blogAndreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.comBlogger10125tag:blogger.com,1999:blog-2005239310785488917.post-59668594728708855982016-06-21T16:00:00.000-07:002016-06-21T16:55:16.648-07:00Towards a JavaScript port of EduMIPS64<h3>
10 years ago</h3>
The original goal of EduMIPS64 was running from every (student) computer, across different operating systems, by installing as few dependencies as possible. 10 years ago, the way we identified to reach this goal, thanks to the suggestion of our teacher, <a href="http://www.fazzino.it/">Fabrizio Fazzino</a>, was to implement the simulator in Java and make sure it would run as a web applet.<br />
<br />
10 years ago, Java was an easy choice if you wanted to develop a desktop application that would run across operating systems <b>and</b> on a web browser. JavaScript was already there, but its ecosystem was not very well developed. So we went ahead and implemented it all in Java + Swing.<br />
<br />
EduMIPS64, indeed, today can run as a desktop application and also as a Java applet, if you really want.<br />
<br />
But, in all honesty, it is <b>very </b>cumbersome to run EduMIPS64 (or anything else) as a Java applet. The user interface does not adapt well to a web page, since it's exactly the same one of the desktop application. Let's not even mention running on mobile.<br />
<h3 style="text-align: left;">
</h3>
<h3 style="text-align: left;">
Today</h3>
<div style="text-align: left;">
Today, the easy choice to develop an application that should run across operating system <b>and</b> run on a web browser is HTML5 + JavaScript. There is a thriving ecosystem of client-side JS frameworks, and HTML5 itself offers lots of interesting primitives.</div>
<div style="text-align: left;">
<br /></div>
<div style="text-align: left;">
If we had to start today, we would probably just write the core in (typed?) JavaScript, and use the <i>framework-du-jour</i> (Angular? Polymer? React?) to build the UI. But we are not starting today, and we actually have thousands of lines of perfectly (hah) working Java code for the simulator: we don't want to rewrite that.</div>
<div style="text-align: left;">
<br /></div>
<div style="text-align: left;">
Therefore, to further proceed towards the original vision of EduMIPS64 without wasting all our existing work, in the last months we have been working towards cross-compiling the EduMIPS64 core to JavaScript, to make it possible to develop an HTML5+JavaScript web UI for it.</div>
<div style="text-align: left;">
<br /></div>
<div style="text-align: left;">
Finally, today we have finalized a very crude proof-of-concept, that demonstrates running the EduMIPS64 core behind a highly simplistic user interface. It is reachable at the following URL:</div>
<div style="text-align: left;">
<br /></div>
<div style="text-align: center;">
<a href="http://www.edumips.org/edumips64.html">www.edumips.org/edumips64.html</a></div>
<h3 style="text-align: left;">
</h3>
<h3 style="text-align: left;">
Technical details</h3>
<div>
The cross-compilation was executed using <a href="http://www.gwtproject.org/">Google Web Toolkit</a> (GWT), and more specifically the <a href="https://docs.google.com/file/d/0ByS1wxINeBWjeGYxbkJpamxFZ28/edit">JsInterop</a> features present in GWT 2.8.0 (SNAPSHOT version). </div>
<div>
<br /></div>
<div>
The EduMIPS64 code was not exactly ready for this. GWT supports a subset of the libraries in the standard JDK, and things like Swing or java.io are not present there. So we had - of course - to completely scrap away the Swing code, but also had to deal with more surprising omissions like java.io.BufferedReader, java.util.regex and other libraries used here and there in the simulator.</div>
<div>
<br /></div>
<div>
This is not a client-server application. The core part of the simulator is cross-compiled to JavaScript, and it all runs on the client. The console logs are littered with all the simulator logs, so the activity is visible there.</div>
<h3>
</h3>
<h3>
What next?</h3>
<div>
I consider this a small "present" for myself for the 10 years of EduMIPS64. I had this idea in mind for years, but never found the time or willpower to work on it. The idea that 10 years passed since we started working on the simulator was a trigger to work on this small project.</div>
<div>
<br /></div>
<div>
The current proof of concept is absolutely inadequate to use in classrooms, so a proper web interface now needs to be developed. I would imagine that a first milestone would be implementing a minimum, critical subset of features to make the new web interface acceptable for classroom use.</div>
<div>
<br /></div>
<div>
But the fun will come after that. Using web technologies opens up several new possibilities, including - for example - a good mobile experience, sharing sessions among users (real-time collaboration!), integration with cloud storage providers, and - of course - a more modern UI with a decent look-and-feel.</div>
<div>
<br /></div>
<div>
There is no concrete plan to deliver all this, but some things are happening in the background, with other people potentially interested in this project, so stay tuned for updates! If you are interested in working on this, please get in touch with <a href="http://github.org/lupino3">me on Github</a>.</div>
<div>
<br /></div>
<div>
Oh.. and... happy birthday EduMIPS64! You turned 10 at some point between March and April 2016 (depending on how we count). :)</div>
Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com1tag:blogger.com,1999:blog-2005239310785488917.post-17893401362655461212012-04-17T14:29:00.001-07:002012-04-17T14:29:18.353-07:00www.edumips.org being migratedThe VPS hosting the edumips.org website is being shut down, therefore we are migrating the website to a new VPS.<br />
<br />
As in every migration, there is a risk of downtime. So, if you have problems accessing the website, please report them as a comment to this blog post.Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-16407194056210472602011-11-01T16:33:00.000-07:002012-02-11T11:13:13.218-08:00Repository migrated to gitThe EduMIPS64 source code repository, hosted at svn.edumips.org, has been converted to git.<br />
<br />
So far, the repository contents have been migrated to git using the method described in <a href="http://progit.org/book/ch8-2.html">Pro Git</a>, and the resulting git repository has been pushed to <a href="http://code.google.com/p/edumips64/">Google Code</a> and <a href="https://github.com/lupino3/edumips64">Github</a>.<br />
<br />
The next step is to create a git repository on edumips.org and configure Trac and Apache in order to let them serve the git repository. Most probably, the SVN repository will be removed.<br />
<br />
<b>EDIT:</b> the github repository is now the main one. There will be no repository hosted on edumips.org.Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-4518108566406227792011-09-17T04:52:00.000-07:002011-09-17T05:01:16.292-07:00Finding bugs via bisectionIn the last version of EduMIPS64, we introduced a <a href="http://www.edumips.org/ticket/8">nasty bug</a> that caused the simulator to stop working under Mac OS X Snow Leopard. Now we will not delve into the usual sayings about Java being "write once, debug everywhere", but instead we will show you how we actually identified the commit that introduced the bug.<br />
<br />
The bug was discovered during the development of version 0.5.3, and the problem is that we don't have access to Mac OS X machines for testing, so usually we develop under Linux and sometimes we test also under Windows. So when one of the users reported the bug for version 0.5.3-rc2 we had no idea of which commit could have introduced the bug.<br />
<br />
The stack trace wasn't helpful, just a StackOverflowError with lots of nested AWT/Swing calls, there was no pointer to the EduMIPS64 source code.<br />
<br />
So when last week we could use a Snow Leopard machine to find and fix the bug, we had the problem to first identify the incriminated commit. The SVN revision of 0.5.2 is 436, while the last revision was 623. So there are 187 commits to check.. how to do it (possibly avoiding brute force)?<br />
<br />
Enter <b>bisection</b>.<br />
<br />
Bisection is a technique similar to binary search. You have a <i>good</i> version (rev. 436) and a <i>bad</i> version (rev. 623). What you do is to move at revision <i>(good + bad) / 2</i>, check if it is working or not, mark it as <i>good</i> or <i>bad</i> and repeat the process until the distance between <i>good</i> and <i>bad </i>is 1. This means that you have identified the change that made your <i>good</i> program a <i>bad</i> program.<br />
<br />
You will recognize a familiar pattern here: you are always halving the distance to the objective. This means that you will be able to identify the culprit in <span class="Apple-style-span" style="font-family: inherit;">log<sub>2</sub>(<i>good - bad</i>)</span>. In our case, <span class="Apple-style-span" style="font-family: inherit;">log<sub>2</sub>(623-436) = 10 (rounding up the result). This means that in at most 10 update/compile/test cycles we will find our bug, provided that we can easily and without hesitation say if each version is <i>good</i> or <i>bad</i>. And in our case a <i>bad</i> version means that the simulator is totally hung up, so it is easy.</span><br />
<span class="Apple-style-span" style="font-family: inherit;"><br /></span><br />
<span class="Apple-style-span" style="font-family: inherit;">So, we started from (623 + 436) / 2 = 530, and this is the path that we followed: 530 (<i>good, </i></span><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↑</span>), 576 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>), 553 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>), 541 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>), 535 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>), 532 (<i>good </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↑</span>), 534 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>), 533 (<i>bad </i><span class="Apple-style-span" style="background-color: #fffff2; line-height: 28px; white-space: nowrap;">↓</span>). So the commit that introduced the bug is <a href="http://www.edumips.org/changeset/533/">533</a>. We "simply" had to figure out what is the bug.<br />
<span class="Apple-style-span" style="font-family: inherit;"><br /></span><br />
<span class="Apple-style-span" style="font-family: inherit;">Turns out that commit 533 is a bad commit in itself, because packs several changes at a time (introduction of a singleton, changes to the buildfile and to the logging system setup). So we spent half an hour with the singleton only to find out that the problem was that the JVM of Snow Leopard didn't appreciate that we tried to get the root logger by calling </span><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">Logger.getLogger()</span><span class="Apple-style-span" style="font-family: inherit;"> with an empty string as a parameter (as shown in the <a href="http://download.oracle.com/javase/1,5.0/docs/guide/logging/overview.html">official docs</a>, even if we couldn't find this document for version 6). Using another logger instead of the root logger <a href="http://www.edumips.org/changeset/624/">solved the problem</a>.</span><br />
<span class="Apple-style-span" style="font-family: inherit;"><br /></span><br />
<span class="Apple-style-span" style="font-family: inherit;">By the way, if we used git (and we will migrate to it shortly), we could have used the wonderful command <a href="http://kerneltrap.org/node/11753">git bisect</a>.</span><br />
<span class="Apple-style-span" style="font-family: inherit;"><br /></span><br />
<span class="Apple-style-span" style="font-family: inherit;">So, lessons learned:</span><br />
<br />
<ul>
<li>use bisection to find a commit that introduced a bug, if you<i> </i>can easily tell if a commit contains or not the bug;</li>
<li>try to limit what you change in a commit, so that later it is easy to find what's wrong in that commit;</li>
<li>use git because it helps you in doing both those things. :)</li>
</ul>
<div>
Enjoy!</div>
Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-821853685568121652011-08-11T03:38:00.000-07:002011-08-12T11:12:01.876-07:00Web site and SVN downUnfortunately, slicehost is down right now, and all our services are hosted on a slicehost VPS.<br />
<br />
This means that both the web site and SVN are down right now. I hope there is no big data loss, as I don't have a backup copy of the wiki and would need to rely on the Google cache to rebuild the pages.<br />
<br />
<b>UPDATE:</b> Slicehost was down only for 6 hours (<a href="http://status.slicehost.com/">http://status.slicehost.com/2011/8/11/stl-a-issues-3</a>), and there was no data loss. Time to plan backups!Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com1tag:blogger.com,1999:blog-2005239310785488917.post-2823980938212274092011-06-23T02:51:00.000-07:002011-06-23T02:51:58.685-07:00Status update on 0.5.3The version 0.5.3 of EduMIPS64 is almost ready. Thanks to the students of the Computer Architecture course at the University of Catania I was able to find and fix some bugs (see the <a href="http://www.edumips.org/browser/branches/0.5/ChangeLog?rev=597">temporary ChangeLog</a>).<br />
<br />
I also cleaned up the configuration of Trac on edumips.org and started using its ticket tracking features. <a href="http://www.edumips.org/roadmap">Here</a> is reported the project roadmap (with no due dates) and <a href="http://www.edumips.org/report/6">here</a> are all the tickets (including closed ones), grouped by milestone.<br />
<br />
I moved two tickets that need more time to 0.5.4, so for releasing 0.5.3 only two bugs need to be addressed. The problem is that <a href="http://www.edumips.org/ticket/8">one</a> of them is related to the Mac OS X platform, and I don't have a Mac to work on it. People have been reproducing it on different versions of Mac OS X, and it is obviously a regression because version 0.5.2 shows no issues.<br />
<br />
I hope that I'll get my hands on a Mac OS X in the near future and try to debug this issue. If you have one, please contact me.<br />
<br />
In the next week, I won't have any time for the project, but I hope to start working on it on July.Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-45466082849886863272011-05-23T08:03:00.000-07:002011-05-23T08:03:56.488-07:00Profiling performance issuesAfter some recent changes to the logging code and to the help system, I noticed that the startup of the simulator and its normal operations were <b>considerably</b> slower than the older version. After a bit of search by trial-and-error, I told to myself that I had to use a more scientific method and try to profile the application with a profiler.<br />
<br />
So I started searching for a profiler for Java, and I found the <a href="http://www.yourkit.com/">YourKit Java Profiler</a>, and it seemed to be what I was searching for. I briefly tried it and, thanks to the "HotSpot" feature, I immediately found a bottleneck (formatting the log messages even when they are discarded), so I asked them if they would provide free licenses for open source developers; i then discovered that YourKit is kindly supporting open source projects with free licenses of its full-featured Java Profiler.<br />
<br />
Yourkit profilers are produced by YourKit, LLc: they produce both a <a href="http://www.yourkit.com/download/index.jsp">Java</a> and a <a href="http://www.yourkit.com/dotnet/download/index.jsp">.NET</a> profiler. Of course I only briefly tried the Java profiler, and I can tell you that it was really easy to spot that obvious bottleneck. I'm going to spend some time to profile EduMIPS64 and remove the most prominent bottlenecks.<br />
<br />
<div><br />
</div>Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-33696474269587052292011-04-23T08:04:00.000-07:002011-05-05T03:34:28.620-07:00Fixing the help systemCurrently, the EduMIPS64 user documentation is in bad shape. There are two different sources of documentation:<br />
<br />
<ul><li>The PDF manual, built from LaTeX files;</li>
<li>The in-application help, made by (.. drum roll ..) <span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">text files</span><span class="Apple-style-span" style="font-family: inherit;">. </span></li>
</ul><div>Both help sources are available in English and Italian. But this diversity means that there are two (actually, four) different places to update; moreover, the in-application help is really not adequate and a bit too simple.</div><div><br />
</div><div>Some time ago, we tried porting the help system to JavaHelp, but we didn't finish the porting and had some trouble in properly converting LaTeX to HTML. Moreover, JavaHelp seems to be dead.</div><div><br />
</div><div>So I <a href="http://stackoverflow.com/questions/5608231/user-manual-for-java-software-in-application-help-pdf">asked a question on Stack Overflow</a>, and I got two answers:<br />
<ul><li>convert LaTeX to ePub and embed an open source ePub viewer;</li>
<li>use RTF in a JTextPane</li>
</ul></div><div>To summarize, our requirements for the help system are the following:</div><div><ul><li>single source, multiple outputs (PDF, in-application help);</li>
<li>in-application viewer</li>
<li><i>optional </i>search in the in-application help</li>
<li><i>optional</i> navigation pane in the in-application help</li>
</ul><div>I have been playing a bit with the <a href="http://sphinx.pocoo.org/">Sphinx</a> documentation system, and I got two good PDF and single-html outputs, but then the problem was to display HTML in the application. The JEditorPane widget has some basic support for HTML and CSS, but it is way too basic. I'd had to heavily customize the output of Sphinx and I don't want to spend much time on it. Further, Using a basic viewer I'd drop the two optional requirements (search and navigation), or I'd have to code it- boring.</div></div><div><br />
</div><div>So we are going to try the LaTeX -> epub road, hoping that it works out nicely. In our idea, the new help system should be the only new feature in EduMIPS64 0.5.3.<br />
<br />
<b>EDIT:</b> We settled with converting the documentation to <a href="http://docutils.sourceforge.net/rst.html">reStructured Text</a> and using Sphinx to output both the PDF and a multi-page HTML document, using the epub HTML theme; this HTML docs were then processed with <a href="http://sourceforge.net/projects/jhelpdev/">jHelpDev</a> to build a help set for <a href="http://javahelp.java.net/">JavaHelp</a>, that even if it is not actively developed, seems to work well - maybe it is a bit slow but works. So probably 0.5.3 will have in-app help based on JavaHelp and with the same contents of the PDF manual.</div>Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-84181383463237769712011-04-10T09:34:00.000-07:002011-04-10T09:34:50.032-07:00Improving testabilityThere are a lot of features that can be integrated or implemented, but we feel that the first thing to do is to create a test suite, in order to be fairly confident that when we change something we do not break anything! After all, people use EduMIPS64 during their exams, and I don't want that someone gets a bad grade (and consequently tries to kill me) because of bad code.<br />
<br />
A CPU simulator can be tested in many ways. The main decision we have to make is whether we should do black-box testing (overall functionality) or white-box testing (Java classes, individual or in small sets). So we looked at other CPU simulators in order to see how they solved this problem.<br />
<br />
We've been looking at WinMIPS64, WinDLX and DLXView, but found no answer to our questions.<br />
<br />
But when we turned to the <a href="http://spimsimulator.sourceforge.net/">SPIM MIPS32 Simulator</a>, we found a very rich test suite. It is not surprising, as its author, <a href="http://pages.cs.wisc.edu/~larus/larus.html">James Larus</a>, is very smart and wrote a really good presentation on <a href="http://pages.cs.wisc.edu/~larus/Talks/why_real/index.htm">Why write real software in Academia?</a> (suggested reading for people in academia who happen to write software). The simulator is also featured in <a href="http://pages.cs.wisc.edu/~larus/HP_AppA.pdf">Appendix A</a> of Hennessy & Patterson's "Computer Architecture: A quantitative approach", a reference book in the field, so it is definitely a good reference and inspiration source.<br />
<br />
The Tests directory of SPIM contains 8 assembly test files that, together, amount to ~8500 lines of testing code. It is assembly code, so it is black-box testing.<br />
<br />
We can try to reuse some of them, skipping some features (like FPU) and writing some new tests, as we implement a superset of their instruction set, even if the computation model is a bit different (we don't have memory/mapped IO, control registers and other few things).<br />
<br />
There is a problem, however: EduMIPS64 is meant to be run as a desktop interactive application, and cannot be run in a CLI and in batch mode.<br />
<br />
So we are trying to remove the few dependencies that the core of the simulator has with respect to the User Interface, that are poor design choices, and write a very small CLI frontend for the core, so that the CPU features can be tested without running the UI.<br />
<br />
After that, we will try to port some testing code from SPIM to EduMIPS64, adding our own tests.<br />
<br />
We will then be ready to integrate and add features to the simulator, knowing that we have a safety net that will catch most of the errors and will allow us to write code without breaking the core features in any (obvious) way.Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0tag:blogger.com,1999:blog-2005239310785488917.post-1828760313624746922011-04-06T05:31:00.000-07:002011-04-06T05:44:40.403-07:00State of the EduMIPS64 code base<div>In 2006, a small group of undergraduate students at the University of Catania was taking a course in Computer Architecture; they were not satisfied by existing MIPS64 simulators, so they decided to design and write their own simulator. They called it EduMIPS64 (web site: <a href="http://www.edumips.org/">www.edumips.org</a>), and it was initially conceived as an improved Java clone of <a href="http://www.computing.dcu.ie/~mike/winmips64.html">WinMIPS64</a>.</div><div><br />
</div><div>Most of the development happened between April and October 2006. Then, development slowed down a bit because the main functionalities were working and the simulator had been adopted as the official tool for Computer Architecture courses at the University of Catania.</div><div><br />
There have been a moderate but constant activity through all 2007 and then, finally, in 2008 development came to an halt. The simulator was more mature, but many things still need improvement. Some important features, like FPU support and branch delay slot, have been developed but not released because the code needed to be polished, documented and tested.</div><div><br />
</div><div>This blog post wants to take a snapshot of the current state of the EduMIPS64 code base, in order to facilitate future development efforts.<br />
<br />
<span class="Apple-style-span" style="font-size: large;"><b>The current stable version</b></span><br />
The last version of EduMIPS64, 0.5.2, was released on 17th April of 2008, and like version 0.5.1 it is mainly a bug-fix release. Version 0.5 was the last major version, i.e. a version that introduced new features (namely, MIPS32 instructions and a few other things).<br />
<br />
It can be considered quite stable, as the simulator is routinely used at least at the University of Catania for Computer Architecture exams, and no bugs were reported in the last 3 years.<br />
<br />
<span class="Apple-style-span" style="font-size: large;"><b>The trunk</b></span><br />
The trunk contains an implementation of the FPU, with a complete FP instruction set, visual representation of FP-related sections of the pipeline.<br />
Moreover, it contains a (non-working) attempt to add in the help a conversion to HTML of the PDF manual.<br />
<br />
<span class="Apple-style-span" style="font-size: large;"><b>The branches</b></span><br />
<ul><li><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">delayslot</span><span class="Apple-style-span" style="font-family: Arial, Helvetica, sans-serif;">: </span><span class="Apple-style-span" style="font-family: inherit;">contains an implementation of the <a href="http://en.wikipedia.org/wiki/Branch_delay_slot">Branch delay slot</a>;</span></li>
<li><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">editor</span><span class="Apple-style-span" style="font-family: Arial, Helvetica, sans-serif;">: </span><span class="Apple-style-span" style="font-family: inherit;">contains a (very) basic prototype of a built-in editor;</span></span></li>
<li><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">new_parser</span><span class="Apple-style-span" style="font-family: Arial, Helvetica, sans-serif;">: </span><span class="Apple-style-span" style="font-family: inherit;">a re-engineered parser written to replace the default one, that is difficult to mantain. It was developed as a student project for a Compilers course;</span></span></span></li>
<li><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">cache</span><span class="Apple-style-span" style="font-family: Arial, Helvetica, sans-serif;">: </span><span class="Apple-style-span" style="font-family: inherit;">a re-engineered parser written to replace the one written during the development </span></span></span></span></li>
<li><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: inherit;"><span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">0.5</span><span class="Apple-style-span" style="font-family: Arial, Helvetica, sans-serif;">: </span><span class="Apple-style-span" style="font-family: inherit;">branch where development of the 0.5 series should go</span></span></span></span></span></li>
</ul><div>Of these branches, <span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">delayslot</span>, <span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">new_parser</span> and <span class="Apple-style-span" style="font-family: 'Courier New', Courier, monospace;">cache</span> are the ones that most likely will be included in future stable releases.<br />
<br />
<br />
<div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span class="Apple-style-span" style="font-size: large;"><b><span class="Apple-style-span" style="font-weight: normal;"><b>A note on testability</b></span></b></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;">One of the problems of the EduMIPS64 code base is the lack of automated testing. When we developed it, we were mostly concerned with making it work, and as students it was an ambitious project. We worked day and night and fixed issues when they were raised, either by developers or by users, but we did not fully understand some basic concepts like unit testing, separation of intents, modularity etc..</div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><br />
</div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;">Future development work needs to be addressed to a suite of unit tests that will work as a safety net for regressions as the development goes on.</div><br />
<br />
</div><br />
<div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span class="Apple-style-span" style="font-size: large;"><b>Future development</b></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span style="font-size: large;"><span class="Apple-style-span" style="font-size: small;">There are many features that are almost ready but have been never released to the public, like the FPU or the branch delay slot.</span></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span style="font-size: large;"><span class="Apple-style-span" style="font-size: small;"><br />
</span></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span style="font-size: large;"><span class="Apple-style-span" style="font-size: small;">It is likely that a new version of EduMIPS64, 0.5.3, will be released shortly. It will include some bug fixes and the ability to enable the branch delay slot, in order to get some user feedbacks on it.</span></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span style="font-size: large;"><span class="Apple-style-span" style="font-size: small;"><br />
</span></span></div><div style="margin-bottom: 0px; margin-left: 0px; margin-right: 0px; margin-top: 0px;"><span style="font-size: large;"><span class="Apple-style-span" style="font-size: small;">After this, probably a 0.9 version with FPU will be released, and this version will also need to be heavily tested by users before a 1.0 stable version will be released.</span></span></div><ul></ul><br />
<span class="Apple-style-span" style="font-size: large;"><b><br />
</b></span></div>Andreahttp://www.blogger.com/profile/07172321441296853157noreply@blogger.com0