Home Verkennen Help
Inloggen
mbuesch
/
crcgen
Volgen 1
Ster 0
Vork 0
Bestanden Kwesties 0 Pull-aanvragen 0 Wiki
Aftakking: master
Aftakkingen Labels
crcgen
/
README.rst

README.rst 2.7 KB
Permalink Geschiedenis Ruwe

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283 
  1. CRC algorithm HDL code generator (VHDL, Verilog, MyHDL)
    2. 

  2. =======================================================
    3. 

  3. 

  4. `Homepage <https://bues.ch/h/crcgen>`_
    5. 

  5. 

  6. `Git repository <https://bues.ch/cgit/crcgen.git>`_
    7. 

  7. 

  8. `Github repository <https://github.com/mbuesch/crcgen>`_
    9. 

  9. 

  10. This tool generates VHDL, Verilog or MyHDL code for use in FPGAs to calculate CRC (Cyclic Redundancy Check) checksums.
    11. 

  11. 

  12. The generated HDL code is synthesizable and combinatorial. That means the calculation runs in one clock cycle on an FPGA.
    13. 

  13. 

  14. Any combination of CRC algorithm parameters and polynomial coefficients can be selected.
    15. 

  15. 

  16. 

  17. Example usage
    18. 

  18. =============
    19. 

  19. 

  20. Display all options:
    21. 

  21. 

  22. .. code:: sh
    23. 

  23. 

  24. 	crcgen -h
    25. 

  25. 

  26. 

  27. Generate Verilog code for CRC-32:
    28. 

  28. 

  29. .. code:: sh
    30. 

  30. 

  31. 	crcgen -a CRC-32 -v
    32. 

  32. 

  33. 

  34. Generate VHDL code for CRC-32:
    35. 

  35. 

  36. .. code:: sh
    37. 

  37. 

  38. 	crcgen -a CRC-32 -V
    39. 

  39. 

  40. 

  41. Generate Verilog code for a custom non-standard CRC or any standard algorithm that's not included in crcgen's -a list:
    42. 

  42. 

  43. .. code:: sh
    44. 

  44. 

  45. 	crcgen -P "x^8 + x^7 + x^5 + x^4 + x^2 + x + 1" -B16 -R -v
    46. 

  46. 

  47. 

  48. Online crcgen
    49. 

  49. =============
    50. 

  50. 

  51. An easy to use online version of crcgen that can be used without installing or downloading anything to your machine is available here:
    52. 

  52. 

  53. `Online crcgen <https://bues.ch/h/crcgen>`_
    54. 

  54. 

  55. 

  56. License of the generated HDL code
    57. 

  57. =================================
    58. 

  58. 

  59. The generated code is Public Domain.
    60. 

  60. 

  61. Permission to use, copy, modify, and/or distribute this software for any
    62. 

  62. purpose with or without fee is hereby granted.
    63. 

  63. 

  64. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
    65. 

  65. WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
    66. 

  66. MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
    67. 

  67. SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
    68. 

  68. RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
    69. 

  69. NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE
    70. 

  70. USE OR PERFORMANCE OF THIS SOFTWARE.
    71. 

  71. 

  72. 

  73. License of the generator
    74. 

  74. ========================
    75. 

  75. 

  76. Copyright (c) 2019-2023 Michael Büsch <m@bues.ch>
    77. 

  77. 

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

  79. 

  80. 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 General Public License for more details.
    81. 

  81. 

  82. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
    83. 

  83.