A template to implement a CORDIC-based rotation with bit accurate fixed-point number representation.
Find a file
Camille Monière 5bc9c3eeb1
Big update, that compiles with Xilinx GCC 6.2
- Commit title implies possible Xilinx Vivado HLS 2019.1 support, thus support
  for e.g. all USRP Series 3 from Ettus.
- Add a new CORDIC version, Rom based and meta-programmed via CMake
  features, to be even compiled with earlier GCC (not quite tested, but
  by changing constexpr to const and using gcc 4.6 -sdt=c++0x, it
  worked).
- Class name modified, to be more explicit.
2022-02-18 21:33:59 +01:00
.github Tentative of action 2022-02-14 15:55:30 +01:00
data Working AP template cordic 2022-02-11 18:17:13 +01:00
RomGenerators Big update, that compiles with Xilinx GCC 6.2 2022-02-18 21:33:59 +01:00
sources Big update, that compiles with Xilinx GCC 6.2 2022-02-18 21:33:59 +01:00
.clang-format Fix for GCC 9.4 support, formatting, and license addition. 2022-02-17 20:22:12 +01:00
.gitignore Big update, that compiles with Xilinx GCC 6.2 2022-02-18 21:33:59 +01:00
cmake_format_conf.py Fix CMakeLists and add a constexpr test 2022-02-14 10:44:22 +01:00
CMakeLists.txt Big update, that compiles with Xilinx GCC 6.2 2022-02-18 21:33:59 +01:00
lgpl-3.0.md Fix for GCC 9.4 support, formatting, and license addition. 2022-02-17 20:22:12 +01:00
LICENSE Fix for GCC 9.4 support, formatting, and license addition. 2022-02-17 20:22:12 +01:00
README.md Fix for GCC 9.4 support, formatting, and license addition. 2022-02-17 20:22:12 +01:00

CORDIC Rotate APFX

A free way to implement a CORDIC-based rotation using HLS, with bit-accurate precision.

Goal

CORDIC (COordinate Rotation DIgital Computer) is an efficient way to implement hardware complex rotations (e.g. z * exp(jw), with z = x + jy a complex and w a real angle). It is also useful for microcontrollers or microprocessors lacking floating-point units, as such multiplications can consume a noticeable amount of CPU cycles.

This implementation in C++14 (-std=c++14) is suitable for hardware simulation and (with the right lib's and a few tweaks) for synthesis.

This repository mainly hosts CCordicRotateHalfPiRom, CORDIC-based rotation units which rely on a ROM. Currently, It ranges from 2 to 7 stages, and the word length is a template. It depends on ROM generators, each one producing a ROM table which contains control signals for each CORDIC stage, depending on the input angle. There are generators:

  • A true constexpr one, that is entirely processed by the compiler.
  • A Monte-Carlo one, that is evaluated at runtime and can be used to produced ROM-headers, suitable for Autoconf/CMake header generations.

Only rotations of pi and pi/2 are currently supported, but support for any pi/2^k can be easily added.

CCordicRotate is an unfinished template that would implement a smart CORDIC, which can work without a ROM.

Test suite and dependencies

The Catch2 test framework has been used in conjunction with CTest to provides unit tests. The GitHub mirror of the repository also make use of GitHub Actions and Docker as a CI/CD solution.

  • Has been tested successfully compiled with:
    • GNU GCC 9.4, 10.1, 10.2 and 11.2,
    • LLVM Clang 12.0 and 13.0,
  • Uses Catch v2.13.7,
  • Depends on Xilinx HLS arbitrary precision types, available as FOSS here provided by Xilinx or here patched by myself. Note: Xilinx also provides proprietary versions of those headers, suitable for synthesis and implementation, bundled with their products.

Copyright 2022 Camille "DrasLorus" Monière.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

A copy of the license is available here in Markdown or here in plain text.