taichi-ishitani/rggen

View on GitHub
README.md

Summary

Maintainability
Test Coverage
[![Gem Version](https://badge.fury.io/rb/rggen.svg)](https://badge.fury.io/rb/rggen)
[![Build Status](https://travis-ci.org/taichi-ishitani/rggen.svg?branch=master)](https://travis-ci.org/taichi-ishitani/rggen)
[![Maintainability](https://api.codeclimate.com/v1/badges/8f184e6e714a0fbdb6b0/maintainability)](https://codeclimate.com/github/taichi-ishitani/rggen/maintainability)
[![codecov](https://codecov.io/gh/taichi-ishitani/rggen/branch/master/graph/badge.svg)](https://codecov.io/gh/taichi-ishitani/rggen)
[![Join the chat at https://gitter.im/taichi-ishitani/rggen](https://badges.gitter.im/taichi-ishitani/rggen.svg)](https://gitter.im/taichi-ishitani/rggen?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

## NO LONGER MAINTAINED !

RgGen has been re-implemented so this repositry is no longer maintained. RgGen is maintained here.

* https://github.com/rggen/rggen

# RgGen

RgGen is a code generator tool for SoC/IP/FPGA/RTL engineers.
It will automatically generate source code for control/status registers, e.g. RTL, UVM RAL model, C header file, from its register map document.
Also RgGen is customizable so you can build your specific generate tool.

## Ruby

RgGen is written in the [*Ruby*](https://www.ruby-lang.org/en/about/) programing language and supports version 2.3 or later.
If you don't have above version of Ruby, you need to install the Ruby at first.
To install the Ruby, see [this page](https://www.ruby-lang.org/en/downloads/).

## Installation

To install RgGen and required libraries, use the following command:

    $ gem install rggen

RgGen will be installed under your system root.

If you want to install them on other location, you need to specify the install directory and set the **GEM_PATH** environment variable like below:

    $ gem install --install-dir YOUR_INSTALL_DIRECTORY rggen
    $ export GEM_PATH=YOUR_INSTALL_DIRECTORY

## Usage

See [this page](https://github.com/taichi-ishitani/rggen/wiki/Getting-Started)

## Development

After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.

To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

## Contact

If you have any questions, problems, ideas or somethings, you can post them on the following ways:

1. [Issue tracker](https://github.com/taichi-ishitani/rggen/issues)
2. [Chat room](https://gitter.im/taichi-ishitani/rggen)
3. [Mail](mailto:taichi730@gmail.com)

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/taichi-ishitani/rggen. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

## Copyright

Copyright © 2015-2018 Taichi Ishitani. See [LICENSE.txt](LICENSE.txt) for further details.