Download – Amnesia Project

Important warning!

All the softwares made available here are under GNU GPL v3 software license. Other resources made available are under Creative Commons license.

By downloading any of those resources, you accept these licenses’ terms and conditions.
Copyright © 2015 Distributed Systemas and Concurrent Programming Laboratory (LaSDPC) – SSC/ICMC – University of São Paulo (USP). This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses.

 

References

To cite the use of Amnesia in other works/papers, please, use the references down below:
For references to cache memory module in Amnesia:

TIOSSO, F. ; Bruschi, S.M. ; SOUZA, P. S. L. ; BARBOSA, E. F. . [LINK]Amnesia: um Objeto de Aprendizagem para o Ensino de Hierarquia de Memória, Proceedings of the 25o. Simpósio Brasileiro de Informática na Educação (SBIE 2014), Dourados, Sociedade Brasileira de Computação, 2014. v. 1. p. 1-10.

For references to the virtual memory module in Amnesia:

Cacho, C. E. A. ; SOUZA, P. S. L. ; Bruschi, S.M. ; BARBOSA, E. F. ; TIOSSO, F.  An Interactive Approach for the Teaching of Virtual Memory Using Open Educational Resources. In: 31st ACM Symposium on Applied Computing – ACM SAC 2016, 2015, Pisa, Italy. Proceedings of ACM SAC 2016. New York : ACM, 2016. p. 225-231.     DOI: http://dx.doi.org/10.1145/2851613.2851700

 

Minimal requirements for execution

– Screen resolution of at least 1024 x 784 px.
1. Verify your resolution with the Operational System.

JAVA
1. It is important to highlight that all tests made with the open educational resource Amnesia used JAVA 6.5 or above. If you have a lower version installed, please download the most recent one and install it.

– Unpack the ZIP file to any folder of your computer.

– Open the JAR file that is in the root directory of the unpacked structure.

Downloading the executables

In these ZIP files you’ll find the JAR file that executes Amnesia, architecture files (they set the memory hierarchy), trace files, folders with settings files used during execution (do not remove these folders) and the tutorial of the simulator use (AmnesiaHelp folder).
Amnesia_Cache: Cache memory module with example files for the simulations of caches that are totally associative, associative by set, unified, split, multilevel, and others.

Amnesia_MV: Virtual memory module with example files for the simulation of structures like pages table, disk and Translation-Lookaside Buffer (TLB). This module makes possible to simulate the main functionalities and performance features present at a paged virtual memory.

Amnesia_Cache_MV: This file has the two modules above in only one simulator, with the example files for Cache memory and Virtual memory simulations, besides examples for the simulation of both modules together.

The CPU module is not available yet. Cache memory and virtual memory accesses are made by reading a trace file.

 

Source code download

To have access to the files with source codes, please, contact us here. This procedure will help us to know who is interested in Amnesia’s source code, just for statistic means.

 

Download of class plans

Class plans are scripts to help professors with the Amnesia’s use in classroom. Each file in the ZIP has a class plan, and the classes use different activities. These activities are detailed in different files, in the activities folder. The class plans have got hyperlinks for the files that describe the activities used in that class.
Cache memory: In this file you’ll find class plans related to the cache memory subject. The classes consider unified and split caches, multilevel, different degrees of associativity and reading and writing operations.
Virtual memory: In this file you’ll find classes plans related to pages table, substitution policy, TLB, and other subjects. The plans are divided in two main groups: students with or without previous knowledge of the virtual memory subject.