root/sound/hda/controllers/acpi.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * ALSA driver for ACPI-based HDA Controllers.
 */

#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/acpi.h>

#include <sound/hda_codec.h>

#include "hda_controller.h"

struct hda_acpi {
        struct azx azx;
        struct snd_card *card;
        struct platform_device *pdev;
        void __iomem *regs;
        struct work_struct probe_work;
        const struct hda_data *data;
};

/**
 * struct hda_data - Optional device-specific data
 * @short_name: Used for the ALSA card name; defaults to KBUILD_MODNAME
 * @long_name:  Used for longer description; defaults to short_name
 * @flags:      Passed to &azx->driver_caps
 *
 * A pointer to a record of this type may be stored in the
 * &acpi_device_id->driver_data field of an ACPI match table entry in order to
 * customize the naming and behavior of a particular device. All fields are
 * optional and sensible defaults will be selected in their absence.
 */
struct hda_data {
        const char *short_name;
        const char *long_name;
        unsigned long flags;
};

static int hda_acpi_dev_disconnect(struct snd_device *device)
{
        struct azx *chip = device->device_data;

        chip->bus.shutdown = 1;
        return 0;
}

static int hda_acpi_dev_free(struct snd_device *device)
{
        struct azx *azx = device->device_data;
        struct hda_acpi *hda = container_of(azx, struct hda_acpi, azx);

        cancel_work_sync(&hda->probe_work);
        if (azx_bus(azx)->chip_init) {
                azx_stop_all_streams(azx);
                azx_stop_chip(azx);
        }

        azx_free_stream_pages(azx);
        azx_free_streams(azx);
        snd_hdac_bus_exit(azx_bus(azx));

        return 0;
}

static int hda_acpi_init(struct hda_acpi *hda)
{
        struct hdac_bus *bus = azx_bus(&hda->azx);
        struct snd_card *card = hda->azx.card;
        struct device *dev = &hda->pdev->dev;
        struct azx *azx = &hda->azx;
        struct resource *res;
        unsigned short gcap;
        const char *sname, *lname;
        int err, irq;

        /* The base address for the HDA registers and the interrupt are wrapped
         * in an ACPI _CRS object which can be parsed by platform_get_irq() and
         * devm_platform_get_and_ioremap_resource()
         */

        irq = platform_get_irq(hda->pdev, 0);
        if (irq < 0)
                return irq;

        hda->regs = devm_platform_get_and_ioremap_resource(hda->pdev, 0, &res);
        if (IS_ERR(hda->regs))
                return PTR_ERR(hda->regs);

        bus->remap_addr = hda->regs;
        bus->addr = res->start;

        err = devm_request_irq(dev, irq, azx_interrupt,
                               IRQF_SHARED, KBUILD_MODNAME, azx);
        if (err) {
                dev_err(dev, "unable to request IRQ %d, disabling device\n",
                        irq);
                return err;
        }
        bus->irq = irq;
        bus->dma_stop_delay = 100;
        card->sync_irq = bus->irq;

        gcap = azx_readw(azx, GCAP);
        dev_dbg(dev, "chipset global capabilities = 0x%x\n", gcap);

        azx->align_buffer_size = 1;

        azx->capture_streams = (gcap >> 8) & 0x0f;
        azx->playback_streams = (gcap >> 12) & 0x0f;

        azx->capture_index_offset = 0;
        azx->playback_index_offset = azx->capture_streams;
        azx->num_streams = azx->playback_streams + azx->capture_streams;

        err = azx_init_streams(azx);
        if (err < 0) {
                dev_err(dev, "failed to initialize streams: %d\n", err);
                return err;
        }

        err = azx_alloc_stream_pages(azx);
        if (err < 0) {
                dev_err(dev, "failed to allocate stream pages: %d\n", err);
                return err;
        }

        azx_init_chip(azx, 1);

        if (!bus->codec_mask) {
                dev_err(dev, "no codecs found!\n");
                return -ENODEV;
        }

        strscpy(card->driver, "hda-acpi");

        sname = hda->data->short_name ? hda->data->short_name : KBUILD_MODNAME;

        if (strlen(sname) > sizeof(card->shortname))
                dev_info(dev, "truncating shortname for card %s\n", sname);
        strscpy(card->shortname, sname);

        lname = hda->data->long_name ? hda->data->long_name : sname;

        snprintf(card->longname, sizeof(card->longname),
                 "%s at 0x%lx irq %i", lname, bus->addr, bus->irq);

        return 0;
}

static void hda_acpi_probe_work(struct work_struct *work)
{
        struct hda_acpi *hda = container_of(work, struct hda_acpi, probe_work);
        struct azx *chip = &hda->azx;
        int err;

        err = hda_acpi_init(hda);
        if (err < 0)
                return;

        err = azx_probe_codecs(chip, 8);
        if (err < 0)
                return;

        err = azx_codec_configure(chip);
        if (err < 0)
                return;

        err = snd_card_register(chip->card);
        if (err < 0)
                return;

        chip->running = 1;
}

