drivers/platform/x86/siemens/simatic-ipc-batt.c
Source file repositories/reference/linux-study-clean/drivers/platform/x86/siemens/simatic-ipc-batt.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/platform/x86/siemens/simatic-ipc-batt.c- Extension
.c- Size
- 6387 bytes
- Lines
- 254
- Domain
- Driver Families
- Bucket
- drivers/platform
- Inferred role
- Driver Families: exported/initcall integration point
- Status
- integration implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/delay.hlinux/io.hlinux/ioport.hlinux/gpio/machine.hlinux/gpio/consumer.hlinux/hwmon.hlinux/hwmon-sysfs.hlinux/jiffies.hlinux/kernel.hlinux/module.hlinux/platform_device.hlinux/platform_data/x86/simatic-ipc-base.hlinux/sizes.hsimatic-ipc-batt.h
Detected Declarations
function simatic_ipc_batt_read_gpiofunction simatic_ipc_batt_read_iofunction simatic_ipc_batt_read_valuefunction simatic_ipc_batt_readfunction simatic_ipc_batt_is_visiblefunction simatic_ipc_batt_removefunction simatic_ipc_batt_probefunction simatic_ipc_batt_io_removefunction simatic_ipc_batt_io_probeexport simatic_ipc_batt_removeexport simatic_ipc_batt_probe
Annotated Snippet
if (IS_ERR(priv.gpios[2])) {
err = PTR_ERR(priv.gpios[2]);
priv.gpios[2] = NULL;
goto out;
}
} else {
priv.gpios[2] = NULL;
}
nogpio:
hwmon_dev = devm_hwmon_device_register_with_info(dev, KBUILD_MODNAME,
&priv,
&simatic_ipc_batt_chip_info,
NULL);
if (IS_ERR(hwmon_dev)) {
err = PTR_ERR(hwmon_dev);
goto out;
}
/* warn about aging battery even if userspace never reads hwmon */
simatic_ipc_batt_read_value(dev);
return 0;
out:
simatic_ipc_batt_remove(pdev, table);
return err;
}
EXPORT_SYMBOL_GPL(simatic_ipc_batt_probe);
static void simatic_ipc_batt_io_remove(struct platform_device *pdev)
{
simatic_ipc_batt_remove(pdev, NULL);
}
static int simatic_ipc_batt_io_probe(struct platform_device *pdev)
{
return simatic_ipc_batt_probe(pdev, NULL);
}
static struct platform_driver simatic_ipc_batt_driver = {
.probe = simatic_ipc_batt_io_probe,
.remove = simatic_ipc_batt_io_remove,
.driver = {
.name = KBUILD_MODNAME,
},
};
module_platform_driver(simatic_ipc_batt_driver);
MODULE_DESCRIPTION("CMOS core battery driver for Siemens Simatic IPCs");
MODULE_LICENSE("GPL");
MODULE_ALIAS("platform:" KBUILD_MODNAME);
MODULE_AUTHOR("Henning Schild <henning.schild@siemens.com>");
Annotation
- Immediate include surface: `linux/delay.h`, `linux/io.h`, `linux/ioport.h`, `linux/gpio/machine.h`, `linux/gpio/consumer.h`, `linux/hwmon.h`, `linux/hwmon-sysfs.h`, `linux/jiffies.h`.
- Detected declarations: `function simatic_ipc_batt_read_gpio`, `function simatic_ipc_batt_read_io`, `function simatic_ipc_batt_read_value`, `function simatic_ipc_batt_read`, `function simatic_ipc_batt_is_visible`, `function simatic_ipc_batt_remove`, `function simatic_ipc_batt_probe`, `function simatic_ipc_batt_io_remove`, `function simatic_ipc_batt_io_probe`, `export simatic_ipc_batt_remove`.
- Atlas domain: Driver Families / drivers/platform.
- Implementation status: integration implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.