Skip to content

Public ci bootstrap - #1

Merged
aca-logimentor merged 18 commits into
mainfrom
public-ci-bootstrap
Jun 17, 2026
Merged

aca-logimentor merged 18 commits into
mainfrom
public-ci-bootstrap

Conversation

@aca-logimentor

Copy link
Copy Markdown
Contributor

Summary

Prepare lm_util for public use under the LogiMentor GitHub organization.

This PR turns the migrated utility repository into a public-facing VHDL library with licensing, documentation, CI, self-checking simulation tests, and a local vendor synthesis smoke-test flow.

Main Changes

  • Add Apache-2.0 licensing and public repository metadata.
  • Add GitHub Actions CI running the fast VUnit regression with GHDL.
  • Reorganize simulation files under sim/ and keep self-checking VUnit testbenches.
  • Normalize public naming/style, including C_LM_* constants and LogiMentor headers.
  • Remove legacy generated/publication files and old GitLab CI configuration.
  • Add docs/user_guide.md with:
    • library usage and instantiation examples;
    • module reference and key generics;
    • simulation and synthesis compile examples;
    • local vendor synthesis flow.
  • Add local vendor synthesis smoke runner under tools/synth/ for Vivado, Quartus, and Diamond.
  • Add configurable synthesis cases for SRL, CDC, reset, and clocking-sensitive modules.
  • Fix lm_util_delay_srl boundary behavior when g_delay = g_srl_depth.
  • Add VUnit coverage for SRL delay edge cases around 31/32/33 depth.

Validation

  • GitHub Actions CI is green on public-ci-bootstrap.
  • Latest CI run: 27473168458.
  • Local Vivado smoke checks exercised the new vendor synthesis runner:
    • clock_mux_2: passed and generated utilization/timing reports.
    • delay_srl_31x8_depth32: passed with SRL inference.
    • delay_srl_32x8_depth32_boundary: passed with SRLC32E/SRL inference.
    • delay_srl_33x8_depth32: currently blocked by the local Vivado installation missing internal unimacro_vhdl.tcl; the case remains useful to catch tool/environment issues.

Notes

Vendor synthesis is intentionally local-only. Tool paths, FPGA parts, and enabled targets are configured in tools/synth/local.toml, which is ignored by Git. The versioned files are the runner, example config, and synthesis case definitions.

Generated simulation and synthesis outputs remain ignored (vunit_out/, vendor_synth_out/, local Vivado logs, etc.).

Copilot AI review requested due to automatic review settings June 17, 2026 06:51

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot AI review requested due to automatic review settings June 17, 2026 07:23

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@aca-logimentor
aca-logimentor merged commit ba00a62 into main Jun 17, 2026
4 of 5 checks passed
@aca-logimentor
aca-logimentor deleted the public-ci-bootstrap branch June 17, 2026 07:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants