{"id":13437217,"url":"https://github.com/pop-os/system76-power","last_synced_at":"2025-05-15T09:02:23.156Z","repository":{"id":29504569,"uuid":"121873394","full_name":"pop-os/system76-power","owner":"pop-os","description":"Power profile management for Linux","archived":false,"fork":false,"pushed_at":"2025-04-08T14:55:58.000Z","size":622,"stargazers_count":615,"open_issues_count":111,"forks_count":71,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-14T14:59:47.803Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pop-os.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2018-02-17T16:55:24.000Z","updated_at":"2025-04-11T19:32:18.000Z","dependencies_parsed_at":"2024-04-24T18:17:46.737Z","dependency_job_id":"7127e4c0-8c59-4e12-9b8d-45a6f3d7c6f0","html_url":"https://github.com/pop-os/system76-power","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fsystem76-power","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fsystem76-power/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fsystem76-power/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pop-os%2Fsystem76-power/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pop-os","download_url":"https://codeload.github.com/pop-os/system76-power/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253514553,"owners_count":21920334,"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":[],"created_at":"2024-07-31T03:00:55.127Z","updated_at":"2025-05-15T09:02:23.012Z","avatar_url":"https://github.com/pop-os.png","language":"Rust","funding_links":[],"categories":["应用","Rust","HarmonyOS","Applications"],"sub_categories":["System tools","Windows Manager"],"readme":"# System76 Power Management\n\n**system76-power** is a utility for managing graphics and power profiles.\n\n## Switchable Graphics\n\nSwitchable graphics is a feature for laptops and all-in-one PCs. It is not\nsupported on desktops.\n\nA reboot is **required** for changes to take effect after switching modes.\n\n### Integrated\n\nThe integrated graphics controller on the Intel or AMD CPU is used exclusively.\n\nLower graphical performance with a longer battery life.\n\nExternal displays connected to the dGPU ports cannot be used.\n\n### NVIDIA\n\nThe dGPU (NVIDIA) is used exclusively.\n\nHigher graphical performance at the expense of a shorter battery life.\n\nAllows using external displays.\n\n### Hybrid\n\nEnables PRIME render offloading. The iGPU is used as the primary renderer, with\nthe ability to have specific applications render using the dGPU.\n\nPRIME render offloading requires the 435.17 NVIDIA drivers or later.\n\nApplications must use [GLVND] to take advantage of this feature, so may not\nrender on the dGPU even when requested. Vulkan applications must be launched\nwith `__NV_PRIME_RENDER_OFFLOAD=1` to render on the dGPU. GLX applications must\nbe launched with `__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia`\nto render on the dGPU.\n\nDisplay offload sinks (\"reverse PRIME\") require 450.57 NVIDIA drivers or later.\nThis feature allows using external displays while in this mode.\n\nGPU support for run-time power management is required for the device to enter\na low power state when not used. Only Turing cards and newer fully implement\nthis functionality. Support for run-time power manage can be checked in the\n`supported-gpus.json` file provided by the driver. e.g.:\n\n```\n$ cat /sys/bus/pci/devices/0000:01:00.0/device\n0x1f15\n$ jq '.chips[] | select(.devid==\"0x1F15\")' \u003c /usr/share/doc/nvidia-driver-460/supported-gpus.json\n{\n  \"devid\": \"0x1F15\",\n  \"name\": \"GeForce RTX 2060\",\n  \"features\": [\n    \"dpycbcr420\",\n    \"dpgsynccompatible\",\n    \"hdmi4k60rgb444\",\n    \"hdmigsynccompatible\",\n    \"geforce\",\n    \"runtimepm\",\n    \"vdpaufeaturesetJ\"\n  ]\n}\n```\n\n[GLVND]: https://gitlab.freedesktop.org/glvnd/libglvnd\n\n### Compute\n\nThe integrated graphics controller is used exclusively for rendering. The dGPU\nis made available as a compute node.\n\n## Power Profiles\n\n### Balanced\n\n- Set the sync data to disk to 15s\n- Enables laptop mode feature in kernel\n- Enables SCSI/SATA link time power management\n- Controls the Intel PState values if they exist\n\n### Performance\n\n- Uses settings from Balanced\n- Uses ACPI Platform profile if the hardware is supported by the kernel\n\n### Battery\n\n- Uses settings from Performance\n- Sets Screen brightness to a lower value\n- Turns keyboard backlight off\n\n## Hotplug detection\n\nThe dbus signal `HotPlugDetect` is sent when a display is plugged into a port\nconnected to the dGPU. If in integrated or compute mode, the\n[GNOME extension] will prompt to switch to hybrid mode so the display\ncan be used.\n\n[GNOME extension]: https://github.com/pop-os/gnome-shell-extension-system76-power\n\n### Adding hotplug detection\n\n#### Intel-based systems\n\nThe GPIO (sideband) port and pins for the display ports can be determined with\nthe schematics and output of [coreboot-collector]. The schematics will indicate\nwhich GPIOs are display ports (`*_HPD`). The corresponding `GPP_*` entry in\n`coreboot-collector.txt` will have the port/pin tuple.\n\n##### Muxed DisplayPort\n\nSome models have muxed DisplayPort ouput from mDP and USB-C. These units have a\nseparate data switch pin that is used to determine which output is used.\n\n#### AMD-based systems\n\nA MMIO region for FCH GPIO controls is used to detect external display plug\nevents. Display ports use `*_HPD` as Intel systems, but may not map to a\nliteral GPIO (e.g., `HDMI_HPD` maps to `DP3_HPD` on kudu6). Generating a diff\nfrom coreboot-collector in NVIDIA mode before and after plugging in a display\nshould provide the GPIO number.\n\n[coreboot-collector]: https://github.com/system76/coreboot-collector\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpop-os%2Fsystem76-power","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpop-os%2Fsystem76-power","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpop-os%2Fsystem76-power/lists"}