Kernelcodegen

name: kernelcodegen description: AIE kernel code generation, compilation, and (optional) testing for the aiehlc flow. Use when you need to (1) Generate kernel C++ (kernel.cc, compute_kernel.cc) from the MLIR unitest pipeline, (2) Compile the kernel to an AIE kernel ELF with xchesscc/xchessmk, (3) Bypass or run kernel tests on HW. Complements hostcodegen (host side); kernel runs on AIE tiles.

Kernelcodegen

This skill drives the generate → compile → (optional) test loop for aiehlc AIE kernel code.

Workflow

1. Generate: Build the unitest, run ./test (e.g. dfschedule). Outputs: worklocal/kernel.cc. Same generation step as host; both host.cc and kernel.cc are produced. Kernel dfschedule is generated by passblueprinttoschedulekernel (passblueprinttoschedulekernel.cpp); passdfscheduletokernelapi (passdfscheduletokernelapi.cpp) is in charge of kernel.cc generation (schedule → EmitC → C++). worklocal/compute_kernel.cc is a pre-existing file (hand-written) for now. Files involved and full pass flow: references/codegen-flow.md. Paths: references/project-layout.md.

2. Compile: Kernel-only build via KERNEL_ONLY=1 source script/hostcompile.sh (the compile_one_kernel function; run with WORKLOCAL_DIR pointing at worklocal). Uses xchesscc (kernel.cc → LLVM IR; kernel.cc may include pre-existing compute_kernel.cc), opt (xlopt), xchessmk (link with aie2ps.prx). ELF output: worklocal/build/kernel. For env and options see references/compile-env.md.

3. Test (bypass for now): Kernel-on-HW testing can be bypassed. When needed later, see references/testing.md.

Bug fix

• Codegen error → Fix MLIR passes: BlueprintToScheduleKernelPass, DfscheduleToKernelApiPass; unitest driver in src/mlir/mlirfront/tilinglinalg/pass/unitest/test.cpp (kernel module emit to kernel.cc). See references/codegen-flow.md for the full pass sequence.
• Compile error → Fix compile_one_kernel/kc.sh includes, xchesscc flags, or aie2ps.prx; ensure kernel.cc and compute_kernel.cc (if used) are consistent with AIE API.

Resources