|
|
--------------------------------------------------------------------------------
|
|
|
-- File Name: conversions_p.vhd
|
|
|
--------------------------------------------------------------------------------
|
|
|
-- Copyright (C) 1997, 1998, 2001 Free Model Foundry; http://eda.org/fmf/
|
|
|
--
|
|
|
-- This program is free software; you can redistribute it and/or modify
|
|
|
-- it under the terms of the GNU General Public License version 2 as
|
|
|
-- published by the Free Software Foundation.
|
|
|
--
|
|
|
-- This package was written by SEVA Technologies, Inc. and donated to the FMF.
|
|
|
-- www.seva.com
|
|
|
--
|
|
|
-- MODIFICATION HISTORY:
|
|
|
--
|
|
|
-- version: | author: | mod date: | changes made:
|
|
|
-- V1.0 R. Steele 97 DEC 05 Added header and formatting to SEVA file
|
|
|
-- V1.1 R. Munden 98 NOV 28 Corrected some comments
|
|
|
-- Corrected function b
|
|
|
-- V1.2 R. Munden 01 MAY 27 Corrected function to_nat for weak values
|
|
|
-- and combined into a single file
|
|
|
--
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
LIBRARY IEEE; USE IEEE.std_logic_1164.ALL;
|
|
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
-- CONVERSION FUNCTION SELECTION TABLES
|
|
|
--------------------------------------------------------------------------------
|
|
|
--
|
|
|
-- FROM TO: std_logic_vector std_logic natural time string
|
|
|
-- -----------------|---------------|---------|---------|---------|-----------
|
|
|
-- std_logic_vector | N/A | N/A | to_nat | combine | see below
|
|
|
-- std_logic | N/A | N/A | to_nat | combine | see below
|
|
|
-- natural | to_slv | to_sl | N/A | to_time | see below
|
|
|
-- time | N/A | N/A | to_nat | N/A | to_time_str
|
|
|
-- hex string | h | N/A | h | combine | N/A
|
|
|
-- decimal string | d | N/A | d | combine | N/A
|
|
|
-- octal string | o | N/A | o | combine | N/A
|
|
|
-- binary string | b | N/A | b | combine | N/A
|
|
|
-- -----------------|---------------|---------|---------|---------|-----------
|
|
|
--
|
|
|
-- FROM TO: hex string decimal string octal string binary string
|
|
|
-- -----------------|------------|-------------|------------|----------------
|
|
|
-- std_logic_vector | to_hex_str | to_int_str | to_oct_str | to_bin_str
|
|
|
-- std_logic | N/A | N/A | N/A | to_bin_str
|
|
|
-- natural | to_hex_str | to_int_str | to_oct_str | to_bin_str
|
|
|
-- -----------------|------------|-------------|------------|----------------
|
|
|
--
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
|
|
PACKAGE conversions IS
|
|
|
|
|
|
----------------------------------------------------------------------------
|
|
|
-- the conversions in this package are not guaranteed to be synthesizable.
|
|
|
--
|
|
|
-- others functions available
|
|
|
-- fill creates a variable length string of the fill character
|
|
|
--
|
|
|
--
|
|
|
--
|
|
|
-- input parameters of type natural or integer can be in the form:
|
|
|
-- normal -> 8, 99, 4_237
|
|
|
-- base#value# -> 2#0101#, 16#fa4C#, 8#6_734#
|
|
|
-- with exponents(x10) -> 8e4, 16#2e#E4
|
|
|
--
|
|
|
-- input parameters of type string can be in the form:
|
|
|
-- "99", "4_237", "0101", "1010_1010"
|
|
|
--
|
|
|
-- for bit/bit_vector <-> std_logic/std_logic_vector conversions use
|
|
|
-- package std_logic_1164
|
|
|
-- to_bit(std_logic)
|
|
|
-- to_bitvector(std_logic_vector)
|
|
|
-- to_stdlogic(bit)
|
|
|
-- to_stdlogicvector(bit_vector)
|
|
|
--
|
|
|
-- for "synthesizable" signed/unsigned/std_logic_vector/integer
|
|
|
-- conversions use
|
|
|
-- package std_logic_arith
|
|
|
-- conv_integer(signed/unsigned)
|
|
|
-- conv_unsigned(integer/signed,size)
|
|
|
-- conv_signed(integer/unsigned,size)
|
|
|
-- conv_std_logic_vector(integer/signed/unsigned,size)
|
|
|
--
|
|
|
-- for "synthesizable" std_logic_vector -> integer conversions use
|
|
|
-- package std_logic_unsigned/std_logic_signed
|
|
|
-- <these packages are mutually exclusive>
|
|
|
-- conv_integer(std_logic_vector)
|
|
|
-- <except for this conversion, these packages are unnecessary)
|
|
|
-- to minimize compile problems write:
|
|
|
-- use std_logic_unsigned.conv_integer;
|
|
|
-- use std_logic_signed.conv_integer;
|
|
|
--
|
|
|
-- std_logic_vector, signed and unsigned types are "closely related"
|
|
|
-- no type conversion functions are needed, use type casting or qualified
|
|
|
-- expressions
|
|
|
--
|
|
|
-- type1(object of type2) <type casting>
|
|
|
-- type1'(expression of type2) <qualified expression>
|
|
|
--
|
|
|
-- most conversions have 4 parmeters:
|
|
|
-- x : value to be converted
|
|
|
-- rtn_len : size of the return value
|
|
|
-- justify : justify value 'left' or 'right', default is right
|
|
|
-- basespec : print the base of the value - 'yes'/'no', default is yes
|
|
|
--
|
|
|
-- Typical ways to call these functions:
|
|
|
-- simple, all defaults used
|
|
|
-- to_bin_str(x)
|
|
|
-- x will be converted to a string of minimum size with a
|
|
|
-- base specification appended for clarity
|
|
|
-- if x is 10101 then return is b"10101"
|
|
|
--
|
|
|
-- to control size of return string
|
|
|
-- to_hex_str(x,
|
|
|
-- 6)
|
|
|
-- length of string returned will be 6 characters
|
|
|
-- value will be right justified in the field
|
|
|
-- if x is 10101 then return is ....h"15"
|
|
|
-- where '.' represents a blank
|
|
|
-- if 'rtn_len' parm defaults or is set to 0 then
|
|
|
-- return string will always be minimum size
|
|
|
--
|
|
|
-- to left justify and suppress base specification
|
|
|
-- to_int_str(x,
|
|
|
-- 6,
|
|
|
-- justify => left,
|
|
|
-- basespec => yes)
|
|
|
-- length of return string will be 6 characters
|
|
|
-- the base specification will be suppressed
|
|
|
-- if x is 10101 then return is 21....
|
|
|
-- where '.' represents a blank
|
|
|
--
|
|
|
-- other usage notes
|
|
|
--
|
|
|
-- if rtn_len less than or equal to x'length then ignore
|
|
|
-- rtn_len and return string of x'length
|
|
|
-- the 'justify' parm is effectively ignored in this case
|
|
|
--
|
|
|
-- if rtn_len greater than x'length then return string
|
|
|
-- of rtn_len with blanks based on 'justify' parm
|
|
|
--
|
|
|
-- these routines do not handle negative numbers
|
|
|
----------------------------------------------------------------------------
|
|
|
|
|
|
type justify_side is (left, right);
|
|
|
type b_spec is (no , yes);
|
|
|
|
|
|
-- std_logic_vector to binary string
|
|
|
function to_bin_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
|
|
|
-- std_logic to binary string
|
|
|
function to_bin_str(x : std_logic;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
|
|
|
-- natural to binary string
|
|
|
function to_bin_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
-- std_logic_vector to hex string
|
|
|
function to_hex_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
|
|
|
-- natural to hex string
|
|
|
function to_hex_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
-- std_logic_vector to octal string
|
|
|
function to_oct_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
|
|
|
-- natural to octal string
|
|
|
function to_oct_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
-- natural to integer string
|
|
|
function to_int_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
-- std_logic_vector to integer string
|
|
|
function to_int_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string;
|
|
|
|
|
|
-- time to string
|
|
|
function to_time_str (x : time)
|
|
|
return string;
|
|
|
|
|
|
-- add characters to a string
|
|
|
function fill (fill_char : character := '*';
|
|
|
rtn_len : integer := 1)
|
|
|
return string;
|
|
|
-- usage:
|
|
|
-- fill
|
|
|
-- returns *
|
|
|
-- fill(' ',10)
|
|
|
-- returns .......... when '.' represents a blank
|
|
|
-- fill(lf) or fill(ht)
|
|
|
-- returns line feed character or tab character respectively
|
|
|
|
|
|
-- std_logic_vector to natural
|
|
|
function to_nat (x : std_logic_vector)
|
|
|
return natural;
|
|
|
|
|
|
-- std_logic to natural
|
|
|
function to_nat (x : std_logic)
|
|
|
return natural;
|
|
|
|
|
|
-- time to natural
|
|
|
function to_nat (x : time)
|
|
|
return natural;
|
|
|
|
|
|
-- hex string to std_logic_vector
|
|
|
function h (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector;
|
|
|
-- if rtn_len is < than x'length*4, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 9 or a,A to f,F
|
|
|
-- or x,X,z,Z,u,U,-,w,W, result will be 0
|
|
|
|
|
|
-- decimal string to std_logic_vector
|
|
|
function d (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector;
|
|
|
-- if rtn_len is < than x'length*4, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 9 or x,X,z,Z,u,U,-,w,W,
|
|
|
-- result will be 0
|
|
|
|
|
|
-- octal string to std_logic_vector
|
|
|
function o (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector;
|
|
|
-- if rtn_len is < than x'length*4, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 7 or x,X,z,Z,u,U,-,w,W,
|
|
|
-- result will be 0
|
|
|
|
|
|
-- binary string to std_logic_vector
|
|
|
function b (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector;
|
|
|
-- if rtn_len is < than x'length*4, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 1 or x,X,z,Z,u,U,-,w,W,
|
|
|
-- result will be 0
|
|
|
|
|
|
-- hex string to natural
|
|
|
function h (x : string)
|
|
|
return natural;
|
|
|
-- if x is other than characters 0 to 9 or a,A to f,F, result will be 0
|
|
|
|
|
|
-- decimal string to natural
|
|
|
function d (x : string)
|
|
|
return natural;
|
|
|
-- if x is other than characters 0 to 9, result will be 0
|
|
|
|
|
|
-- octal string to natural
|
|
|
function o (x : string)
|
|
|
return natural;
|
|
|
-- if x is other than characters 0 to 7, result will be 0
|
|
|
|
|
|
-- binary string to natural
|
|
|
function b (x : string)
|
|
|
return natural;
|
|
|
-- if x is other than characters 0 to 1, result will be 0
|
|
|
|
|
|
-- natural to std_logic_vector
|
|
|
function to_slv (x : natural;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector;
|
|
|
-- if rtn_len is < than sizeof(x), result will be truncated on the left
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
-- natural to std_logic
|
|
|
function to_sl (x : natural)
|
|
|
return std_logic;
|
|
|
|
|
|
-- natural to time
|
|
|
function to_time (x : natural)
|
|
|
return time;
|
|
|
-- see note above regarding possible formats for x
|
|
|
|
|
|
END conversions;
|
|
|
--
|
|
|
--------------------------------------------------------------------------------
|
|
|
--
|
|
|
|
|
|
PACKAGE BODY conversions IS
|
|
|
|
|
|
-- private declarations for this package
|
|
|
type basetype is (binary, octal, decimal, hex);
|
|
|
|
|
|
function max(x,y: integer) return integer is
|
|
|
begin
|
|
|
if x > y then return x; else return y; end if;
|
|
|
end max;
|
|
|
|
|
|
function min(x,y: integer) return integer is
|
|
|
begin
|
|
|
if x < y then return x; else return y; end if;
|
|
|
end min;
|
|
|
|
|
|
-- consider function sizeof for string/slv/???, return natural
|
|
|
|
|
|
-- function size(len: natural) return natural is
|
|
|
-- begin
|
|
|
-- if len=0 then
|
|
|
-- return 31;
|
|
|
-- else return len;
|
|
|
-- end if;
|
|
|
-- end size;
|
|
|
|
|
|
function nextmultof (x : positive;
|
|
|
size : positive) return positive is
|
|
|
begin
|
|
|
case x mod size is
|
|
|
when 0 => return size * x/size;
|
|
|
when others => return size * (x/size + 1);
|
|
|
end case;
|
|
|
end nextmultof;
|
|
|
|
|
|
function rtn_base (base : basetype) return character is
|
|
|
begin
|
|
|
case base is
|
|
|
when binary => return 'b';
|
|
|
when octal => return 'o';
|
|
|
when decimal => return 'd';
|
|
|
when hex => return 'h';
|
|
|
end case;
|
|
|
end rtn_base;
|
|
|
|
|
|
function format (r : string;
|
|
|
base : basetype;
|
|
|
rtn_len : natural ;
|
|
|
justify : justify_side;
|
|
|
basespec : b_spec) return string is
|
|
|
variable int_rtn_len : integer;
|
|
|
begin
|
|
|
if basespec=yes then
|
|
|
int_rtn_len := rtn_len - 3;
|
|
|
else
|
|
|
int_rtn_len := rtn_len;
|
|
|
end if;
|
|
|
if int_rtn_len <= r'length then
|
|
|
case basespec is
|
|
|
when no => return r ;
|
|
|
when yes => return rtn_base(base) & '"' & r & '"';
|
|
|
end case;
|
|
|
else
|
|
|
case justify is
|
|
|
when left =>
|
|
|
case basespec is
|
|
|
when no =>
|
|
|
return r & fill(' ',int_rtn_len - r'length);
|
|
|
when yes =>
|
|
|
return rtn_base(base) & '"' & r & '"' &
|
|
|
fill(' ',int_rtn_len - r'length);
|
|
|
end case;
|
|
|
when right =>
|
|
|
case basespec is
|
|
|
when no =>
|
|
|
return fill(' ',int_rtn_len - r'length) & r ;
|
|
|
when yes =>
|
|
|
return fill(' ',int_rtn_len - r'length) &
|
|
|
rtn_base(base) & '"' & r & '"';
|
|
|
end case;
|
|
|
end case;
|
|
|
end if;
|
|
|
end format;
|
|
|
|
|
|
-- convert numeric string of any base to natural
|
|
|
function cnvt_base (x : string;
|
|
|
inbase : natural range 2 to 16) return natural is
|
|
|
-- assumes x is an unsigned number string of base 'inbase'
|
|
|
-- values larger than natural'high are not supported
|
|
|
variable r,t : natural := 0;
|
|
|
variable place : positive := 1;
|
|
|
begin
|
|
|
for i in x'reverse_range loop
|
|
|
case x(i) is
|
|
|
when '0' => t := 0;
|
|
|
when '1' => t := 1;
|
|
|
when '2' => t := 2;
|
|
|
when '3' => t := 3;
|
|
|
when '4' => t := 4;
|
|
|
when '5' => t := 5;
|
|
|
when '6' => t := 6;
|
|
|
when '7' => t := 7;
|
|
|
when '8' => t := 8;
|
|
|
when '9' => t := 9;
|
|
|
when 'a'|'A' => t := 10;
|
|
|
when 'b'|'B' => t := 11;
|
|
|
when 'c'|'C' => t := 12;
|
|
|
when 'd'|'D' => t := 13;
|
|
|
when 'e'|'E' => t := 14;
|
|
|
when 'f'|'F' => t := 15;
|
|
|
when '_' => t := 0; -- ignore these characters
|
|
|
place := place / inbase;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"CNVT_BASE found input value larger than base: " & lf &
|
|
|
"Input value: " & x(i) &
|
|
|
" Base: " & to_int_str(inbase) & lf &
|
|
|
"converting input to integer 0"
|
|
|
severity warning;
|
|
|
return 0;
|
|
|
end case;
|
|
|
if t / inbase > 1 then -- invalid value for base
|
|
|
assert false
|
|
|
report lf &
|
|
|
"CNVT_BASE found input value larger than base: " & lf &
|
|
|
"Input value: " & x(i) &
|
|
|
" Base: " & to_int_str(inbase) & lf &
|
|
|
"converting input to integer 0"
|
|
|
severity warning;
|
|
|
return 0;
|
|
|
else
|
|
|
r := r + (t * place);
|
|
|
place := place * inbase;
|
|
|
end if;
|
|
|
end loop;
|
|
|
return r;
|
|
|
end cnvt_base;
|
|
|
|
|
|
function extend (x : std_logic;
|
|
|
len : positive) return std_logic_vector is
|
|
|
variable v : std_logic_vector(1 to len) := (others => x);
|
|
|
begin
|
|
|
return v;
|
|
|
end extend;
|
|
|
|
|
|
|
|
|
-- implementation of public declarations
|
|
|
|
|
|
function to_bin_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
|
|
|
variable int : std_logic_vector(1 to x'length):=x;
|
|
|
variable r : string(1 to x'length):=(others=>'$');
|
|
|
begin
|
|
|
for i in int'range loop
|
|
|
r(i to i) := to_bin_str(int(i),basespec=>no);
|
|
|
end loop;
|
|
|
return format (r,binary,rtn_len,justify,basespec);
|
|
|
end to_bin_str;
|
|
|
|
|
|
function to_bin_str(x : std_logic;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
variable r : string(1 to 1);
|
|
|
begin
|
|
|
case x is
|
|
|
when '0' => r(1) := '0';
|
|
|
when '1' => r(1) := '1';
|
|
|
when 'U' => r(1) := 'U';
|
|
|
when 'X' => r(1) := 'X';
|
|
|
when 'Z' => r(1) := 'Z';
|
|
|
when 'W' => r(1) := 'W';
|
|
|
when 'H' => r(1) := 'H';
|
|
|
when 'L' => r(1) := 'L';
|
|
|
when '-' => r(1) := '-';
|
|
|
end case;
|
|
|
return format (r,binary,rtn_len,justify,basespec);
|
|
|
end to_bin_str;
|
|
|
|
|
|
function to_bin_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
variable int : natural := x;
|
|
|
variable ptr : positive range 2 to 32 := 32;
|
|
|
variable r : string(2 to 32):=(others=>'$');
|
|
|
begin
|
|
|
if int = 0 then
|
|
|
return format ("0",binary,rtn_len,justify,basespec);
|
|
|
end if;
|
|
|
|
|
|
while int > 0 loop
|
|
|
case int rem 2 is
|
|
|
when 0 => r(ptr) := '0';
|
|
|
when 1 => r(ptr) := '1';
|
|
|
when others =>
|
|
|
assert false report lf & "TO_BIN_STR, shouldn't happen"
|
|
|
severity failure;
|
|
|
return "$";
|
|
|
null;
|
|
|
end case;
|
|
|
int := int / 2;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return format (r(ptr+1 to 32),binary,rtn_len,justify,basespec);
|
|
|
end to_bin_str;
|
|
|
|
|
|
function to_hex_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
-- will return x'length/4
|
|
|
variable nxt : positive := nextmultof(x'length,4);
|
|
|
variable int : std_logic_vector(1 to nxt):= (others => '0');
|
|
|
variable ptr : positive range 1 to (nxt/4)+1 := 1;
|
|
|
variable r : string(1 to nxt/4):=(others=>'$');
|
|
|
subtype slv4 is std_logic_vector(1 to 4);
|
|
|
begin
|
|
|
int(nxt-x'length+1 to nxt) := x;
|
|
|
if nxt-x'length > 0 and x(x'left) /= '1' then
|
|
|
int(1 to nxt-x'length) := extend(x(x'left),nxt-x'length);
|
|
|
end if;
|
|
|
for i in int'range loop
|
|
|
next when i rem 4 /= 1;
|
|
|
case slv4'(int(i to i+3)) is
|
|
|
when "0000" => r(ptr) := '0';
|
|
|
when "0001" => r(ptr) := '1';
|
|
|
when "0010" => r(ptr) := '2';
|
|
|
when "0011" => r(ptr) := '3';
|
|
|
when "0100" => r(ptr) := '4';
|
|
|
when "0101" => r(ptr) := '5';
|
|
|
when "0110" => r(ptr) := '6';
|
|
|
when "0111" => r(ptr) := '7';
|
|
|
when "1000" => r(ptr) := '8';
|
|
|
when "1001" => r(ptr) := '9';
|
|
|
when "1010" => r(ptr) := 'A';
|
|
|
when "1011" => r(ptr) := 'B';
|
|
|
when "1100" => r(ptr) := 'C';
|
|
|
when "1101" => r(ptr) := 'D';
|
|
|
when "1110" => r(ptr) := 'E';
|
|
|
when "1111" => r(ptr) := 'F';
|
|
|
when "ZZZZ" => r(ptr) := 'Z';
|
|
|
when "WWWW" => r(ptr) := 'W';
|
|
|
when "LLLL" => r(ptr) := 'L';
|
|
|
when "HHHH" => r(ptr) := 'H';
|
|
|
when "UUUU" => r(ptr) := 'U';
|
|
|
when "XXXX" => r(ptr) := 'X';
|
|
|
when "----" => r(ptr) := '-';
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"TO_HEX_STR found illegal value: " &
|
|
|
to_bin_str(int(i to i+3)) & lf &
|
|
|
"converting input to '-'"
|
|
|
severity warning;
|
|
|
r(ptr) := '-';
|
|
|
end case;
|
|
|
ptr := ptr + 1;
|
|
|
end loop;
|
|
|
return format (r,hex,rtn_len,justify,basespec);
|
|
|
end to_hex_str;
|
|
|
|
|
|
function to_hex_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
variable int : natural := x;
|
|
|
variable ptr : positive range 1 to 20 := 20;
|
|
|
variable r : string(1 to 20):=(others=>'$');
|
|
|
begin
|
|
|
if x=0 then return format ("0",hex,rtn_len,justify,basespec); end if;
|
|
|
while int > 0 loop
|
|
|
case int rem 16 is
|
|
|
when 0 => r(ptr) := '0';
|
|
|
when 1 => r(ptr) := '1';
|
|
|
when 2 => r(ptr) := '2';
|
|
|
when 3 => r(ptr) := '3';
|
|
|
when 4 => r(ptr) := '4';
|
|
|
when 5 => r(ptr) := '5';
|
|
|
when 6 => r(ptr) := '6';
|
|
|
when 7 => r(ptr) := '7';
|
|
|
when 8 => r(ptr) := '8';
|
|
|
when 9 => r(ptr) := '9';
|
|
|
when 10 => r(ptr) := 'A';
|
|
|
when 11 => r(ptr) := 'B';
|
|
|
when 12 => r(ptr) := 'C';
|
|
|
when 13 => r(ptr) := 'D';
|
|
|
when 14 => r(ptr) := 'E';
|
|
|
when 15 => r(ptr) := 'F';
|
|
|
when others =>
|
|
|
assert false report lf & "TO_HEX_STR, shouldn't happen"
|
|
|
severity failure;
|
|
|
return "$";
|
|
|
end case;
|
|
|
int := int / 16;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return format (r(ptr+1 to 20),hex,rtn_len,justify,basespec);
|
|
|
end to_hex_str;
|
|
|
|
|
|
function to_oct_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
-- will return x'length/3
|
|
|
variable nxt : positive := nextmultof(x'length,3);
|
|
|
variable int : std_logic_vector(1 to nxt):= (others => '0');
|
|
|
variable ptr : positive range 1 to (nxt/3)+1 := 1;
|
|
|
variable r : string(1 to nxt/3):=(others=>'$');
|
|
|
subtype slv3 is std_logic_vector(1 to 3);
|
|
|
begin
|
|
|
int(nxt-x'length+1 to nxt) := x;
|
|
|
if nxt-x'length > 0 and x(x'left) /= '1' then
|
|
|
int(1 to nxt-x'length) := extend(x(x'left),nxt-x'length);
|
|
|
end if;
|
|
|
for i in int'range loop
|
|
|
next when i rem 3 /= 1;
|
|
|
case slv3'(int(i to i+2)) is
|
|
|
when "000" => r(ptr) := '0';
|
|
|
when "001" => r(ptr) := '1';
|
|
|
when "010" => r(ptr) := '2';
|
|
|
when "011" => r(ptr) := '3';
|
|
|
when "100" => r(ptr) := '4';
|
|
|
when "101" => r(ptr) := '5';
|
|
|
when "110" => r(ptr) := '6';
|
|
|
when "111" => r(ptr) := '7';
|
|
|
when "ZZZ" => r(ptr) := 'Z';
|
|
|
when "WWW" => r(ptr) := 'W';
|
|
|
when "LLL" => r(ptr) := 'L';
|
|
|
when "HHH" => r(ptr) := 'H';
|
|
|
when "UUU" => r(ptr) := 'U';
|
|
|
when "XXX" => r(ptr) := 'X';
|
|
|
when "---" => r(ptr) := '-';
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"TO_OCT_STR found illegal value: " &
|
|
|
to_bin_str(int(i to i+2)) & lf &
|
|
|
"converting input to '-'"
|
|
|
severity warning;
|
|
|
r(ptr) := '-';
|
|
|
end case;
|
|
|
ptr := ptr + 1;
|
|
|
end loop;
|
|
|
return format (r,octal,rtn_len,justify,basespec);
|
|
|
end to_oct_str;
|
|
|
|
|
|
function to_oct_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
variable int : natural := x;
|
|
|
variable ptr : positive range 1 to 20 := 20;
|
|
|
variable r : string(1 to 20):=(others=>'$');
|
|
|
begin
|
|
|
if x=0 then return format ("0",octal,rtn_len,justify,basespec); end if;
|
|
|
while int > 0 loop
|
|
|
case int rem 8 is
|
|
|
when 0 => r(ptr) := '0';
|
|
|
when 1 => r(ptr) := '1';
|
|
|
when 2 => r(ptr) := '2';
|
|
|
when 3 => r(ptr) := '3';
|
|
|
when 4 => r(ptr) := '4';
|
|
|
when 5 => r(ptr) := '5';
|
|
|
when 6 => r(ptr) := '6';
|
|
|
when 7 => r(ptr) := '7';
|
|
|
when others =>
|
|
|
assert false report lf & "TO_OCT_STR, shouldn't happen"
|
|
|
severity failure;
|
|
|
return "$";
|
|
|
end case;
|
|
|
int := int / 8;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return format (r(ptr+1 to 20),octal,rtn_len,justify,basespec);
|
|
|
end to_oct_str;
|
|
|
|
|
|
function to_int_str(x : natural;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes) return string is
|
|
|
variable int : natural := x;
|
|
|
variable ptr : positive range 1 to 32 := 32;
|
|
|
variable r : string(1 to 32):=(others=>'$');
|
|
|
begin
|
|
|
if x=0 then return format ("0",hex,rtn_len,justify,basespec);
|
|
|
else
|
|
|
while int > 0 loop
|
|
|
case int rem 10 is
|
|
|
when 0 => r(ptr) := '0';
|
|
|
when 1 => r(ptr) := '1';
|
|
|
when 2 => r(ptr) := '2';
|
|
|
when 3 => r(ptr) := '3';
|
|
|
when 4 => r(ptr) := '4';
|
|
|
when 5 => r(ptr) := '5';
|
|
|
when 6 => r(ptr) := '6';
|
|
|
when 7 => r(ptr) := '7';
|
|
|
when 8 => r(ptr) := '8';
|
|
|
when 9 => r(ptr) := '9';
|
|
|
when others =>
|
|
|
assert false report lf & "TO_INT_STR, shouldn't happen"
|
|
|
severity failure;
|
|
|
return "$";
|
|
|
end case;
|
|
|
int := int / 10;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return format (r(ptr+1 to 32),decimal,rtn_len,justify,basespec);
|
|
|
end if;
|
|
|
end to_int_str;
|
|
|
|
|
|
function to_int_str(x : std_logic_vector;
|
|
|
rtn_len : natural := 0;
|
|
|
justify : justify_side := right;
|
|
|
basespec : b_spec := yes)
|
|
|
return string is
|
|
|
begin
|
|
|
return to_int_str(to_nat(x),rtn_len,justify,basespec);
|
|
|
end to_int_str;
|
|
|
|
|
|
|
|
|
function to_time_str (x : time)
|
|
|
return string is
|
|
|
begin
|
|
|
return to_int_str(to_nat(x),basespec=>no) & " ns";
|
|
|
end to_time_str;
|
|
|
|
|
|
function fill (fill_char : character := '*';
|
|
|
rtn_len : integer := 1)
|
|
|
return string is
|
|
|
variable r : string(1 to max(rtn_len,1)) := (others => fill_char);
|
|
|
variable len : integer;
|
|
|
begin
|
|
|
if rtn_len < 2 then -- always returns at least 1 fill char
|
|
|
len := 1;
|
|
|
else
|
|
|
len := rtn_len;
|
|
|
end if;
|
|
|
return r(1 to len);
|
|
|
end fill;
|
|
|
|
|
|
function to_nat(x : std_logic_vector) return natural is
|
|
|
-- assumes x is an unsigned number, lsb on right,
|
|
|
-- more than 31 bits are truncated on left
|
|
|
variable t : std_logic_vector(1 to x'length) := x;
|
|
|
variable int : std_logic_vector(1 to 31) := (others => '0');
|
|
|
variable r : natural := 0;
|
|
|
variable place : positive := 1;
|
|
|
begin
|
|
|
if x'length < 32 then
|
|
|
int(max(32-x'length,1) to 31) := t(1 to x'length);
|
|
|
else -- x'length >= 32
|
|
|
int(1 to 31) := t(x'length-30 to x'length);
|
|
|
end if;
|
|
|
for i in int'reverse_range loop
|
|
|
case int(i) is
|
|
|
when '1' | 'H' => r := r + place;
|
|
|
when '0' | 'L' => null;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"TO_NAT found illegal value: " & to_bin_str(int(i)) & lf &
|
|
|
"converting input to integer 0"
|
|
|
severity warning;
|
|
|
return 0;
|
|
|
end case;
|
|
|
exit when i=1;
|
|
|
place := place * 2;
|
|
|
end loop;
|
|
|
return r;
|
|
|
end to_nat;
|
|
|
|
|
|
function to_nat (x : std_logic)
|
|
|
return natural is
|
|
|
begin
|
|
|
case x is
|
|
|
when '0' => return 0 ;
|
|
|
when '1' => return 1 ;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"TO_NAT found illegal value: " & to_bin_str(x) & lf &
|
|
|
"converting input to integer 0"
|
|
|
severity warning;
|
|
|
return 0;
|
|
|
end case;
|
|
|
end to_nat;
|
|
|
|
|
|
function to_nat (x : time)
|
|
|
return natural is
|
|
|
begin
|
|
|
return x / 1 ns;
|
|
|
end to_nat;
|
|
|
|
|
|
function h(x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector is
|
|
|
-- if rtn_len is < than x'length*4, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 9 or a,A to f,F or
|
|
|
-- x,X,z,Z,u,U,-,w,W,
|
|
|
-- those result bits will be set to 0
|
|
|
variable int : string(1 to x'length) := x;
|
|
|
variable size: positive := max(x'length*4,rtn_len);
|
|
|
variable ptr : integer range -3 to size := size;
|
|
|
variable r : std_logic_vector(1 to size) := (others=>'0');
|
|
|
begin
|
|
|
for i in int'reverse_range loop
|
|
|
case int(i) is
|
|
|
when '0' => r(ptr-3 to ptr) := "0000";
|
|
|
when '1' => r(ptr-3 to ptr) := "0001";
|
|
|
when '2' => r(ptr-3 to ptr) := "0010";
|
|
|
when '3' => r(ptr-3 to ptr) := "0011";
|
|
|
when '4' => r(ptr-3 to ptr) := "0100";
|
|
|
when '5' => r(ptr-3 to ptr) := "0101";
|
|
|
when '6' => r(ptr-3 to ptr) := "0110";
|
|
|
when '7' => r(ptr-3 to ptr) := "0111";
|
|
|
when '8' => r(ptr-3 to ptr) := "1000";
|
|
|
when '9' => r(ptr-3 to ptr) := "1001";
|
|
|
when 'a'|'A' => r(ptr-3 to ptr) := "1010";
|
|
|
when 'b'|'B' => r(ptr-3 to ptr) := "1011";
|
|
|
when 'c'|'C' => r(ptr-3 to ptr) := "1100";
|
|
|
when 'd'|'D' => r(ptr-3 to ptr) := "1101";
|
|
|
when 'e'|'E' => r(ptr-3 to ptr) := "1110";
|
|
|
when 'f'|'F' => r(ptr-3 to ptr) := "1111";
|
|
|
when 'U' => r(ptr-3 to ptr) := "UUUU";
|
|
|
when 'X' => r(ptr-3 to ptr) := "XXXX";
|
|
|
when 'Z' => r(ptr-3 to ptr) := "ZZZZ";
|
|
|
when 'W' => r(ptr-3 to ptr) := "WWWW";
|
|
|
when 'H' => r(ptr-3 to ptr) := "HHHH";
|
|
|
when 'L' => r(ptr-3 to ptr) := "LLLL";
|
|
|
when '-' => r(ptr-3 to ptr) := "----";
|
|
|
when '_' => ptr := ptr + 4;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"O conversion found illegal input character: " &
|
|
|
int(i) & lf & "converting character to '----'"
|
|
|
severity warning;
|
|
|
r(ptr-3 to ptr) := "----";
|
|
|
end case;
|
|
|
ptr := ptr - 4;
|
|
|
end loop;
|
|
|
return r(size-rtn_len+1 to size);
|
|
|
end h;
|
|
|
|
|
|
function d (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector is
|
|
|
-- if rtn_len is < than binary length of x, result will be truncated on
|
|
|
-- the left
|
|
|
-- if x is other than characters 0 to 9, result will be 0
|
|
|
begin
|
|
|
return to_slv(cnvt_base(x,10),rtn_len);
|
|
|
end d;
|
|
|
|
|
|
function o (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector is
|
|
|
-- if rtn_len is < than x'length*3, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 7 or or x,X,z,Z,u,U,-,w,W,
|
|
|
-- those result bits will be set to 0
|
|
|
variable int : string(1 to x'length) := x;
|
|
|
variable size: positive := max(x'length*3,rtn_len);
|
|
|
variable ptr : integer range -2 to size := size;
|
|
|
variable r : std_logic_vector(1 to size) := (others=>'0');
|
|
|
begin
|
|
|
for i in int'reverse_range loop
|
|
|
case int(i) is
|
|
|
when '0' => r(ptr-2 to ptr) := "000";
|
|
|
when '1' => r(ptr-2 to ptr) := "001";
|
|
|
when '2' => r(ptr-2 to ptr) := "010";
|
|
|
when '3' => r(ptr-2 to ptr) := "011";
|
|
|
when '4' => r(ptr-2 to ptr) := "100";
|
|
|
when '5' => r(ptr-2 to ptr) := "101";
|
|
|
when '6' => r(ptr-2 to ptr) := "110";
|
|
|
when '7' => r(ptr-2 to ptr) := "111";
|
|
|
when 'U' => r(ptr-2 to ptr) := "UUU";
|
|
|
when 'X' => r(ptr-2 to ptr) := "XXX";
|
|
|
when 'Z' => r(ptr-2 to ptr) := "ZZZ";
|
|
|
when 'W' => r(ptr-2 to ptr) := "WWW";
|
|
|
when 'H' => r(ptr-2 to ptr) := "HHH";
|
|
|
when 'L' => r(ptr-2 to ptr) := "LLL";
|
|
|
when '-' => r(ptr-2 to ptr) := "---";
|
|
|
when '_' => ptr := ptr + 3;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"O conversion found illegal input character: " &
|
|
|
int(i) & lf & "converting character to '---'"
|
|
|
severity warning;
|
|
|
r(ptr-2 to ptr) := "---";
|
|
|
end case;
|
|
|
ptr := ptr - 3;
|
|
|
end loop;
|
|
|
return r(size-rtn_len+1 to size);
|
|
|
end o;
|
|
|
|
|
|
function b (x : string;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector is
|
|
|
-- if rtn_len is < than x'length, result will be truncated on the left
|
|
|
-- if x is other than characters 0 to 1 or x,X,z,Z,u,U,-,w,W,
|
|
|
-- those result bits will be set to 0
|
|
|
variable int : string(1 to x'length) := x;
|
|
|
variable size: positive := max(x'length,rtn_len);
|
|
|
variable ptr : integer range 0 to size+1 := size; -- csa
|
|
|
variable r : std_logic_vector(1 to size) := (others=>'0');
|
|
|
begin
|
|
|
for i in int'reverse_range loop
|
|
|
case int(i) is
|
|
|
when '0' => r(ptr) := '0';
|
|
|
when '1' => r(ptr) := '1';
|
|
|
when 'U' => r(ptr) := 'U';
|
|
|
when 'X' => r(ptr) := 'X';
|
|
|
when 'Z' => r(ptr) := 'Z';
|
|
|
when 'W' => r(ptr) := 'W';
|
|
|
when 'H' => r(ptr) := 'H';
|
|
|
when 'L' => r(ptr) := 'L';
|
|
|
when '-' => r(ptr) := '-';
|
|
|
when '_' => ptr := ptr + 1;
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"B conversion found illegal input character: " &
|
|
|
int(i) & lf & "converting character to '-'"
|
|
|
severity warning;
|
|
|
r(ptr) := '-';
|
|
|
end case;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return r(size-rtn_len+1 to size);
|
|
|
end b;
|
|
|
|
|
|
function h (x : string)
|
|
|
return natural is
|
|
|
-- only following characters are allowed, otherwise result will be 0
|
|
|
-- 0 to 9
|
|
|
-- a,A to f,F
|
|
|
-- blanks, underscore
|
|
|
begin
|
|
|
return cnvt_base(x,16);
|
|
|
end h;
|
|
|
|
|
|
function d (x : string)
|
|
|
return natural is
|
|
|
-- only following characters are allowed, otherwise result will be 0
|
|
|
-- 0 to 9
|
|
|
-- blanks, underscore
|
|
|
begin
|
|
|
return cnvt_base(x,10);
|
|
|
end d;
|
|
|
|
|
|
function o (x : string)
|
|
|
return natural is
|
|
|
-- only following characters are allowed, otherwise result will be 0
|
|
|
-- 0 to 7
|
|
|
-- blanks, underscore
|
|
|
begin
|
|
|
return cnvt_base(x,8);
|
|
|
end o;
|
|
|
|
|
|
function b (x : string)
|
|
|
return natural is
|
|
|
-- only following characters are allowed, otherwise result will be 0
|
|
|
-- 0 to 1
|
|
|
-- blanks, underscore
|
|
|
begin
|
|
|
return cnvt_base(x,2);
|
|
|
end b;
|
|
|
|
|
|
function to_slv(x : natural;
|
|
|
rtn_len : positive range 1 to 32 := 32)
|
|
|
return std_logic_vector is
|
|
|
-- if rtn_len is < than sizeof(x), result will be truncated on the left
|
|
|
variable int : natural := x;
|
|
|
variable ptr : positive := 32;
|
|
|
variable r : std_logic_vector(1 to 32) := (others=>'0');
|
|
|
begin
|
|
|
while int > 0 loop
|
|
|
case int rem 2 is
|
|
|
when 0 => r(ptr) := '0';
|
|
|
when 1 => r(ptr) := '1';
|
|
|
when others =>
|
|
|
assert false report lf & "TO_SLV, shouldn't happen"
|
|
|
severity failure;
|
|
|
return "0";
|
|
|
end case;
|
|
|
int := int / 2;
|
|
|
ptr := ptr - 1;
|
|
|
end loop;
|
|
|
return r(33-rtn_len to 32);
|
|
|
end to_slv;
|
|
|
|
|
|
function to_sl(x : natural)
|
|
|
return std_logic is
|
|
|
variable r : std_logic := '0';
|
|
|
begin
|
|
|
case x is
|
|
|
when 0 => null;
|
|
|
when 1 => r := '1';
|
|
|
when others =>
|
|
|
assert false
|
|
|
report lf &
|
|
|
"TO_SL found illegal input character: " &
|
|
|
to_int_str(x) & lf & "converting character to '-'"
|
|
|
severity warning;
|
|
|
return '-';
|
|
|
end case;
|
|
|
return r;
|
|
|
end to_sl;
|
|
|
|
|
|
function to_time (x: natural) return time is
|
|
|
begin
|
|
|
return x * 1 ns;
|
|
|
end to_time;
|
|
|
|
|
|
END conversions;
|
|
|
|