wcdma_bb 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 74b606e01ba9ed9f75cd5817616ebeeffe6aac40
-  data.tar.gz: c3d5a77d1c91af54c6278fb174f3ee69d2841899
+  metadata.gz: ab5ead80aefe54e00afea4b50c8fd7978ea21228
+  data.tar.gz: 9b37cd9452a8579db93432fd2fb4541c4abda3fc
 SHA512:
-  metadata.gz: f46acef60669d522a8eac124d3a14febef7559c5dcf1aa13cac7779ef608a2d21a6ccab727c5da1586545c6e96215290f963998040f0ff44634ef67b04639b4f
-  data.tar.gz: c70b3622f70f4b8e427a3caae84fa489a8449f56974f6d4348afe344e14bc05fa4a2f51837fbaa246c35235a50f354b6999ca608f3bbc119585ede591d7774e6
+  metadata.gz: 61638c9169a25860a5c313edf38ef643c9e1b3c0609309327b895701b619e8b445c6f30c9bfc34acfa47f44e3006975d148addc081f4b9b23f4661fd8912e556
+  data.tar.gz: de6446a0fefe6f1a2b87c90aac05ca5e51d110431f4933076a9f90b4efbf5a96e4729bced4a72ae1559b7e4434503984ff93e9f73f90bb796031b6ea5c9a397b

data/bin/wcdma_bb

@@ -1,4 +1,30 @@
 #!/usr/bin/env ruby
 
+require 'optparse'
 require 'wcdma_bb'
-puts WcdmaBb.hi
+
+options = {}
+
+optparser = OptionParser.new do |opts|
+    opts.banner = "Usage: wcdma_bb [options]"
+    options[:search_acronym] = nil
+    opts.on('--search_acronym PATTERN', 'Get full name of acronyms that match PATTERN') do |pattern|
+        options[:search_acronym] = pattern
+    end
+    opts.on('-h', '--help', 'Display help information') do
+        puts opts
+        exit
+    end
+end
+
+optparser.parse!
+
+if options[:search_acronym]
+    result = Acronym.search_acronym(options[:search_acronym])
+    result.each { |key, values|
+        puts "%-10s\t%s" % [key, values[0]]
+        values[1..-1].each { |v|
+            puts "%-10s\t%s" % ["", v]
+        }
+    }
+end

data/lib/wcdma_bb.rb

@@ -1,5 +1,8 @@
+require 'wcdma_bb/rel10/ts25_211'
+
 class WcdmaBb
     def self.hi
         puts "Hello world!"
+        "Hello world!"
     end
 end

data/lib/wcdma_bb/acronym.rb

@@ -0,0 +1,40 @@
+
+# Collect, hold, and look up all acronyms
+# @author Michael Duo Ling
+class Acronym
+
+    # a hash containing all acronyms: string => array of strings
+    @@acronyms = Hash.new
+
+    # Store acronym => fullname pair
+    # @param acronym [String] the abbreviation
+    # @param fullname [String] the full name
+    # @return [nil] nothing
+    def self.add(acronym, fullname)
+        values = @@acronyms.fetch(acronym, Array.new)
+        if not values.include?(fullname)
+            values << fullname
+            @@acronyms[acronym] = values
+        end
+    end
+
+    # Look up for one acronym pattern
+    # @param pattern [String] acronym pattern (regex)
+    # @return [Hash] acronym => array of fullnames for all acronyms that match given pattern
+    def self.search_acronym(pattern)
+        result = Hash.new
+        pattern = Regexp.new(pattern)
+        @@acronyms.each { |key, value|
+            if pattern.match(key)
+                result[key] = value
+            end
+        }
+        return result
+    end
+
+    # Clear all saved acronyms
+    # @return [nil] nothing
+    def self.clear()
+        @@acronyms = Hash.new
+    end
+end

data/lib/wcdma_bb/rel10/ts25_211.rb

