{"id":28320264,"url":"https://github.com/amd/amd_hsmp","last_synced_at":"2025-06-14T03:05:22.523Z","repository":{"id":42465110,"uuid":"353615753","full_name":"amd/amd_hsmp","owner":"amd","description":"AMD HSMP module to provide user interface to system management features.","archived":false,"fork":false,"pushed_at":"2025-04-09T07:56:44.000Z","size":105,"stargazers_count":28,"open_issues_count":5,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-01T18:32:14.327Z","etag":null,"topics":["amd","amd-module","hsmp","in-band","systemmanagement"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-01T07:38:04.000Z","updated_at":"2025-04-09T07:54:51.000Z","dependencies_parsed_at":"2025-04-09T08:31:11.919Z","dependency_job_id":"b9b8e4d0-0e83-4a93-8fe0-c708f8885ae2","html_url":"https://github.com/amd/amd_hsmp","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/amd/amd_hsmp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Famd_hsmp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Famd_hsmp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Famd_hsmp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Famd_hsmp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amd","download_url":"https://codeload.github.com/amd/amd_hsmp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amd%2Famd_hsmp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259752030,"owners_count":22905968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amd","amd-module","hsmp","in-band","systemmanagement"],"created_at":"2025-05-25T10:08:45.779Z","updated_at":"2025-06-14T03:05:22.513Z","avatar_url":"https://github.com/amd.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# amd_hsmp\n\nNOTE: The AMD HSMP driver is now part of the Linux kernel upstream starting in v5.18-rc1. Review kernel.org for updated versions of this driver.\n\nAMD HSMP module to provide user interface to system management features\n\nThe Host System Management Port (HSMP) kernel module provides user level\naccess to the HSMP mailboxes implemented by the firmware in the\nSystem Management Unit (SMU). Full documentation of the HSMP can\nbe found in the Processor Programming Reference (PPR) for Family\n19h on AMD's Developer Central.\n\nhttps://developer.amd.com/resources/epyc-resources/epyc-specifications\n\nE-SMI library provides C API fo the user space application on top of this\nmodule.\n\n\nDisclaimer\n===========\n\nThe amd_hsmp module is supported only on AMD Family 19h (including\nthird-generation AMD EPYC processors (codenamed \"Milan\")) or later\nCPUs. Using the amd_hsmp module on earlier CPUs could produce unexpected\nresults, and may cause the processor to operate outside of your motherboard\nor system specifications. Correspondingly, defaults to only executing on\nAMD Family 19h Model 0 ~ Fh, 10h ~ 1Fh, 30h ~ 3Fh, \u0026 A0 ~ AFh,\nfamily 1Ah Model 0 ~ 1fh EPYC processors and family 19h model 90 ~ 9fh\nMI300A processors.\n\n\nInterface\n---------\n\nSee amd_hsmp.h for details about the IOCTL interface.\n\n\nBIOS configuration\n------------------\n\nHSMP PCIe interface needs to be enabled in the BIOS. The CBS option can be found\nby navigating to the following path\n\n#####  ```Advanced \u003e AMD CBS \u003e NBIO Common Options \u003e SMU Common Options \u003e HSMP Support```\n#####  ```\tBIOS Default:     “Auto” (Disabled)```\n\n  If the option is disabled, calls to the SMU will result in a timeout.\n\n\nBuild and Install\n-----------------\n\nKernel development packages for the running kernel need to be installed\nprior to building the HSMP module. A Makefile is provided which should\nwork with most kernel source trees.\n\nTo build the kernel module:\n\n#\u003e make\n\nTo install the kernel module:\n\n#\u003e sudo make modules_install\n\nTo clean the kernel module build directory:\n\n#\u003e make clean\n\n\nLoading\n-------\n\nIf the HSMP modules are installed in standard path you should use the modprobe command to\nload the module.\n\nTo load hsmp modules on platforms with ACPI supported BIOS (Family 0x1A, model 0x00-0x1F and future platforms):\n#\u003e sudo modprobe hsmp_acpi\n\nTo load hsmp module on non-ACPI BIOS(Family 0x19, model 0x00-0x1F, 0x30-0x3F, 0x90-0x9F, 0xA0-0xAF):\n#\u003e sudo modprobe amd_hsmp\n\n\nDKMS support\n------------\n\nBuilding Module with running version of kernel\n\nAdd the module to DKMS tree:\n#\u003e sudo dkms add ../hsmp_driver\n\nBuild the module using DKMS:\n#\u003e sudo dkms build amd_hsmp/2.4\n\nInstall the module using DKMS:\n#\u003e sudo dkms install amd_hsmp/2.4\n\nLoad the module:\n#\u003e sudo modprobe amd_hsmp\n\nBuilding Module with specific version of kernel\n\nAdd the module to DKMS tree:\n#\u003e sudo dkms add ../hsmp_driver\n\nBuild the module using DKMS:\n#\u003e sudo dkms build amd_hsmp/2.4 -k linux_version\n\nInstall the module using DKMS:\n#\u003e sudo dkms install amd_hsmp/2.4 -k linux_version\nModule is built: /lib/modules/linux_version/updates/dkms/\n\nNotes: It is required to have specific linux verion header in /usr/src\n\nTo remove module from dkms tree\n#\u003e sudo dkms remove -m amd_hsmp/2.4 --all\n#\u003e sudo rm -rf /usr/src/amd_hsmp-2.4/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd%2Famd_hsmp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famd%2Famd_hsmp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famd%2Famd_hsmp/lists"}