From 6961d5453fee78b6e968de1792ce880c2c751fbf Mon Sep 17 00:00:00 2001
From: Fabien Marteau
Date: Tue, 3 Jan 2017 09:26:46 +0100
Subject: Adding a BlackBox example in code documentation

---
 chiselFrontend/src/main/scala/chisel3/core/BlackBox.scala | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

(limited to 'chiselFrontend/src/main/scala/chisel3/core')

diff --git a/chiselFrontend/src/main/scala/chisel3/core/BlackBox.scala b/chiselFrontend/src/main/scala/chisel3/core/BlackBox.scala
index 85a57111..fc659ded 100644
--- a/chiselFrontend/src/main/scala/chisel3/core/BlackBox.scala
+++ b/chiselFrontend/src/main/scala/chisel3/core/BlackBox.scala
@@ -23,7 +23,19 @@ case class RawParam(value: String) extends Param
   *
   * @example
   * {{{
-  * ... to be written once a spec is finalized ...
+  * import chisel3._
+  * import chisel3.experimental._
+  *
+  * // Example with Xilinx differential buffer IBUFDS
+  * class IBUFDS extends BlackBox(Map("DIFF_TERM" -> "TRUE", // Verilog parameters
+  *                                   "IOSTANDARD" -> "DEFAULT"
+  *                      )) {
+  *   val io = IO(new Bundle {
+  *     val O = Output(Clock()) // IO names will be the same
+  *     val I = Input(Clock())  // (without 'io_' in prefix)
+  *     val IB = Input(Clock()) //
+  *   })
+  * }
   * }}}
   * @note The parameters API is experimental and may change
   */
-- 
cgit v1.2.3