The picoJava-II^TM Source Readme

Welcome to the picoJava-II^TM Source Distribution.

Please see the Sun Community Source License for full details about the provisions and requirements of the picoJava-II community source licensing program.

This page contains links to and describes:

Primary picoJava-II documentation
Getting started with the picoJava-II source distribution
Online documentation

These documents are in Adobe Acrobat PDF format.

• picoJava-II Programmer's Reference Manual The picoJava-II PRM describes the picoJava-II processor from a software programmers point of view. It describes in detail the instruction set and registers, the calling convention, garbage collection support, monitor handling, and so on.
• picoJava-II Verification Guide The picoJava-II Verification Guide describes the simulation environment which is provided as part of this source release. It contains details about the verification methodology, test scripts, and descriptions of tests in the verification test suite.
• picoJava-II Microarchitecture Guide The picoJava-II Microarchitecture Guide describes the hardware implementation of the picoJava-II core. It contains details about the pipeline, the core's external interface, megacell specifications, the various functional units in the design, and the interface between these units.

There are four directories under the picoJava-II database.

• The design directory contains the source code for the picoJava-II core in RTL form.
• The docs directory contains the documentation.
• The sim directory contains the simulation environment and the verification test suite.
• The tools directory contains picoJava-II tools such as the instruction accurate simulator(ias), the assembler, and disassembler.

Note:   If you downloaded only the software development distribution, some of these directories will not be present. However, you should have everything you need in order to develop software and run programs on the simulator.

To use the picoJava-II source distribution, you must first set up your environment.

You will need certain tools for building the picoJava-II simulation environment and test cases.

• To build the simulator, you must have access to a C compiler.
• To build the RTL model, you must have access to a C compiler and a Verilog simulator such as Verilog-XL or VCS.
• To build the tests, you need gnu m4, cpp and JDK 1.1.3 or higher.
• To run simulations using the steam script, you need perl.

Building the Instruction-Accurate simulator (IAS)
Building the RTL model
Building and Running tests
Browsing the RTL sources
Running synthesis on the RTL design

• Instruction-Accurate simulator documentation
• Assembler/disassembler documentation
• Running tests using steam
• System calls in the picoJava environment
• Class loading in the picoJava environment (.class, .init, and .binit files)
• Cosimulation FAQ
• RTL simulation options
• picoJava-II Microarchitecture Presentation Slides
(document is in Adobe Acrobat PDF format)
• picoJava-II sample floor plan
(document is in Adobe Acrobat PDF format)