Initial files with license agreement

README.md

-# gtxe2_nosecureip
+GTXE2_CHANNEL_GPL.v is a non-synthesizable open-source replacement for a propriate xilinx's primitive GTXE2_CHANNEL.v
+For now only basic features are implemented : OOB, comma aligment, 10-8 encoding/decoding, clocking scheme. 
+Still, that is enough to run SATA protocol implementation simulation.

gtxe2_channel/clock_divider.v

+/*******************************************************************************
+ * Module: clock_divider
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: Non-sinthesizable clock divider
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * clock_divider.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * clock_divider.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
+ /**
+  * Divides input clock either by input 'div' or by parameter 'divide_by' if divide_by_param
+  * was set to 1
+  **/
 `ifndef CLOCK_DIVIDER_V
 `define CLOCK_DIVIDER_V
 // non synthesisable!

gtxe2_channel/gtxe2_chnl.v

+/*******************************************************************************
+ * Module: gtxe2_chnl
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: top-level module gtxe2_chnl = tx + rx + clocking
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_chnl_clocking.v"
 `include "gtxe2_chnl_tx.v"
 `include "gtxe2_chnl_rx.v"

gtxe2_channel/gtxe2_chnl_clocking.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_clocking
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: channel's clocking top-level. Places muxes, plls, dividers,
+ *              as they're depicted @ xilinx's ug476 p.36, p.46, p. 150, p. 211
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_clocking.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_clocking.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_chnl_cpll_inmux.v"
 `include "gtxe2_chnl_outclk_mux.v"
 `include "gtxe2_chnl_cpll.v"

gtxe2_channel/gtxe2_chnl_cpll.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_cpll
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: non-synthesizable pll implementation
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_cpll.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_cpll.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_chnl_cpll_def.v"
 module gtxe2_chnl_cpll(
 // top-level interfaces

gtxe2_channel/gtxe2_chnl_cpll_inmux.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_cpll_inmux
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: non-sinthesizable clock multiplexer, used in clocking scheme
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_cpll_inmux.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_cpll_inmux.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 // cpll reference clock mux
 module gtxe2_chnl_cpll_inmux(
     input   wire    [2:0]   CPLLREFCLKSEL,

gtxe2_channel/gtxe2_chnl_outclk_mux.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_cpll_outmux
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: non-sinthesizable clock multiplexer, used in clocking scheme
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_cpll_outmux.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_cpll_outmux.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 module gtxe2_chnl_outclk_mux(
     input   wire            TXPLLREFCLK_DIV1,
     input   wire            TXPLLREFCLK_DIV2,

gtxe2_channel/gtxe2_chnl_rx.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_rx
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: reciever top-level. Also includes polarity-inversion logic
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_rx.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_rx.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
+ /**
+  * For now contains only deserializer, oob, 10x8 decoder, aligner and polarity invertor blocks
+  **/
 `include "gtxe2_chnl_rx_des.v"
 `include "gtxe2_chnl_rx_oob.v"
 `include "gtxe2_chnl_rx_10x8dec.v"
@@ -144,6 +167,7 @@ aligner(
     .RXMCOMMAALIGNEN    (RXMCOMMAALIGNEN)
 );
 
+// 10x8 decoder
 gtxe2_chnl_rx_10x8dec #(
     .iwidth             (internal_data_width),
     .owidth             (RX_DATA_WIDTH),

gtxe2_channel/gtxe2_chnl_rx_10x8dec.v

-// always enabled
+/*******************************************************************************
+ * Module: gtxe2_chnl_rx_10x8dec
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: 10x8 decoder implementation, has reduced parameterization abilities
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_rx_10x8dec.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_rx_10x8dec.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
+// always enabled, wasnt tested with width parameters, disctinct from 20
 module gtxe2_chnl_rx_10x8dec #(
     parameter iwidth = 20,
     parameter owidth = 20,

gtxe2_channel/gtxe2_chnl_rx_align.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_rx_align
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: reciever's comma-aligner implementation
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_rx_align.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_rx_align.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 module gtxe2_chnl_rx_align #(
     parameter width = 20,
     parameter   [9:0]   ALIGN_MCOMMA_VALUE  = 10'b1010000011,
@@ -30,6 +50,7 @@ localparam  window_size = width;//comma_width + width;
 reg     [width - 1:0]       indata_r;
 wire    [width*2 - 1:0]     data;
 
+// looking for matches in all related bit history - in 'data'
 assign  data    = {indata, indata_r};//{indata_r, indata};
 always @ (posedge clk)
     indata_r <= indata;
@@ -53,7 +74,7 @@ end
 endgenerate
 
 // so, comma_match indicates bits, from whose comma/doublecomma (or commas) occurs in the window buffer
-// all we need from now is to get one of these bits = [x] and say [x+width-1:x] is an aligned data
+// all we need from now is to get one of these bits, [x], and say [x+width-1:x] is an aligned data
 
 // doing it in a hard way
 generate
@@ -63,6 +84,7 @@ begin: filter_comma_pos
 end
 endgenerate
 assign  comma_pos[0] = comma_match[0];
+// so, comma_pos's '1' indicates the first comma occurence. there is only one '1' in the vector
 
 function integer clogb2;
     input [31:0] value;
@@ -83,6 +105,7 @@ endfunction
 
 localparam pwidth = clogb2(width * 2 -1);
 
+// decoding (finding an index, representing '1' in comma_pos)
 wire    [pwidth - 1:0]      pointer;
 reg     [pwidth - 1:0]      pointer_latched;
 wire                        pointer_set;

gtxe2_channel/gtxe2_chnl_rx_des.v

-// 20-bit width only, for now
-// assuming inclk and outclk are completely aligned (have the same source)
+/*******************************************************************************
+ * Module: gtxe2_chnl_rx_des
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: 1xwidth deserializer
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_rx_des.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_rx_des.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "resync_fifo_nonsynt.v"
 module gtxe2_chnl_rx_des #(
     parameter [31:0] width = 20
@@ -9,9 +27,7 @@ module gtxe2_chnl_rx_des #(
     input   wire                    inclk,
     input   wire                    outclk,
     input   wire                    indata,
-//    input   wire                    idle_in,
     output  wire    [width - 1:0]   outdata
-//    output  wire                    idle_out
 );
 
 reg     [31:0]          bitcounter;

gtxe2_channel/gtxe2_chnl_rx_oob.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_rx_oob
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: oob detector
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_rx_oob.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_rx_oob.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
+// doesnt support global parameters for now. instead uses localparams
+// in case global parameters are needed, have to translate them in terms of localparams
 module gtxe2_chnl_rx_oob #(
     parameter width = 20,
 
+// parameters are not used for now
     parameter   [2:0]   SATA_BURST_VAL  = 3'b100,
     parameter   [2:0]   SATA_EIDLE_VAL  = 3'b100,
     parameter           SATA_MIN_INIT   = 12,
@@ -23,7 +46,6 @@ module gtxe2_chnl_rx_oob #(
     output  wire            RXCOMWAKEDET
 );
 
-// parameters are not used for now
 
 localparam burst_min_len = 150;
 localparam burst_max_len = 340;

gtxe2_channel/gtxe2_chnl_tx.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_tx
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: transmitter top-level, includes polarity-inversion, bit-reordering
+ *              and elecidle logic
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_tx.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_tx.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_chnl_tx_ser.v"
 `include "gtxe2_chnl_tx_8x10enc.v"
 `include "gtxe2_chnl_tx_oob.v"

gtxe2_channel/gtxe2_chnl_tx_8x10enc.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_tx_8x10enc
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: 8x10 encoder
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_tx_8x10enc.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_tx_8x10enc.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
+// for some reason overall trasmitted disparity is tracked at the top level
 module gtxe2_chnl_tx_8x10enc #(
     parameter iwidth = 16,
     parameter owidth = 20
@@ -26,6 +47,9 @@ wire    [owidth - 1:0]      oword   [word_count - 1:0];
 wire    [iwidth - 1:0]      iword   [word_count - 1:0];
 wire    [word_count - 1:0]  is_control;
 
+// typical approach: 8x10 = 5x6 + 3x4
+// word disparity[i] = calculated disparity for the i-th 8-bit word
+// interm_disparity[i] - disparity after 5x6 encoding for the i-th word 
 genvar ii;
 generate
 for (ii = 0; ii < 2; ii = ii + 1)

gtxe2_channel/gtxe2_chnl_tx_oob.v

+/*******************************************************************************
+ * Module: gtxe2_chnl_tx_oob
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: oob block implementation
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_tx_oob.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_tx_oob.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 module gtxe2_chnl_tx_oob #(
     parameter width = 20
 )

gtxe2_channel/gtxe2_chnl_tx_ser.v

-// 20-bit width only, for now
-// assuming inclk and outclk are completely aligned (have the same source)
+/*******************************************************************************
+ * Module: gtxe2_chnl_tx_ser
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: widthx1 serializer
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_chnl_tx_ser.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_chnl_tx_ser.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "resync_fifo_nonsynt.v"
 module gtxe2_chnl_tx_ser #(
     parameter [31:0] width = 20

gtxe2_channel/resync_fifo_nonsynt.v

+/*******************************************************************************
+ * Module: resync_fifo_nonsynt
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: non-synthesizable resyncronization fifo
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * resync_fifo_nonsynt.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * resync_fifo_nonsynt.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 // simplified resynchronisation fifo, could cause metastability
 // because of that shall not be syntesisable
 // TODO add shift registers and gray code to fix that

gtxe2_common/gtxe2_comm_clocking.v

+/*******************************************************************************
+ * Module: gtxe2_comm_clocking
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: qpll top-level, for now
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_comm_clocking.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_comm_clocking.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_comm_qpll_inmux.v"
 `include "gtxe2_comm_qpll.v"
 module gtxe2_comm_clocking(

gtxe2_common/gtxe2_comm_qpll.v

+/*******************************************************************************
+ * Module: gtxe2_comm_qpll
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: qpll non-synthesizable implementation
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_comm_qpll.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_comm_qpll.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 `include "gtxe2_comm_qpll_def.v"
 module gtxe2_comm_qpll(
 // top-level interfaces

gtxe2_common/gtxe2_comm_qpll_inmux.v

+/*******************************************************************************
+ * Module: gtxe2_comm_qpll_inmux
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: non-synthesizable clock multiplexer
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * gtxe2_comm_qpll_inmux.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gtxe2_comm_qpll_inmux.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 module gtxe2_comm_qpll_inmux(
     input   wire    [2:0]   QPLLREFCLKSEL,
     input   wire            GTREFCLK0,

tb/test.v

+/*******************************************************************************
+ * Module: test
+ * Date: 2015-07-06  
+ * Author: Alexey     
+ * Description: Generates test payload for GTXE2_CHANNEL
+ *
+ * Copyright (c) 2015 Elphel, Inc.
+ * test.v is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * test.v file is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/> .
+ *******************************************************************************/
 /*
- * simple align test
+ * simple aligner test + oob + checking for a corrent decoding
  */
 module test(
     output  wire            reset,