# Verilog: Timescales As we are aware, compiler directive ``timescale` in Verilog is a tricky topic and have many discussion around it.

Timescale specifies the time unit and time precision of a module that follow it. The simulation time and delay values are measured using time unit. The precision factor is needed to measure the degree of accuracy of the time unit, in other words how delay values are rounded before being used in simulation.

Let’s have a look into it and see how time units and precision are taken to calculate simulation time.

In the examples, following time scale /time precision combinations are used.

````timescale 1ps / 1ps     // module timescale_check1
`timescale 1 ns / 1 ps   // module timescale_check2;
`timescale 100ns / 1ns   // module timescale_check3;
`timescale 1ms / 1us     // module timescale_check4;
`timescale 10 ms / 10 ns // module timescale_check5;
```

The `rval` changes in different time-steps but due to the differences in timescale directives the simulation time varies.

```            rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
```

In the below code, timescale is `timescale 1ps / 1ps.

To find out number of digits taken after decimal, first divide time scale with time precision. The exponent number will be your result.

Here, 1ps/1ps = 1 = 100, as the result is 100, NO digit will be taken after decimal. So 10.566601 will be 11 and next time step 21.546604 will be just 22.

Check below result to see all simulation time for rval. Also note that simulation ends at 100 PS.

````timescale 1ps / 1ps
module timescale_check1;
reg[31:0] rval;

initial begin
rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
end
initial begin
\$monitor("TimeScale 1ps/1ps : Time=%0t,  rval = %d\n",\$realtime,rval);
#100 \$finish;
end

endmodule
/*
Simulation Result:
ncsim> run
TimeScale 1ps/1ps : Time=0,  rval =         20

TimeScale 1ps/1ps : Time=11,  rval =         10

TimeScale 1ps/1ps : Time=22,  rval =         55

TimeScale 1ps/1ps : Time=38,  rval =          0

TimeScale 1ps/1ps : Time=43,  rval =        250

TimeScale 1ps/1ps : Time=49,  rval =        100

Simulation complete via \$finish(1) at time 100 PS + 0
./timescale.v:17     #100 \$finish;
*/
```

Now, let us check one more example. In `module timescale_check2`, timescale is 1ns / 1ps.

Timescale/Time Precision = 1ns/1ps = 1000 = 103 So 3 digits after decimal will be used. In this case 10.566601 becomes 10567 and 21.546604 becomes 21547.

````timescale 1 ns / 1 ps
module timescale_check2;
reg[31:0] rval;
initial begin
rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
end

initial begin
\$monitor("TimeScale 1ns/1ps : Time=%0t,  rval = %d\n",\$realtime,rval);
#100 \$finish;
end

endmodule
/*
Simulation Result
ncsim> run
TimeScale 1ns/1ps : Time=0,  rval =         20

TimeScale 1ns/1ps : Time=10567,  rval =         10

TimeScale 1ns/1ps : Time=21547,  rval =         55

TimeScale 1ns/1ps : Time=37221,  rval =          0

TimeScale 1ns/1ps : Time=42221,  rval =        250

TimeScale 1ns/1ps : Time=47900,  rval =        100

Simulation complete via \$finish(1) at time 100 NS + 0
./timescale.v:56     #100 \$finish;
*/
```

Below examples show simulation results for timescales 100ns/1ns, 1ms / 1us and 10 ms / 10 ns.

````timescale 100ns / 1ns
module timescale_check3;
reg[31:0] rval;
initial begin
rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
end

initial begin
\$monitor("TimeScale 100 ns/1ns : Time=%0t,  rval = %d\n",\$realtime,rval);
#100 \$finish;
end
endmodule

/*
Simulation Result
ncsim> run
TimeScale 100 ns/1ns : Time=0,  rval =         20

TimeScale 100 ns/1ns : Time=1057,  rval =         10

TimeScale 100 ns/1ns : Time=2155,  rval =         55

TimeScale 100 ns/1ns : Time=3722,  rval =          0

TimeScale 100 ns/1ns : Time=4222,  rval =        250

TimeScale 100 ns/1ns : Time=4790,  rval =        100

Simulation complete via \$finish(1) at time 10 US + 0
./timescale.v:94     #100 \$finish;
*/
```
````timescale 1ms / 1us
module timescale_check4;
reg[31:0] rval;
initial begin
rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
end

initial begin
\$monitor("TimeScale 1ms/1us : Time=%0t,  rval = %d\n",\$realtime,rval);
#100 \$finish;
end

endmodule
/*
Simulation Result
ncsim> run
TimeScale 1ms/1us : Time=0,  rval =         20

TimeScale 1ms/1us : Time=10567,  rval =         10

TimeScale 1ms/1us : Time=21547,  rval =         55

TimeScale 1ms/1us : Time=37221,  rval =          0

TimeScale 1ms/1us : Time=42221,  rval =        250

TimeScale 1ms/1us : Time=47900,  rval =        100

Simulation complete via \$finish(1) at time 100 MS + 0
./timescale.v:132     #100 \$finish;
*/
```
````timescale 10 ms / 10 ns
module timescale_check5;
reg[31:0] rval;
initial begin
rval = 20;
#10.566601 rval = 10;
#10.980003 rval = 55;
#15.674 rval = 0;
#5.0000001 rval = 250;
#5.67891224 rval = 100;
end

initial begin
\$monitor("TimeScale 10 ms/10 ns : Time=%0t,  rval = %d\n",\$realtime,rval);
#100 \$finish;
end

endmodule
/*
Simulation Result
ncsim> run
TimeScale 10 ms/10 ns : Time=0,  rval =         20

TimeScale 10 ms/10 ns : Time=10566601,  rval =         10

TimeScale 10 ms/10 ns : Time=21546604,  rval =         55

TimeScale 10 ms/10 ns : Time=37220604,  rval =          0

TimeScale 10 ms/10 ns : Time=42220604,  rval =        250

TimeScale 10 ms/10 ns : Time=47899516,  rval =        100

Simulation complete via \$finish(1) at time 1 S + 0
./timescale.v:170     #100 \$finish;
*/
``` Sini has spent more than a dozen years in the semiconductor industry, focusing mostly on verification. She is an expert on Formal Verification and has written international papers and articles on related topics.

## 15 comments on “Verilog: Timescales”

1. narasimha

explanations with examples–really good

2. satish

Thanks a lot for the detailed explanation with examples.
Can you please try to explore more on \$timeformat and it’s impact on multiple files?

3. muvva

hi,

your explanation is very nice, but still i had a small difficulty.

according you both 1ps/1ps and 1ns/1ns has to give same answer as both give 10^0 only, but i am getting different results.

with no provision i failed attach the image, if you give your mail id i can post the simulation results.

thanking you,

4. sumit

now i am very much clear with this concept. Thank you

5. manisha pradhan

very clear explanation………….

6. Neha

Hi,

Can you add an example for e.g. `timsecale 1ns/20ps?

7. Krishna

Superb Explanation with examples..

8. abmataz

very clear explanation
thank you!

9. Sarah

I think these examples are extremely confusing. Mainly because of this line:
``` \$monitor("TimeScale 1ms/1us : Time=%0t, rval = %d\n",\$realtime,rval); ```
It could be improved by changing it to this:
``` \$monitor("TimeScale 1ms/1us : Time=%0f, rval = %d\n",\$realtime,rval); ```
Looking at output from the authors code all the times appear to be multiplied by the time-unit/time-precision, and that’s not what’s really happening. \$realtime is a real/float and should be printed as such.

10. ABHILASH

EXPLANATION WITH EXAMPLES, VERY GOOD

11. Srinivasan

Great work.
I have few doubts.
How can I represent a rational number/floating point number in verilog. Example 12.5 or 12.246
‘Timescale is used only for simulation purposes.
According to my knowledge, real keyword can be used , but again it’s a not synthesize or fixed point representation (synthesizable) and floating point rep are used .
Accuracy in the above mentioned cases are less. What should be done to fetch good accuracy.
12. Srinivasan
13. vikas