Add fusesoc:utils:generators 0.1.1

Author: olofk

fusesoc_utils/generators.core

@@ -0,0 +1,54 @@
+CAPI=2:
+
+name : fusesoc:utils:generators:0.1
+
+generators:
+  custom:
+    interpreter: python
+    command: custom.py
+    description : Run custom command
+    usage: |
+      The custom generator allows the user to specify a custom command to run.
+      As the custom generator doesn't know by itself what is produced by the
+      command, the user is requrested to specify any created files and associated
+      plusargs, defines etc in the output configuration parameter.
+
+      Parameters:
+        command (str): The command to run. Working directory for the command is
+                       determined by the copy_core and run_from_core parameters
+        copy_core (bool): Copy the working directory to a temporary location and run
+                          the command from there
+        run_from_core (bool): Runs command from the directory specified as files_root
+                              in the configuration file
+        output (dict): A dictionary describing the expected output from the command.
+                       These are written to the generated .core file
+          files (list): A list of files, specified in the same format as CAPI2 fileset
+                        files, which are expected to be generated by the command
+          parameters (dict): A map of parameters, specified in the same format as
+                             CAPI2 parameters, which are used by the generated files
+
+  gitversion:
+    interpreter: python
+    command: gitversion.py
+    description: Parse version tags from git repo
+    usage: |
+      The gitversion generator runs git describe to look at the tags in the current
+      directory (or in files_root if that is defined in the input configuration file)
+      and creates verilog defines that can be used in a core to provide accurate
+      version information.
+
+      Tags are assumed to be on the format vx.y.z which produces the following defines
+      VERSION_MAJOR = x
+      VERSION_MINOR = y
+      VERSION_PATCH = z
+
+      In addition to the parsed tags, the gitversion generator will also set
+      VERSION_REV to the number of commits since the last tag and VERSION_DIRTY if
+      it detects that there are local modifications in the repository
+
+provider:
+  name : github
+  user : fusesoc
+  repo : fusesoc-generators
+  version : v0.1.1
+