jax-ml/jax · error · ValueError
Unknown core type
Error message
Unknown core type: {core_type} What it means
Raised while assigning device types in Mosaic module lowering when a func.func op carries a tpu.core_type attribute that is neither a SparseCore subcore type nor a recognized TensorCore type, i.e. an unknown core type attribute in the module.
Solutions
- Align JAX, Pallas, and Mosaic/jaxlib versions
- Re-lower the kernel with the toolchain matching your JAX version
Defensive patterns
Strategy: validation
Validate before calling
import jax, jaxlib assert version_parse(jax.__version__) >= version_parse(min_required)
Prevention
- Pin jax/jaxlib/pallas versions together
- Never reuse lowered Mosaic asm across JAX upgrades
When it happens
Trigger: A lowered Pallas module containing a core_type attribute other than the supported tc/sparsecore forms, often from a version mismatch between Mosaic/Pallas IR and this JAX.
Common situations: Mixing JAX version with a newer/older Pallas or Mosaic that emits new core types (e.g. new chip types).
Related errors
- Pallas TPU requires a recent libtpu version (at least…
- The iteration bounds and dimension semantics attributes…
- A single Mosaic subkernel cannot contain multiple core…
- Acc ref dtype must be float32 or int32, got
- Acc ref must be at least 2D, got shape
AI-assisted analysis of jax-ml/jax@1e1c6a8fc0 (2026-08-27).
Data as JSON: /api/errors/f6607b660959cbbc.
Report an issue: GitHub.
Appendix: source
Thrown at jax/_src/tpu_custom_call.py:546
def assign_device_type_based_on_core_type(op: ir.Operation) -> ir.WalkResult:
nonlocal sparsecore_func_found
nonlocal tensorcore_func_found
if op.name == "func.func":
if "tpu.core_type" in op.attributes:
core_type = op.attributes["tpu.core_type"]
if str(core_type) in [
f"#tpu.core_type<{c}>"
for c in ["sc_scalar_subcore", "sc_vector_subcore"]
]:
sparsecore_func_found = True
if tensorcore_func_found:
return ir.WalkResult.INTERRUPT
return ir.WalkResult.SKIP
if str(core_type) == "#tpu.core_type<tc>":
tensorcore_func_found = True
return ir.WalkResult.SKIP
raise ValueError(f"Unknown core type: {core_type}")
return ir.WalkResult.ADVANCE
module.operation.walk(
assign_device_type_based_on_core_type, walk_order=ir.WalkOrder.PRE_ORDER
)
if tensorcore_func_found and sparsecore_func_found:
raise ValueError(
"A single Mosaic kernel cannot contain both TensorCore and SparseCore"
" functions."
)
if sparsecore_func_found:
return "sparsecore"
return None
def _get_active_core_count(module: ir.Module) -> int | None:
def get_core_parallel_dim_size(View on GitHub (pinned to 1e1c6a8fc0)