Files
asmjit/tools/tablegen-a64.js
kobalicek 6c9a6b2454 [abi] Reorganized instruction DB, removed deprecated instructions
* Removed AVX512_ER, AVX512_PF, AVX512_4FMAPS, and AVX512_4VNNIW
    extensions and corresponding instructions (these were never
    advertised by any x86 CPU and were only used by Xeon Phi acc.,
    which AsmJit never supported)
  * Removed CPU extensions HLE, MPX, and TSX
  * Kept extension RTM, which is only for backward compatibility to
    recognize instructions, but it's no longer checked by CpuInfo as
    it's been deprecated together with HLE and MPX
  * The xtest instruction now reports it requires RTM
  * Reorganized x86 extensions a bit - they are now reordered to group
    them by category, preparing for the future where extension IDs will
    be always added after existing records for ABI compatibility
  * Instruction vcvtneps2bf16 no longer accepts form without an explicit
    memory operand size
  * Removed aliased instructions in CMOVcc, Jcc, And SETcc categories,
    now there is only a single instruction id for all aliased instructions.
  * Added a new feature to always show instruction aliases in Logger, which
    includes formatting instructio nodes (Builder, Compiler)

Instruction DB-only updates (not applied to C++ yet):

  * AsmJit DB from now uses the same license as AsmJit (Zlib) and
    no longer applies dual licensing (Zlib and Public Domain)
  * Added support for aggregated instruction definitions in
    x86 instruction database, which should simplify the maintenance
    and reduce bugs (also the syntax is comparable to descriptions
    used by Intel APX instruction manuals)
  * Added support for APX instructions and new features
  * Added support for AVX10.1 and AVX10.2 instructions (both new
    instructions and new encodings of existing instructions)
  * Added support for MOVRS instructions
  * Added support for KL instructions (loadiwkey)
  * Added support for AESKLE instructions
  * Added support for AESKLEWIDE_KL instructions
  * Added support for AMX_[AVX512|MOVRS|FP8|TF32|TRANSPOSE]
  * NOTE: None of the instruction additions is currently used by
    Asmjit, it's a pure database update that needs more work to
    make all the instructions available in future AsmJit
2025-05-10 15:04:11 +02:00

353 lines
9.8 KiB
JavaScript

