libfst 0.1.0

data/samples/create_file.rb

@@ -0,0 +1,69 @@
+#!/usr/bin/env ruby
+
+require 'libfst'
+
+fst = LibFST::Writer.new 'out.fst'
+
+fst.set_date_string 'Wed Apr 17 21:40:39 2024'
+fst.set_version_string __FILE__
+fst.set_comment 'This is a comment'
+fst.set_file_type :vhdl
+fst.set_time_scale :ns
+
+fst.set_scope(:vcd_module, name: 'testbench')
+clk = fst.create_variable('clk', type: :sv_logic)
+fst.set_scope(:vcd_module, name: 'uart')
+rx = fst.create_variable('rx', type: :sv_logic, direction: :input)
+data = fst.create_variable('data', type: :sv_logic, direction: :output, length: 8)
+fst.create_variable(alias_of: clk, direction: :input)
+cnt = fst.create_variable('cnt', type: :vcd_integer)
+fst.set_upscope
+fst.set_scope(:vcd_module, name: 'analog')
+ch0 = fst.create_variable('ch0', type: :vcd_real)
+fst.set_upscope
+fst.set_upscope
+
+message = 'Hello, world!'.bytes
+clk_period = 1000
+time = 0
+fst.emit_time_change(time)
+clock = 0
+clk.value = clock
+rx.value = 1
+cnt.value = 0
+counter = 0
+byte = nil
+bit_cnt = -2
+
+
+loop do
+  time += clk_period
+  fst.emit_time_change(time)
+  ch0.value = 1.65 + 1.25*(Math.sin(2*Math::PI*4*time/1400000) + 0.5*(rand()-0.5))
+
+  clock ^= 1
+  clk.value = clock
+
+  counter += 1
+  if counter >= 10 then
+    counter = 0
+    bit_cnt += 1
+    if bit_cnt == -1 then # start bit
+      rx.value = 0
+      byte = message.shift
+    elsif bit_cnt < 8 then
+      break if byte.nil?
+      rx.value = byte[bit_cnt]
+    elsif bit_cnt == 8 then # stop bit 1
+      rx.value = 1
+      data.value = byte
+    else # stop bit 2
+      bit_cnt = -2
+    end
+  end
+  cnt.value = counter
+end
+
+
+fst.close # The writer instance should not be used after it has been closed
+

data/samples/out.gtkw

@@ -0,0 +1,46 @@
+[*]
+[*] GTKWave Analyzer v3.3.114 (w)1999-2023 BSI
+[*] Wed Apr 17 21:16:36 2024
+[*]
+[dumpfile] "/home/theotime/Documents/gitlab/libfst.rb/samples/out.fst"
+[dumpfile_mtime] "Wed Apr 17 21:12:00 2024"
+[dumpfile_size] 12182
+[savefile] "/home/theotime/Documents/gitlab/libfst.rb/samples/out.gtkw"
+[timestart] 0
+[size] 990 397
+[pos] 351 815
+*-19.029329 451000 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1
+[treeopen] testbench.
+[sst_width] 270
+[signals_width] 148
+[sst_expanded] 1
+[sst_vpaned_height] 97
+@10022
+[color] 3
+testbench.analog.ch0
+@20000
+-
+-
+-
+@22
+testbench.clk
+@420
+[color] 6
+testbench.uart.cnt
+@28
+testbench.uart.rx
+@c00820
+testbench.uart.data[7:0]
+@28
+(0)testbench.uart.data[7:0]
+(1)testbench.uart.data[7:0]
+(2)testbench.uart.data[7:0]
+(3)testbench.uart.data[7:0]
+(4)testbench.uart.data[7:0]
+(5)testbench.uart.data[7:0]
+(6)testbench.uart.data[7:0]
+(7)testbench.uart.data[7:0]
+@1401200
+-group_end
+[pattern_trace] 1
+[pattern_trace] 0

data/samples/read2.rb

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'libfst'
+
+fst = LibFST::Reader.new 'skinny_rand.fst'
+
+puts fst.root.tree
+

data/samples/read_file.rb

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'libfst'
+
+fst = LibFST::Reader.new 'out.fst'
+
+puts fst.root.tree
+

data/samples/transaction_filter_process/full_boot.gtkw

@@ -0,0 +1,39 @@
+[*]
+[*] GTKWave Analyzer v3.3.116 (w)1999-2023 BSI
+[*] Tue May 21 09:46:25 2024
+[*]
+[dumpfile] "/home/theotime/Documents/gitlab/libfst.rb/samples/transaction_filter_process/full_boot.fst"
+[dumpfile_mtime] "Mon May 13 08:40:48 2024"
+[dumpfile_size] 16822
+[savefile] "/home/theotime/Documents/gitlab/libfst.rb/samples/transaction_filter_process/full_boot.gtkw"
+[timestart] 39796500
+[size] 3486 534
+[pos] -1 -1
+*-16.663563 40003820 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1
+[sst_width] 258
+[signals_width] 329
+[sst_expanded] 1
+[sst_vpaned_height] 118
+@28
+clk
+cmd
+dat0
+@10c00028
+[transaction_args] ""
+^<1 /home/theotime/Documents/gitlab/libfst.rb/samples/transaction_filter_process/sdcard.rb
+#{sdcard} clk cmd
+@28
+clk
+cmd
+@1401200
+-group_end
+@200
+-
+@28
+uart
+@10000028
+[transaction_args] "baudrate = 115200"
+^<2 /home/theotime/Documents/gitlab/libfst.rb/samples/transaction_filter_process/uart.rb
++{uart_decode} uart
+[pattern_trace] 1
+[pattern_trace] 0