Introduce version headers to JSON event lists

[edwarddavidbaker]

Currently event file versions in this repository are tracked via mapfile.csv and git history. The filenames themselves do not have version information. Version information is going to be re-introduced to event files with a dedicated header section.

Software updates required

The list of events are no longer tracked as a top level array. Instead first check for Header or Events entries. If present, retrieve the event list array from json_content["Events"].

Examples:

• intel/event-converter-for-linux-perf@841602b

Example from alderlake_goldencove_core.json

Current

[
  {
    "EventCode": "0xc4",
    "UMask": "0x00",
    "EventName": "BR_INST_RETIRED.ALL_BRANCHES",
    "BriefDescription": "All branch instructions retired.",
    "Counter": "0,1,2,3,4,5,6,7",
    "PEBScounters": "0,1,2,3,4,5,6,7",
    "SampleAfterValue": "400009",
    "MSRIndex": "0x00",
    "MSRValue": "0x00",
    "CollectPEBSRecord": "2",
    "TakenAlone": "0",
    "CounterMask": "0",
    "Invert": "0",
    "EdgeDetect": "0",
    "PEBS": "1",
    "Data_LA": "0",
    "L1_Hit_Indication": "0",
    "Errata": "null",
    "Offcore": "0",
    "Speculative": "0"
  },
  {
    "EventCode": "0xc5",
    "UMask": "0x00",
<snip>
  }
]

This change

{
  "Header": {
    "Copyright": "Copyright (c) 2001 - 2022 Intel Corporation. All rights reserved.",
    "Info": "Performance Monitoring Events for 12th Generation Intel(R) Core(TM) Processor - V1.15",
    "DatePublished": "08/25/2022",
    "Version": "1.15",
    "Legend": ""
  },
  "Events": [
    {
      "EventCode": "0xc4",
      "UMask": "0x00",
      "EventName": "BR_INST_RETIRED.ALL_BRANCHES",
      "BriefDescription": "All branch instructions retired.",
      "Counter": "0,1,2,3,4,5,6,7",
      "PEBScounters": "0,1,2,3,4,5,6,7",
      "SampleAfterValue": "400009",
      "MSRIndex": "0x00",
      "MSRValue": "0x00",
      "CollectPEBSRecord": "2",
      "TakenAlone": "0",
      "CounterMask": "0",
      "Invert": "0",
      "EdgeDetect": "0",
      "PEBS": "1",
      "Data_LA": "0",
      "L1_Hit_Indication": "0",
      "Errata": "null",
      "Offcore": "0",
      "Speculative": "0"
    },
    {
      "EventCode": "0xc5",
      "UMask": "0x00",
<snip>
    }
]