t27.aiEnglish

Важные предупреждения синтеза

Вы узнаете

Как читать лог yosys и какие предупреждения становятся ошибками на кремнии.

yosys сообщает много, и почти всё это нормально. Несколько строк — нет: защёлка, которую вы не задумывали, провод, который никто не ведёт, два драйвера на одной цепи, память, ставшая триггерами. Всё это работает в симуляции и ломается на чипе. Откройте один из настоящих логов спек t27, затем вставьте свой.

Попробуйте

Откройте каждый настоящий лог и найдите тот, который yosys отверг, и почему. В спеке проход по модулям считает, что он вычистил: найдите три счётчика CrossOptPass и тест, где они в сумме дают 17.

Открыть интерактивный урок →

Synth smells: a lint card for your yosys log
Synth smells: a lint card for your yosys log ↗

Paste or drop a yosys synth_xilinx log: latches, undriven wires, driver conflicts, memories turned into flip-flops, warnings and final cell counts, read in your browser.

specs/fpga/crossopt.t27

// SPDX-License-Identifier: Apache-2.0
// t27/specs/fpga/crossopt.t27
// T27 Cross-Module Optimization Specification
// Inter-module constant propagation, dead signal elimination, instance merging
// Uses flat arrays + count fields (parser-compatible)
// phi^2 + 1/phi^2 = 3 | TRINITY

module CrossOpt {

    pub struct CrossOptPass {
        name : &str,
        num_modules : u32,
        constants_propagated : u32,
        dead_signals_removed : u32,
        instances_merged : u32,
    }

    fn pass_zero() -> CrossOptPass {
        return CrossOptPass{
            .name = "empty",
            .num_modules = 0,
            .constants_propagated = 0,
            .dead_signals_removed = 0,
            .instances_merged = 0,
        };
    }

    fn pass_result(name: &str, mods: u32, consts: u32, dead: u32, merged: u32) -> CrossOptPass {
        return CrossOptPass{
            .name = name,
            .num_modules = mods,
            .constants_propagated = consts,
            .dead_signals_removed = dead,
            .instances_merged = merged,
        };
    }

    fn total_improvements(p: CrossOptPass) -> u32 {
        return p.constants_propagated + p.dead_signals_removed + p.instances_merged;
    }

    fn has_improvements(p: CrossOptPass) -> bool {
        return total_improvements(p) > 0;
    }

    fn improvement_density(p: CrossOptPass) -> u32 {
        if p.num_modules == 0 {
            return 0;
        }
        return total_improvements(p) / p.num_modules;
    }

    pub struct CrossOptReport {
        total_passes : u32,
        total_constants : u32,
        total_dead : u32,
        total_merged : u32,
        total_modules : u32,
    }

    fn report_ok(passes: u32, consts: u32, dead: u32, merged: u32, mods: u32) -> CrossOptReport {
        return CrossOptReport{
            .total_passes = passes,
            .total_constants = consts,
            .total_dead = dead,
            .total_merged = merged,
            .total_modules = mods,
        };
    }

    fn total_optimizations(r: CrossOptReport) -> u32 {
        return r.total_constants + r.total_dead + r.total_merged;
    }

    fn is_effective(r: CrossOptReport) -> bool {
        return total_optimizations(r) > 0;
    }

    // === Tests ===

    test pass_zero
        given p = pass_zero()
        then p.num_modules == 0
        and total_improvements(p) == 0
        and has_improvements(p) == false

    test pass_result_creation
        given p = pass_result("const_prop", 3, 10, 5, 2)
        then p.name == "const_prop"
        and p.num_modules == 3
        and total_improvements(p) == 17
        and has_improvements(p) == true

    test improvement_density
        given p = pass_result("opt", 5, 20, 10, 5)
        then improvement_density(p) == 7

    test improvement_density_zero
        given p = pass_zero()
        then improvement_density(p) == 0

    test report_creation
        given r = report_ok(3, 30, 15, 5, 10)
        then r.total_passes == 3
        and total_optimizations(r) == 50
        and is_effective(r) == true

    test report_empty
        given r = report_ok(0, 0, 0, 0, 0)
        then is_effective(r) == false

    invariant improvements_non_negative
        given p = pass_zero()
        assert total_improvements(p) >= 0

    bench improvement_density_latency
        measure: nanoseconds to improvement_density(pass_result("bench", 5, 20, 10, 5))
        target: < 50ns

    bench total_improvements_latency
        measure: nanoseconds to total_improvements(pass_result("bench", 10, 50, 25, 10))
        target: < 50ns
}

// phi^2 + 1/phi^2 = 3 | TRINITY

Открыть спеку урока в плеере ↗

Все уроки