static int hda_acpi_create(struct hda_acpi *hda)
{
        static const struct snd_device_ops ops = {
                .dev_disconnect = hda_acpi_dev_disconnect,
                .dev_free = hda_acpi_dev_free,
        };
        static const struct hda_controller_ops null_ops;
        struct azx *azx = &hda->azx;
        int err;

        mutex_init(&azx->open_mutex);
        azx->card = hda->card;
        INIT_LIST_HEAD(&azx->pcm_list);

        azx->ops = &null_ops;
        azx->driver_caps = hda->data->flags;
        azx->driver_type = hda->data->flags & 0xff;
        azx->codec_probe_mask = -1;

        err = azx_bus_init(azx, NULL);
        if (err < 0)
                return err;

        err = snd_device_new(hda->card, SNDRV_DEV_LOWLEVEL, &hda->azx, &ops);
        if (err < 0) {
                dev_err(&hda->pdev->dev, "Error creating device\n");
                return err;
        }

        return 0;
}

static int hda_acpi_probe(struct platform_device *pdev)
{
        struct hda_acpi *hda;
        int err;

        hda = devm_kzalloc(&pdev->dev, sizeof(*hda), GFP_KERNEL);
        if (!hda)
                return -ENOMEM;

        hda->pdev = pdev;
        hda->data = acpi_device_get_match_data(&pdev->dev);

        /* Fall back to defaults if the table didn't have a *struct hda_data */
        if (!hda->data)
                hda->data = devm_kzalloc(&pdev->dev, sizeof(*hda->data),
                                         GFP_KERNEL);
        if (!hda->data)
                return -ENOMEM;

        err = snd_card_new(&pdev->dev, SNDRV_DEFAULT_IDX1, SNDRV_DEFAULT_STR1,
                           THIS_MODULE, 0, &hda->card);
        if (err < 0) {
                dev_err(&pdev->dev, "Error creating card!\n");
                return err;
        }

        INIT_WORK(&hda->probe_work, hda_acpi_probe_work);

        err = hda_acpi_create(hda);
        if (err < 0)
                goto out_free;
        hda->card->private_data = &hda->azx;

        dev_set_drvdata(&pdev->dev, hda->card);

        schedule_work(&hda->probe_work);

        return 0;

out_free:
        snd_card_free(hda->card);
        return err;
}

static void hda_acpi_remove(struct platform_device *pdev)
{
        snd_card_free(dev_get_drvdata(&pdev->dev));
}

static void hda_acpi_shutdown(struct platform_device *pdev)
{
        struct snd_card *card = dev_get_drvdata(&pdev->dev);
        struct azx *chip;

        if (!card)
                return;
        chip = card->private_data;
        if (chip && chip->running)
                azx_stop_chip(chip);
}

static int hda_acpi_suspend(struct device *dev)
{
        struct snd_card *card = dev_get_drvdata(dev);
        int rc;

        rc = pm_runtime_force_suspend(dev);
        if (rc < 0)
                return rc;
        snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);

        return 0;
}

static int hda_acpi_resume(struct device *dev)
{
        struct snd_card *card = dev_get_drvdata(dev);
        int rc;

        rc = pm_runtime_force_resume(dev);
        if (rc < 0)
                return rc;
        snd_power_change_state(card, SNDRV_CTL_POWER_D0);

        return 0;
}

static const struct dev_pm_ops hda_acpi_pm = {
        SYSTEM_SLEEP_PM_OPS(hda_acpi_suspend, hda_acpi_resume)
};

static const struct hda_data nvidia_hda_data = {
        .short_name = "NVIDIA",
        .long_name = "NVIDIA HDA Controller",
        .flags = AZX_DCAPS_CORBRP_SELF_CLEAR,
};

static const struct acpi_device_id hda_acpi_match[] = {
        { .id = "NVDA2014", .driver_data = (uintptr_t) &nvidia_hda_data },
        { .id = "NVDA2015", .driver_data = (uintptr_t) &nvidia_hda_data },
        {},
};
MODULE_DEVICE_TABLE(acpi, hda_acpi_match);

static struct platform_driver hda_acpi_platform_driver = {
        .driver = {
                .name = KBUILD_MODNAME,
                .pm = &hda_acpi_pm,
                .acpi_match_table = hda_acpi_match,
        },
        .probe = hda_acpi_probe,
        .remove = hda_acpi_remove,
        .shutdown = hda_acpi_shutdown,
};
module_platform_driver(hda_acpi_platform_driver);

MODULE_DESCRIPTION("Driver for ACPI-based HDA Controllers");
MODULE_LICENSE("GPL");