This library contains common operations and logic for LibreCores CI.
The library is under development. All commands may change, the compatibility is not guaranteed.
This is the class to more conveniently build CI based on Environment Modules (http://modules.sourceforge.net/). First modules are loaded to the environment and calling sh() then executes the command(s) in that environment.
Usage:
@Library('librecoresci') import org.librecores.ci.Modules
def lcci = new Modules(steps)
node('librecores-ci-modules') {
lcci.load(["eda/verilator/3.902"])
stage('Simulation Build') {
lcci.sh 'verilator -f verilate.vc'
}
}
Executes the sh()
command with initializing the specified modules before executing.
Example:
node('librecores-ci-modules') {
sh_with_modules(modules: ["gcc", "fusesoc/1.6"], command: "make all")
}
Effectively the example above creates commands like source ${modulesPath}/init/bash && sh "module load gcc && module load fusesoc/1.6 && make all"
.
Builds a pipeline for OpenRISC projects.
Out of the box it configures:
- Pulls Docker images for
librecores-ci-openrisc
- Executes jobs in parallel inside Docker images
This snippet is from the Jenkins pipeline for mor1kx
@Library('librecoresci') _
openriscPipeline {
job('verilator') {
job 'verilator'
}
job('testing-1') {
job 'or1k-tests'
sim 'icarus'
pipeline 'CAPPUCCINO'
expectedFailures 'or1k-cy'
}
}
Builds a step for a generic FuseSoC invocation.
- Chooses a base docker image with FuseSoC
- Adds library to FuseSoC
- Runs FuseSoC step
- Runs arbitrary shell commands in this step
@Library('librecoresci') _
pipeline {
stages {
stage('example-fusesoc-step') {
fusesoc {
image 'librecores/librecores-ci:0.5.0'
library 'some_core', '/src'
run('some_core') {
target 'fusesoc_target'
}
shell "echo 'Additional steps on shell'"
}
}
}
}
Build a step for Yosys Synthesis for monitoring resource usage statistics and publish on Jenkins.
- Generalised Yosys Synthesis
- Can be configured for various hardware projects
- Simple declarative call which requires parameters
core
,target
,logpath
- Can be modified and extend to include more paramaters in future.
@Library('librecoresci') _
pipeline {
agent any
stages{
stage('yosys') {
steps {
yosysSynthesisReport {
core 'mor1kx'
target 'synth'
logPath 'build/mor1kx_5.0-r3/synth-icestorm/yosys.log'
}
}
}
}
}