def test_find_symbol_rate(self): self.test_name = 'find_symbol_rate() test' self.trial_count = 40 for i in xrange(self.trial_count): self.update_progress(i+1) freq = random.randrange(100, 10000) # construct a list of edges with random spans e = [] t = 0.0 for _ in xrange(200): n = random.randrange(1, 5) t += n / freq e.append((t,1)) # we maintain state at constant 1 since find_symbol_rate() doesn't care spectra = random.randrange(2, 5) for s in xrange(spectra, 1, -1): detected_rate = decode.find_symbol_rate(iter(e), spectra=s) if detected_rate > 0: break # assertAlmostEqual() can't evaluate the closeness of two integers # since it doesn't incorporate relative error equal = tsup.relativelyEqual(detected_rate, freq, epsilon=0.01) # print('sr', detected_rate, freq, equal) if not equal: print(' num spectra:', spectra) print(e) self.assertTrue(equal, msg='symbol rate mismatch {0} != {1}'.format(detected_rate, freq))
def __init__(self, channels, timescale=1.0e-12, date=None, comment=None): ''' channels (sequence of VCDChannel) A sequence of channel definitions timescale (float or string) Set the VCD timescale as a power of 10. If a float, the value is used to establish the timescale. If a string, it must match a channel name from channels. The symbol rate of the named channel is determined and a raw timescale is derived from 1.0 / (4 * symbol rate). In both cases the raw value will be coerced to a valid power of 10. date (datetime or None) An optional datetime for the VCD header. If absent the current time is used. comment (string or None) An optional comment to include in the header. Raises ValueError if the timescale channel cannot be found or the symbol rate cannot be determined. ''' self._date = date self.comment = comment self.channels = channels try: ts = float(timescale) except ValueError: # Assume it's a string # Find channel name in channels ts_data = None for c in self.channels: if c.name == timescale: ts_data = c.states break if ts_data is not None: sym_rate = decode.find_symbol_rate(iter(ts_data)) if sym_rate == 0: raise ValueError('Unable to determine automatic timescale') ts = 1.0 / (4 * sym_rate) else: raise ValueError('Channel not found: "{}"'.format(timescale)) self._timescale = coerce_timescale(ts)
def test_find_symbol_rate(self): self.test_name = 'find_symbol_rate() test' self.trial_count = 40 for i in xrange(self.trial_count): self.update_progress(i + 1) freq = random.randrange(100, 10000) # construct a list of edges with random spans e = [] t = 0.0 for _ in xrange(200): n = random.randrange(1, 5) t += n / freq e.append( (t, 1) ) # we maintain state at constant 1 since find_symbol_rate() doesn't care spectra = random.randrange(2, 5) for s in xrange(spectra, 1, -1): detected_rate = decode.find_symbol_rate(iter(e), spectra=s) if detected_rate > 0: break # assertAlmostEqual() can't evaluate the closeness of two integers # since it doesn't incorporate relative error equal = tsup.relativelyEqual(detected_rate, freq, epsilon=0.01) # print('sr', detected_rate, freq, equal) if not equal: print(' num spectra:', spectra) print(e) self.assertTrue(equal, msg='symbol rate mismatch {0} != {1}'.format( detected_rate, freq))
def ethernet_decode(rxtx, tag_ethertypes=None, logic_levels=None, stream_type=stream.StreamType.Samples): '''Decode an ethernet data stream This is a generator function that can be used in a pipeline of waveform procesing operations. Sample streams are a sequence of SampleChunk Objects. Edge streams are a sequence of 2-tuples of (time, int) pairs. The type of stream is identified by the stream_type parameter. Sample streams will be analyzed to find edge transitions representing 0 and 1 logic states of the waveforms. With sample streams, an initial block of data is consumed to determine the most likely logic levels in the signal. rxtx (iterable of SampleChunk objects or (float, int) pairs) A sample stream or edge stream representing a differential ethernet signal. tag_ethertypes (sequence of int or None) The ethertypes to use for identifying 802.1Q tags. Default is 0x8100, 0x88a8, and 0x9100. logic_levels ((float, float) or None) Optional pair that indicates (low, high) logic levels of the sample stream. When present, auto level detection is disabled. This has no effect on edge streams. stream_type (streaming.StreamType) A StreamType value indicating that the can parameter represents either Samples or Edges Yields a series of EthernetStreamFrame objects. Each frame contains subrecords marking the location of sub-elements within the frame. CRC errors are recorded as an error status in their respective subrecords. Raises AutoLevelError if stream_type = Samples and the logic levels cannot be determined. Raises StreamError if ethernet speed cannot be determined. ''' if stream_type == stream.StreamType.Samples: if logic_levels is None: s_rxtx_it, logic_levels = decode.check_logic_levels(rxtx) else: s_rxtx_it = rxtx hyst_thresholds = decode.gen_hyst_thresholds(logic_levels, expand=3, hysteresis=0.05) rxtx_it = decode.find_multi_edges(s_rxtx_it, hyst_thresholds) #print('## logic levels:', logic_levels, hyst_thresholds) else: # The streams are already lists of edges rxtx_it = rxtx # Detect speed of ethernet buf_edges = 150 min_edges = 100 # tee off an iterator to determine speed class rxtx_it, speed_check_it = itertools.tee(rxtx_it) # Remove Diff-0's #FIX: need to modify to work with 100Mb and 1Gb Enet speed_check_it = (edge for edge in speed_check_it if edge[1] != 0) symbol_rate_edges = itertools.islice(speed_check_it, buf_edges) # We need to ensure that we can pull out enough edges from the iterator slice # Just consume them all for a count sre_list = list(symbol_rate_edges) if len(sre_list) < min_edges: raise stream.StreamError( 'Unable to determine Ethernet speed (not enough edge transitions)') del speed_check_it #print('## sym. rate edges len:', len(sre_list)) raw_symbol_rate = decode.find_symbol_rate(iter(sre_list), spectra=2) #print('### raw sym rate:', raw_symbol_rate) # For 10baseT (10MHz Manchester) the symbol rate will be 20MHz # For 100BaseTX the symbol rate will be 31.25MHz? if raw_symbol_rate < 25e6: bit_period = 1.0 / 10.0e6 else: raise stream.StreamError('Unsupported Ethernet speed: {}'.format( eng_si(raw_symbol_rate, 'Hz'))) if stream_type == stream.StreamType.Samples: # We needed the bus speed before we could properly strip just # the anomalous SE0s min_se0 = bit_period * 0.2 rxtx_it = decode.remove_transitional_states(rxtx_it, min_se0) mstates = manchester_decode(rxtx_it, bit_period) for r in _ethernet_generic_decode(mstates, tag_ethertypes=tag_ethertypes): yield r
def ethernet_decode(rxtx, tag_ethertypes=None, logic_levels=None, stream_type=stream.StreamType.Samples): '''Decode an ethernet data stream This is a generator function that can be used in a pipeline of waveform procesing operations. Sample streams are a sequence of SampleChunk Objects. Edge streams are a sequence of 2-tuples of (time, int) pairs. The type of stream is identified by the stream_type parameter. Sample streams will be analyzed to find edge transitions representing 0 and 1 logic states of the waveforms. With sample streams, an initial block of data is consumed to determine the most likely logic levels in the signal. rxtx (iterable of SampleChunk objects or (float, int) pairs) A sample stream or edge stream representing a differential ethernet signal. tag_ethertypes (sequence of int or None) The ethertypes to use for identifying 802.1Q tags. Default is 0x8100, 0x88a8, and 0x9100. logic_levels ((float, float) or None) Optional pair that indicates (low, high) logic levels of the sample stream. When present, auto level detection is disabled. This has no effect on edge streams. stream_type (streaming.StreamType) A StreamType value indicating that the can parameter represents either Samples or Edges Yields a series of EthernetStreamFrame objects. Each frame contains subrecords marking the location of sub-elements within the frame. CRC errors are recorded as an error status in their respective subrecords. Raises AutoLevelError if stream_type = Samples and the logic levels cannot be determined. Raises StreamError if ethernet speed cannot be determined. ''' if stream_type == stream.StreamType.Samples: if logic_levels is None: s_rxtx_it, logic_levels = decode.check_logic_levels(rxtx) else: s_rxtx_it = rxtx hyst_thresholds = decode.gen_hyst_thresholds(logic_levels, expand=3, hysteresis=0.05) rxtx_it = decode.find_multi_edges(s_rxtx_it, hyst_thresholds) #print('## logic levels:', logic_levels, hyst_thresholds) else: # The streams are already lists of edges rxtx_it = rxtx # Detect speed of ethernet buf_edges = 150 min_edges = 100 # tee off an iterator to determine speed class rxtx_it, speed_check_it = itertools.tee(rxtx_it) # Remove Diff-0's #FIX: need to modify to work with 100Mb and 1Gb Enet speed_check_it = (edge for edge in speed_check_it if edge[1] != 0) symbol_rate_edges = itertools.islice(speed_check_it, buf_edges) # We need to ensure that we can pull out enough edges from the iterator slice # Just consume them all for a count sre_list = list(symbol_rate_edges) if len(sre_list) < min_edges: raise stream.StreamError('Unable to determine Ethernet speed (not enough edge transitions)') del speed_check_it #print('## sym. rate edges len:', len(sre_list)) raw_symbol_rate = decode.find_symbol_rate(iter(sre_list), spectra=2) #print('### raw sym rate:', raw_symbol_rate) # For 10baseT (10MHz Manchester) the symbol rate will be 20MHz # For 100BaseTX the symbol rate will be 31.25MHz? if raw_symbol_rate < 25e6: bit_period = 1.0 / 10.0e6 else: raise stream.StreamError('Unsupported Ethernet speed: {}'.format(eng_si(raw_symbol_rate, 'Hz'))) if stream_type == stream.StreamType.Samples: # We needed the bus speed before we could properly strip just # the anomalous SE0s min_se0 = bit_period * 0.2 rxtx_it = decode.remove_transitional_states(rxtx_it, min_se0) mstates = manchester_decode(rxtx_it, bit_period) for r in _ethernet_generic_decode(mstates, tag_ethertypes=tag_ethertypes): yield r