// This file is part of AsmJit project <https://asmjit.com>
//
// See asmjit.h or LICENSE.md for license and copyright information
// SPDX-License-Identifier: Zlib
"use strict";
const core = require("./tablegen.js");
const commons = require("./generator-commons.js");
const hasOwn = Object.prototype.hasOwnProperty;
const asmdb = core.asmdb;
const kIndent = commons.kIndent;
const IndexedArray = commons.IndexedArray;
const StringUtils = commons.StringUtils;
const FATAL = commons.FATAL;
// ============================================================================
// [ArmDB]
// ============================================================================
// Create AArch64 ISA.
const isa = new asmdb.aarch64.ISA();
/*
class GenUtils {
// Get a list of instructions based on `name` and optional `mode`.
static query(name, mode) {
const insts = isa.query(name);
return !mode ? insts : insts.filter(function(inst) { return inst.arch === mode; });
}
static archOf(records) {
var t16Arch = false;
var t32Arch = false;
var a32Arch = false;
var a64Arch = false;
for (var i = 0; i < records.length; i++) {
const record = records[i];
if (record.encoding === "T16") t16Arch = true;
if (record.encoding === "T32") t32Arch = true;
if (record.encoding === "A32") a32Arch = true;
if (record.encoding === "A64") a64Arch = true;
}
var s = (t16Arch && !t32Arch) ? "T16" :
(t32Arch && !t16Arch) ? "T32" :
(t16Arch && t32Arch) ? "Txx" : "---";
s += " ";
s += (a32Arch) ? "A32" : "---";
s += " ";
s += (a64Arch) ? "A64" : "---";
return `[${s}]`;
}
static featuresOf(records) {
const exts = Object.create(null);
for (var i = 0; i < records.length; i++) {
const record = records[i];
for (var k in record.extensions)
exts[k] = true;
}
const arr = Object.keys(exts);
arr.sort();
return arr;
}
}
*/
// ============================================================================
// [tablegen.arm.ArmTableGen]
// ============================================================================
class ArmTableGen extends core.TableGen {
constructor() {
super("A64");
}
// --------------------------------------------------------------------------
// [Parse / Merge]
// --------------------------------------------------------------------------
parse() {
const rawData = this.dataOfFile("src/asmjit/arm/a64instdb.cpp");
const stringData = StringUtils.extract(rawData, "// ${InstInfo:Begin}", "// ${InstInfo:End");
const re = new RegExp(
"INST\\(\\s*" +
// [01] Instruction.
"(" +
"[A-Za-z0-9_]+" +
")\\s*,\\s*" +
// [02] Encoding.
"(" +
"[^,]+" +
")\\s*,\\s*" +
// [03] OpcodeData.
"(" +
"\\([^\\)]+\\)" +
")\\s*,\\s*" +
// [04] RWInfo.
"(" +
"[^,]+" +
")\\s*,\\s*" +
// [05] InstructionFlags.
"(\\s*" +
"(?:" +
"(?:" +
"[\\d]+" +
"|" +
"F\\([^\\)]*\\)" +
")" +
"\\s*" +
"[|]?\\s*" +
")+" +
")\\s*,\\s*" +
// --- autogenerated fields ---
// [06] OpcodeDataIndex.
"([^\\)]+)" +
"\\s*\\)"
, "g");
var m;
while ((m = re.exec(stringData)) !== null) {
var enumName = m[1];
var name = enumName === "None" ? "" : enumName.toLowerCase();
var encoding = m[2].trim();
var opcodeData = m[3].trim();
var rwInfo = m[4].trim();
var instFlags = m[5].trim();
var displayName = name;
if (name.endsWith("_v"))
displayName = name.substring(0, name.length - 2);
// We have just matched #define INST()
if (name == "id" &&
encoding === "encoding" &&
encodingDataIndex === "encodingDataIndex")
continue;
this.addInstruction({
id : 0, // Instruction id (numeric value).
name : name, // Instruction name.
displayName : displayName, // Instruction name to display.
enum : enumName, // Instruction enum without `kId` prefix.
encoding : encoding, // Opcode encoding.
opcodeData : opcodeData, // Opcode data.
opcodeDataIndex : -1, // Opcode data index.
rwInfo : rwInfo, // RW info.
flags : instFlags // Instruction flags.
});
}
if (this.insts.length === 0 || this.insts.length !== StringUtils.countOf(stringData, "INST("))
FATAL("ARMTableGen.parse(): Invalid parsing regexp (no data parsed)");
console.log("Number of Instructions: " + this.insts.length);
}
merge() {
var s = StringUtils.format(this.insts, "", true, function(inst) {
return "INST(" +
String(inst.enum ).padEnd(17) + ", " +
String(inst.encoding ).padEnd(19) + ", " +
String(inst.opcodeData ).padEnd(86) + ", " +
String(inst.rwInfo ).padEnd(10) + ", " +
String(inst.flags ).padEnd(26) + ", " +
String(inst.opcodeDataIndex ).padEnd( 3) + ")" ;
}) + "\n";
return this.inject("InstInfo", s, this.insts.length * 4);
}
// --------------------------------------------------------------------------
// [Hooks]
// --------------------------------------------------------------------------
onBeforeRun() {
this.load([
"src/asmjit/arm/a64emitter.h",
"src/asmjit/arm/a64globals.h",
"src/asmjit/arm/a64instdb.cpp",
"src/asmjit/arm/a64instdb.h",
"src/asmjit/arm/a64instdb_p.h"
]);
this.parse();
}
onAfterRun() {
this.merge();
this.save();
this.dumpTableSizes();
}
}
// ============================================================================
// [tablegen.arm.IdEnum]
// ============================================================================
class IdEnum extends core.IdEnum {
constructor() {
super("IdEnum");
}
comment(inst) {
let name = inst.name;
let ext = [];
if (name.endsWith("_v")) {
name = name.substr(0, name.length - 2);
ext.push("ASIMD");
}
let exts = "";
if (ext.length)
exts = " {" + ext.join("&") + "}";
return `Instruction '${name}'${exts}.`;
}
}
// ============================================================================
// [tablegen.arm.NameTable]
// ============================================================================
class NameTable extends core.NameTable {
constructor() {
super("NameTable");
}
}
// ============================================================================
// [tablegen.arm.EncodingTable]
// ============================================================================
class EncodingTable extends core.Task {
constructor() {
super("EncodingTable");
}
run() {
const insts = this.ctx.insts;
const map = {};
for (var i = 0; i < insts.length; i++) {
const inst = insts[i];
const encoding = inst.encoding;
const opcodeData = inst.opcodeData.replace(/\(/g, "{ ").replace(/\)/g, " }");
if (!hasOwn.call(map, encoding))
map[encoding] = [];
if (inst.opcodeData === "(_)") {
inst.opcodeDataIndex = 0;
continue;
}
const opcodeTable = map[encoding];
const opcodeDataIndex = opcodeTable.length;
opcodeTable.push({ name: inst.name, data: opcodeData });
inst.opcodeDataIndex = opcodeDataIndex;
}
const keys = Object.keys(map);
keys.sort();
var tableSource = "";
var tableHeader = "";
var encodingIds = "";
encodingIds += "enum EncodingId : uint32_t {\n"
encodingIds += " kEncodingNone = 0";
keys.forEach((dataClass) => {
const dataName = dataClass[0].toLowerCase() + dataClass.substr(1);
const opcodeTable = map[dataClass];
const count = opcodeTable.length;
if (dataClass !== "None") {
encodingIds += ",\n"
encodingIds += " kEncoding" + dataClass;
}
if (count) {
tableHeader += `extern const ${dataClass} ${dataName}[${count}];\n`;
if (tableSource)
tableSource += "\n";
tableSource += `const ${dataClass} ${dataName}[${count}] = {\n`;
for (var i = 0; i < count; i++) {
tableSource += ` ${opcodeTable[i].data}` + (i == count - 1 ? " " : ",") + " // " + opcodeTable[i].name + "\n";
}
tableSource += `};\n`;
}
});
encodingIds += "\n};\n";
return this.ctx.inject("EncodingId" , StringUtils.disclaimer(encodingIds), 0) +
this.ctx.inject("EncodingDataForward", StringUtils.disclaimer(tableHeader), 0) +
this.ctx.inject("EncodingData" , StringUtils.disclaimer(tableSource), 0);
}
}
// ============================================================================
// [tablegen.arm.CommonTable]
// ============================================================================
class CommonTable extends core.Task {
constructor() {
super("CommonTable", [
"IdEnum",
"NameTable"
]);
}
run() {
//const table = new IndexedArray();
//for (var i = 0; i < insts.length; i++) {
// const inst = insts[i];
// const item = "{ " + "0" + "}";
// inst.commonIndex = table.addIndexed(item);
//}
// return this.ctx.inject("InstInfo", StringUtils.disclaimer(s), 0);
return 0;
}
}
// ============================================================================
// [Main]
// ============================================================================
new ArmTableGen()
.addTask(new IdEnum())
.addTask(new NameTable())
.addTask(new EncodingTable())
.addTask(new CommonTable())
.run();