ntia-waveform.sigmf-ext.md

The ntia-waveform SigMF Extension Namespace v1.0.0

This document defines the ntia-waveform extension namespace for the Signal Metadata Format (SigMF) specification. This extension namespace provides models and parameters for textbook and standardized complex-baseband waveforms. The intention is to build a library of simulated waveforms for testing and training signal identification algorithms. The waveform library can also be used for signal generation purposes in system level interference tests.

0 Datatypes

The ntia-waveform extension provides a waveform object and additional extensions of the waveform object, which are referenced by the Emitter object provided by ntia-emitter.

0.1 The Waveform Object

The Waveform object has the following properties:

name	required	type	unit	description
model	true	string	N/A	The type of the waveform E.g. "IEEE80211p".
description	false	string	N/A	Description of the waveform.

0.2 The IEEE80211p Extension of the Waveform Object

IEEE 802.11p is an approved amendment to the IEEE 802.11 standard that adds wireless access in vehicular environments (WAVE), a vehicular communication system. It defines enhancements to 802.11 (the basis of products marketed as Wi-Fi) required to support Intelligent Transportation Systems (ITS) applications. This includes data exchange between high-speed vehicles and between the vehicles and the roadside infrastructure, so called V2X communication, in the licensed ITS band of 5.9 GHz (5.85-5.925 GHz).

IEEE80211p extends Waveform with the following additional properties:

name	required	type	unit	description
info_bit_generation	false	string	N/A	Model that defines information bit generation. E.g. "PN".
coding_rate	false	integer[]	bits	An integer[] of length 2 of the form [k, n] that describes an encoder that generates n bits of data for every k bits of useful information.
packet_length	false	integer	bits	Packet length.
modulation	false	string	N/A	Modulation, e.g., "BPSK", "QPSK", "16QAM", "64QAM".
encoder	false	string	N/A	Description of encoder. E.g. "Convolutional".
number_of_subcarriers	false	integer	N/A	Number of subcarriers.
number_of_data_subcarriers	false	integer	N/A	Number of data subcarriers.
number_of_pilots	false	integer	N/A	Number of pilots.
cyclic_prefix	false	integer	bits	Size of cyclic prefix.
short_inter_frame_space	false	double	microseconds	Time required to process a received frame and to respond with a response frame.
preamble_frame	false	integer[]	N/A	Preamble of 0's and 1's used for synchronization and to ID beginning of frame.
number_of_info_bits	false	integer	N/A	Number of information bits.
signal_to_noise_ratio	false	double	dB	Signal-to-noise ratio. If unspecified, assumed no noise present.

1 Global

The ntia-waveform extension does not extend the global SigMF object.

2 Captures

The ntia-waveform extension does not extend the captures SigMF object.

3 Annotations

The ntia-waveform extension does not extend the annotations SigMF object.

4 Collection

The ntia-waveform extension does not extend the collection SigMF object.

5 Example

{
  "global" : {
    "core:datatype" : "rf32_le",
    "core:sample_rate" : 2.8E7,
    "core:version" : "1.0.0",
    "core:num_channels" : 1,
    "core:extensions" : [ {
      "name" : "ntia-core",
      "version" : "v2.0.0",
      "optional" : false
    }, {
      "name" : "ntia-waveform",
      "version" : "v1.0.0",
      "optional" : false
    } ],
    "ntia-emitter:emitters" : [ {
      "id" : "test80211pEmitter",
      "description" : "Test 80211p emitter",
      "waveform" : {
        "model" : "IEEE80211p",
        "info_bit_generation" : "random",
        "coding_rate" : [ 1, 2 ],
        "packet_length" : 3200,
        "modulation" : "16QAM",
        "encoder" : "convolutional",
        "number_of_subcarriers" : 64,
        "number_of_data_subcarriers" : 48,
        "number_of_pilots" : 4,
        "short_inter_frame_space" : 80000.0
      }
    } ],
    "ntia-core:classification" : "UNCLASSIFIED"
  },
  ...
  "captures" : [ ... ],
  "annotations" : [ ... ]
}