@@ -0,0 +1,95 @@
+require 'wcdma_bb/acronym'
+
+# 4 Services offered to higher layers
+# 4.1 Transport channels
+Acronym.add('DCH',      'Dedicated Channel')
+Acronym.add('E-DCH',    'Enhanced Dedicated Channel')
+Acronym.add('BCH',      'Broadcast Channel')
+Acronym.add('FACH',     'Forward Access Channel')
+Acronym.add('PCH',      'Paging Channel')
+Acronym.add('RACH',     'Random Access Channel')
+Acronym.add('HS-DSCH',  'High Speed Downlink Shared Channel')
+
+# 4.2 Indicators
+Acronym.add('AI',       'Acquisition Indicator')
+Acronym.add('PI',       'Page Indicator')
+Acronym.add('NI',       'MBMS Notification Indicator')
+Acronym.add('ICH',      'Indicator Channel')
+
+# 5 Physical channels and physical signals
+Acronym.add('CCTrCH',   'Composite Coded Transport Channel')
+
+# number of chips in one radio frame
+RADIO_FRAME_LENGTH_IN_CHIPS = 38400
+# number of chips in one slot
+SLOT_LENGTH_IN_CHIPS        = 2560
+# number of chips in one subframe
+SUBFRAME_LENGTH_IN_CHIPS    = 7680
+
+# 5.1 Physical signals
+
+# 5.2 Uplink physical channels
+# 5.2.1 Dedicated uplink physical channels
+
+# types of uplink dedicated physical channels
+UL_DEDICATED_PHY_CHANNEL_LIST   = ["DPDCH", "DPCCH", "E-DPDCH", "E-DPCCH", "HS-DPCCH"]
+
+Acronym.add('TPC',      'Transmit Power-Control')
+Acronym.add('TFCI',     'Transport-Format Combination Indicator')
+Acronym.add('FBI',      'Feedback Information')
+
+# 5.2.1.1 DPCCH and DPDCH
+
+# length of one slot in chips
+T__slot = SLOT_LENGTH_IN_CHIPS
+
+Acronym.add('SF',   'Spreading Factor')
+
+# Base class for all physical channels
+class PhysicalChannel
+
+    # Calc perameter k
+    # @param sf [Integer] spreading factor
+    # @param max_sf [Integer] maximum SF, e.g. 4 for DPDCH
+    # @param min_sf [Integer] minimum SF, e.g. 256 for DPDCH
+    # @return [Integer] k, parameter k that determines the number of bits per slot
+    def self.k(sf:, max_sf:, min_sf:)
+        raise 'SF=%s is out of range ([%s..%s])' % [sf, max_sf, min_sf] if not sf.between?(max_sf, min_sf)
+        return Math.log2(256/sf).to_i
+    end
+
+    # Calc number of bits per slot
+    # @param k [Integer]
+    # @return [Integer] number of bits per slot
+    def self.N__data(k:)
+        return 10 * (2 ** k)
+    end
+end
+
+class UplinkDPDCH < PhysicalChannel
+    @@DPDCH_MIN_SF_FACTOR = 256
+    @@DPDCH_MAX_SF_FACTOR = 4
+
+    attr_reader :sf, :k, :N__data
+
+    # Create a new instance
+    # @param sf [Integer] spreading factor
+    # @return [UplinkDPDCH] a new instance of this class
+    def initialize(sf)
+        @sf = sf
+        @k  = self.class.k(sf: @sf, max_sf: @@DPDCH_MAX_SF_FACTOR, min_sf: @@DPDCH_MIN_SF_FACTOR)
+        @N__data = self.class.N__data(k: @k)
+    end
+end
+
+class UplinkDPCCH < PhysicalChannel
+    @@SF = 256
+
+    attr_reader :sf, :k, :N__data
+
+    def initialize()
+        @sf = @@SF
+        @k  = self.class.k(sf: @sf, max_sf: @@SF, min_sf: @@SF)
+        @N__data = self.class.N__data(k: @k)
+    end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wcdma_bb
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Michael Duo Ling
@@ -19,6 +19,8 @@ extra_rdoc_files: []
 files:
 - bin/wcdma_bb
 - lib/wcdma_bb.rb
+- lib/wcdma_bb/acronym.rb
+- lib/wcdma_bb/rel10/ts25_211.rb
 homepage: http://rubygems.org/gems/wcdma_bb
 licenses:
 - MIT
@@ -44,3 +46,4 @@ signing_key:
 specification_version: 4
 summary: WCDMA baseband in Ruby
 test_files: []
+has_rdoc: