Project

General

Profile

Getting Started with x86 » History » Version 43

Alexander Kamkin, 04/06/2017 05:03 PM

1 18 Alexander Kamkin
h1. Getting Started with x86
2 1 Mikhail Chupilko
3
{{toc}}
4
5
h2. Prerequisite
6
7 31 Alexander Kamkin
MicroTESK should be [[Installation Guide|installed]].
8 1 Mikhail Chupilko
9 13 Alexander Kamkin
h2. Demo Specifications
10 1 Mikhail Chupilko
11 29 Alexander Kamkin
Specifications of the x86 (8086) instruction set architecture (ISA) can be found in "$MICROTESK_HOME/arch/demo/x86/model/x86.nml":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/model/x86.nml.
12 1 Mikhail Chupilko
13 41 Alexander Kamkin
Instruction are described in [[nML Language Reference|nML]] by means of the following constructs (_mov r16/r16_ is taken as an example):
14 8 Alexander Kamkin
15 10 Alexander Kamkin
## the signature
16 8 Alexander Kamkin
<pre>op mov_r1616 (dst: GPR16, src: GPR16)</pre>
17 10 Alexander Kamkin
## the assembly format
18 8 Alexander Kamkin
<pre>syntax = format("mov %s, %s", dst.syntax, src.syntax)</pre>
19 10 Alexander Kamkin
## the binary encoding
20 8 Alexander Kamkin
<pre>image = format("1000101111%s%s", dst.image, src.image)</pre>
21 14 Alexander Kamkin
## the semantics
22 1 Mikhail Chupilko
<pre>
23
  action = {
24
    dst = src;
25 9 Alexander Kamkin
    ...
26 1 Mikhail Chupilko
  }
27 24 Alexander Kamkin
</pre>
28
29 11 Alexander Kamkin
To compile the ISA model, run the following command:
30 8 Alexander Kamkin
<pre>$MICROTESK_HOME/bin/compile.sh x86.nml</pre>
31 1 Mikhail Chupilko
32 17 Alexander Kamkin
h2. Demo Templates
33 1 Mikhail Chupilko
34 32 Alexander Kamkin
Test templates for the x86 ISA can be found in "$MICROTESK_HOME/arch/demo/x86/templates":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates.
35 1 Mikhail Chupilko
36 33 Alexander Kamkin
The directory contains a number of demo templates including the following ones:
37 17 Alexander Kamkin
38 36 Alexander Kamkin
{background:#f6fcff}. | "block.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/block.rb | demonstrates how to use block constructs |
39 35 Alexander Kamkin
                      | "block_random.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/block_random.rb | demonstrates how to create randomized instruction sequences using block constructs |
40 38 Alexander Kamkin
{background:#f6fcff}. | "euclid.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/euclid.rb | demonstrates test program simulation to predict the resulting microprocessor state |
41 39 Alexander Kamkin
                      | "random.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/random.rb | demonstrates how to randomize tests by using biased values, intervals, arrays, and distributions |
42 40 Alexander Kamkin
{background:#f6fcff}. | "random_immediate.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/random_immediate.rb | demonstrates how to randomize immediate values |
43
                      | "random_registers.rb":http://forge.ispras.ru/projects/microtesk/repository/entry/trunk/microtesk/src/main/arch/demo/x86/templates/random_registers.rb | demonstrates how to randomize registers (dependencies) |
44 1 Mikhail Chupilko
45 41 Alexander Kamkin
Test templates are written in "Ruby":http://www.ruby-lang.org extended with specific [[Template_Description_Language|constructs]].
46
47 42 Alexander Kamkin
To generate test program(s) from a test template (say, @block.rb@), run the following command:
48 1 Mikhail Chupilko
<pre>$MICROTESK_HOME/bin/generate.sh x86 block.rb --code-file-prefix block --code-file-extension -v</pre>
49
50 43 Alexander Kamkin
When generation is finished, the resulting assembly code can be found in @$MICROTESK_HOME@.