Added DPI-C documentation to README file
authorClifford Wolf <clifford@clifford.at>
Fri, 22 Aug 2014 12:37:14 +0000 (14:37 +0200)
committerClifford Wolf <clifford@clifford.at>
Fri, 22 Aug 2014 12:37:14 +0000 (14:37 +0200)
README

diff --git a/README b/README
index 5c3286c20e3ea62cab8a66d119407e5db25ac278..2e713ffef40c1639b611c6a44a699236b75a65f0 100644 (file)
--- a/README
+++ b/README
@@ -317,6 +317,18 @@ Verilog Attributes and non-standard features
         ...
       endmodule
 
+- A limited subset of DPI-C functions is supported. The plugin mechanism
+  (see "help plugin") can be used load .so files with implementations of
+  DPI-C routines. As a non-standard extension it is possible to specify
+  a plugin alias using the "<alias>:" syntax. for example:
+
+      module dpitest;
+        import "DPI-C" function foo:round = real my_round (real);
+        parameter real r = my_round(12.345);
+      endmodule
+
+      $ yosys -p 'plugin -a foo -i /lib/libm.so; read_verilog dpitest.v'
+
 - Sized constants (the syntax <size>'s?[bodh]<value>) support constant
   expressions as <size>. If the expresion is not a simple identifier, it
   must be put in parentheses. Examples: WIDTH'd42, (4+2)'b101010