1 // SPDX-License-Identifier: GPL-2.0-only
3 * nvs.c - Routines for saving and restoring ACPI NVS memory region
9 #include <linux/kernel.h>
10 #include <linux/list.h>
12 #include <linux/slab.h>
13 #include <linux/acpi.h>
17 /* ACPI NVS regions, APEI may use it */
22 struct list_head node;
25 static LIST_HEAD(nvs_region_list);
27 #ifdef CONFIG_ACPI_SLEEP
28 static int suspend_nvs_register(unsigned long start, unsigned long size);
30 static inline int suspend_nvs_register(unsigned long a, unsigned long b)
36 int acpi_nvs_register(__u64 start, __u64 size)
38 struct nvs_region *region;
40 region = kmalloc(sizeof(*region), GFP_KERNEL);
43 region->phys_start = start;
45 list_add_tail(®ion->node, &nvs_region_list);
47 return suspend_nvs_register(start, size);
50 int acpi_nvs_for_each_region(int (*func)(__u64 start, __u64 size, void *data),
54 struct nvs_region *region;
56 list_for_each_entry(region, &nvs_region_list, node) {
57 rc = func(region->phys_start, region->size, data);
66 #ifdef CONFIG_ACPI_SLEEP
68 * Platforms, like ACPI, may want us to save some memory used by them during
69 * suspend and to restore the contents of this memory during the subsequent
70 * resume. The code below implements a mechanism allowing us to do that.
74 unsigned long phys_start;
79 struct list_head node;
82 static LIST_HEAD(nvs_list);
85 * suspend_nvs_register - register platform NVS memory region to save
86 * @start - physical address of the region
87 * @size - size of the region
89 * The NVS region need not be page-aligned (both ends) and we arrange
90 * things so that the data from page-aligned addresses in this region will
91 * be copied into separate RAM pages.
93 static int suspend_nvs_register(unsigned long start, unsigned long size)
95 struct nvs_page *entry, *next;
97 pr_info("PM: Registering ACPI NVS region [mem %#010lx-%#010lx] (%ld bytes)\n",
98 start, start + size - 1, size);
101 unsigned int nr_bytes;
103 entry = kzalloc(sizeof(struct nvs_page), GFP_KERNEL);
107 list_add_tail(&entry->node, &nvs_list);
108 entry->phys_start = start;
109 nr_bytes = PAGE_SIZE - (start & ~PAGE_MASK);
110 entry->size = (size < nr_bytes) ? size : nr_bytes;
112 start += entry->size;
118 list_for_each_entry_safe(entry, next, &nvs_list, node) {
119 list_del(&entry->node);
126 * suspend_nvs_free - free data pages allocated for saving NVS regions
128 void suspend_nvs_free(void)
130 struct nvs_page *entry;
132 list_for_each_entry(entry, &nvs_list, node)
134 free_page((unsigned long)entry->data);
138 iounmap(entry->kaddr);
139 entry->unmap = false;
141 acpi_os_unmap_iomem(entry->kaddr,
150 * suspend_nvs_alloc - allocate memory necessary for saving NVS regions
152 int suspend_nvs_alloc(void)
154 struct nvs_page *entry;
156 list_for_each_entry(entry, &nvs_list, node) {
157 entry->data = (void *)__get_free_page(GFP_KERNEL);
167 * suspend_nvs_save - save NVS memory regions
169 int suspend_nvs_save(void)
171 struct nvs_page *entry;
173 printk(KERN_INFO "PM: Saving platform NVS memory\n");
175 list_for_each_entry(entry, &nvs_list, node)
177 unsigned long phys = entry->phys_start;
178 unsigned int size = entry->size;
180 entry->kaddr = acpi_os_get_iomem(phys, size);
182 entry->kaddr = acpi_os_ioremap(phys, size);
183 entry->unmap = !!entry->kaddr;
189 memcpy(entry->data, entry->kaddr, entry->size);
196 * suspend_nvs_restore - restore NVS memory regions
198 * This function is going to be called with interrupts disabled, so it
199 * cannot iounmap the virtual addresses used to access the NVS region.
201 void suspend_nvs_restore(void)
203 struct nvs_page *entry;
205 printk(KERN_INFO "PM: Restoring platform NVS memory\n");
207 list_for_each_entry(entry, &nvs_list, node)
209 memcpy(entry->kaddr, entry->data, entry->size);