IEEE.org     |     IEEE Xplore Digital Library     |     IEEE Standards     |     IEEE Spectrum     |     More Sites

Verified Commit ecd9319b authored by Joshua Gay's avatar Joshua Gay 💾
Browse files

Adding IEEE P1765 open source code approved for balloting


Signed-off-by: Joshua Gay's avatarJoshua Gay <j.gay@ieee.org>
parents
This open source repository contains material that may be included-in or referenced by the IEEE document “1765™ Recommended Practice for Estimating the Uncertainty in Error Vector Magnitude of Measured Digitally Modulated Signals for Wireless Communications.” For further details see
https://standards.ieee.org/develop/project/1765.html
The repository contains both normative and informative files, as summarized at the end of this document. The normative files relate to specific methods outline in IEEE P1765 and may not be altered if used in conjunction with the best practices outlined in P1765.” The folders in the repository are organized as follows:
**01 ReadMe**
This folder contains basic information about the folders structure.
**02 P1765 Reference Waveforms**
This folder contains the IEEE P1765 Reference Waveforms for the use with the P1765 Baseline EVM Algorithm. Both single-carrier and OFDM P1765 Reference Waveforms are included, along with a description of impairments.
Also included are graphs of the filter responses used for pulse-shaping and match filtering of the waveforms and the resulting constellation diagrams. Currently P1765 Reference Waveforms for single-carrier modulation scheme are included. In the future, OFDM reference waveform files will be added.
The P1765 Reference Waveforms have been developed to simulate both low- and high-EVM scenarios and various deterministic effects in order to assess the User-receiver in the characterization of these various impairments. EVM values are calculated with the standardized Baseline EVM Algorithm in an attempt to limit the assessment of the measurement to hardware effects only. The goal is to assess distortion introduced into the measurement by the receiver hardware.
**03 P1765 Baseline EVM Algorithm**
This folder contains an overview and source files for the P1765 Baseline EVM Algorithm which are intended to support the P1765 Recommended Practice. Both single-carrier and OFDM Baseline EVM Algorithms are included.
The codes are written in Matlab (later also GNU Octave), which represent a high-level language which is widely used and can be easily converted into other languages.
The goal of the P1765 Baseline EVM Algorithm approach is to compute the EVM between two symbol sequences, where at least one of these sequences is derived from measurement. The result is an evaluation of the acquisition performance of the receiver’s hardware, as opposed to an evaluation of its ability to best decode the data carried by the signal. Thus, the P1765 Baseline EVM Algorithm compares the two symbol sequences at the intended constellation points and specified symbol-sampling times and does not attempt to correct for other impairments that may be present in the measured signal, such as frequency offset or I/Q imbalance. This allows an assessment of the “raw” hardware performance of a receiver before other impairments are corrected for by signal-processing techniques.
**04 Additions to the Baseline EVM Algorithm**
This folder contains additions to the P1765 Baseline EVM Algorithm. Currently it contains the Baseline OFDM EVM Algorithm with Equalization and will be further updated in the future.
**05 How_to_Contribute**
This folder contains information on how to contribute to the P1765 standard or the source codes / waveform files contained in this repository. Contributions will be evaluated and approved by Working Group members prior to being posted.
**06 License_Files**
This folder contains the license file which must be included with the source files should they be used for other purposes.
**07 Old_Versions**
This folder contains older versions of the source codes when they are replaced by their updated versions.
--------------------------------
The following table summarizes the files/directories that are considered as normative and informative:
|Main directory | Subdirectory (file) | Normative | Informative |
|-|-|:-:|:-:|
|01 Overview | | |X |
|02 P1765 Reference Waveforms |\OFDM\Baseband | X | |
| |\OFDM\EVM Calculation Results| | X |
| |\Single_Carrier\Baseband| X | |
| |\Single_Carrier\EVM Calculation Results | | X |
| |\Single_Carrier\Match filtered | X | |
| |\Single_Carrier\RF | X | |
|03 P1765 Baseline EVM Algorithms |\OFDM\Example EVM Results MATLAB2012b | | X |
| |\OFDM\Example EVM Results MATLAB2020a | | X |
| |\OFDM\Example EVM Results Octave6.3.0 | | X |
| |\OFDM (all *.m files) | X | |
| |\OFDM\help_file_OFDM.pdf | | X |
| |\OFDM\p1765_code_structure_ofdm_v2021.06.28.pdf | | X |
| |\Single_Carrier\Constellation _ Pulse Shaping Files | X | |
| |\Single_Carrier\Example EVM Results MATLAB2012b | | X |
| |\Single_Carrier\Example EVM Results MATLAB2020a | | X |
| |\Single_Carrier\Example EVM Results Octave6.3.0 | | X |
| |\Single_Carrier (all *.m files) | X | |
| |\Single_Carrier\help_file_single_carrier.pdf | | X |
| |\Single_Carrier\p1765_code_structure_singleCarrier_v2021.06.28.pdf | | X |
|04 Additions to the Baseline EVM Algorithm | \OFDM NPR EVM NMSE | X | |
| |\OFDM with equalization | X | |
| |\Time Domain Alignment for Single Carrier (all *.m files) | X | |
| |\Time Domain Alignment for Single Carrier\EVM Calculation Results | | X |
| |\Time Domain Alignment for Single Carrier\Example EVM Results MATLAB2012b | | X |
| |\Time Domain Alignment for Single Carrier\Example EVM Results MATLAB2020a | | X |
| |\Time Domain Alignment for Single Carrier\Example EVM Results Octave6.3.0 | | X |
| 05 How_to_Contribute | | | X |
| 06 License_Files | | | X |
| 07 Old_Versions | | | X |
All material in this repository is subject to change. The material in this repository is presented "as is" and with all faults. Use of the material is at the sole risk of the user. IEEE specifically disclaims all warranties and representations with respect to all material.
The primary use of the Reference Waveforms within the P1765 Best Practice document is for comparison of the User Measurement, including calibration and uncertainty analysis, to that obtained by a Reference Lab. The Reference Waveforms for the single-carrier and OFDM cases are described in their respective directories.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment