/* $NetBSD: acpi_cpu_tstate.c,v 1.34 2020/12/07 10:57:41 jmcneill Exp $ */

/*-
* Copyright (c) 2010 Jukka Ruohonen <[email protected]>
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
*    notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
*    notice, this list of conditions and the following disclaimer in the
*    documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
#include <sys/cdefs.h>
__KERNEL_RCSID(0, "$NetBSD: acpi_cpu_tstate.c,v 1.34 2020/12/07 10:57:41 jmcneill Exp $");

#include <sys/param.h>
#include <sys/kmem.h>
#include <sys/xcall.h>
#include <sys/cpu.h>

#include <dev/acpi/acpireg.h>
#include <dev/acpi/acpivar.h>
#include <dev/acpi/acpi_cpu.h>

#define _COMPONENT       ACPI_BUS_COMPONENT
ACPI_MODULE_NAME         ("acpi_cpu_tstate")

static ACPI_STATUS       acpicpu_tstate_tss(struct acpicpu_softc *);
static ACPI_STATUS       acpicpu_tstate_tss_add(struct acpicpu_tstate *,
                                               ACPI_OBJECT *);
static ACPI_STATUS       acpicpu_tstate_ptc(struct acpicpu_softc *);
static ACPI_STATUS       acpicpu_tstate_dep(struct acpicpu_softc *);
static ACPI_STATUS       acpicpu_tstate_fadt(struct acpicpu_softc *);
static ACPI_STATUS       acpicpu_tstate_change(struct acpicpu_softc *);
static void              acpicpu_tstate_reset(struct acpicpu_softc *);
static void              acpicpu_tstate_set_xcall(void *, void *);

extern struct acpicpu_softc **acpicpu_sc;

void
acpicpu_tstate_attach(device_t self)
{
       struct acpicpu_softc *sc = device_private(self);
       const char *str;
       ACPI_HANDLE tmp;
       ACPI_STATUS rv;

       /*
        * Disable T-states for PIIX4.
        */
       if ((sc->sc_flags & ACPICPU_FLAG_PIIX4) != 0)
               return;

       rv  = acpicpu_tstate_tss(sc);

       if (ACPI_FAILURE(rv)) {
               str = "_TSS";
               goto out;
       }

       rv = acpicpu_tstate_ptc(sc);

       if (ACPI_FAILURE(rv)) {
               str = "_PTC";
               goto out;
       }

       /*
        * Query the optional _TSD.
        */
       rv = acpicpu_tstate_dep(sc);

       if (ACPI_SUCCESS(rv))
               sc->sc_flags |= ACPICPU_FLAG_T_DEP;

       /*
        * Comparable to P-states, the _TPC object may
        * be absent in some systems, even though it is
        * required by ACPI 3.0 along with _TSS and _PTC.
        */
       rv = AcpiGetHandle(sc->sc_node->ad_handle, "_TPC", &tmp);

       if (ACPI_FAILURE(rv)) {
               aprint_debug_dev(self, "_TPC missing\n");
               rv = AE_OK;
       }

out:
       if (ACPI_FAILURE(rv)) {

               if (rv != AE_NOT_FOUND)
                       aprint_error_dev(sc->sc_dev, "failed to evaluate "
                           "%s: %s\n", str, AcpiFormatException(rv));

               rv = acpicpu_tstate_fadt(sc);

               if (ACPI_FAILURE(rv))
                       return;

               sc->sc_flags |= ACPICPU_FLAG_T_FADT;
       }

       sc->sc_flags |= ACPICPU_FLAG_T;

       acpicpu_tstate_reset(sc);
}

void
acpicpu_tstate_detach(device_t self)
{
       struct acpicpu_softc *sc = device_private(self);
       size_t size;

       if ((sc->sc_flags & ACPICPU_FLAG_T) == 0)
               return;

       size = sc->sc_tstate_count * sizeof(*sc->sc_tstate);

       if (sc->sc_tstate != NULL)
               kmem_free(sc->sc_tstate, size);

       sc->sc_flags &= ~ACPICPU_FLAG_T;
}

void
acpicpu_tstate_start(device_t self)
{
       /* Nothing. */
}

void
acpicpu_tstate_suspend(void *aux)
{
       struct acpicpu_softc *sc;
       device_t self = aux;

       sc = device_private(self);

       mutex_enter(&sc->sc_mtx);
       acpicpu_tstate_reset(sc);
       mutex_exit(&sc->sc_mtx);
}

void
acpicpu_tstate_resume(void *aux)
{
       /* Nothing. */
}

void
acpicpu_tstate_callback(void *aux)
{
       struct acpicpu_softc *sc;
       device_t self = aux;
       uint32_t omax, omin;
       int i;

       sc = device_private(self);

       if ((sc->sc_flags & ACPICPU_FLAG_T_FADT) != 0)
               return;

       mutex_enter(&sc->sc_mtx);

       /*
        * If P-states are in use, we should ignore
        * the interrupt unless we are in the highest
        * P-state (see ACPI 4.0, section 8.4.3.3).
        */
       if ((sc->sc_flags & ACPICPU_FLAG_P) != 0) {

               for (i = sc->sc_pstate_count - 1; i >= 0; i--) {

                       if (sc->sc_pstate[i].ps_freq != 0)
                               break;
               }

               if (sc->sc_pstate_current != sc->sc_pstate[i].ps_freq) {
                       mutex_exit(&sc->sc_mtx);
                       return;
               }
       }

       omax = sc->sc_tstate_max;
       omin = sc->sc_tstate_min;

       (void)acpicpu_tstate_change(sc);

       if (omax != sc->sc_tstate_max || omin != sc->sc_tstate_min) {

               aprint_debug_dev(sc->sc_dev, "throttling window "
                   "changed from %u-%u %% to %u-%u %%\n",
                   sc->sc_tstate[omax].ts_percent,
                   sc->sc_tstate[omin].ts_percent,
                   sc->sc_tstate[sc->sc_tstate_max].ts_percent,
                   sc->sc_tstate[sc->sc_tstate_min].ts_percent);
       }

       mutex_exit(&sc->sc_mtx);
}

static ACPI_STATUS
acpicpu_tstate_tss(struct acpicpu_softc *sc)
{
       struct acpicpu_tstate *ts;
       ACPI_OBJECT *obj;
       ACPI_BUFFER buf;
       ACPI_STATUS rv;
       uint32_t count;
       uint32_t i, j;

       rv = acpi_eval_struct(sc->sc_node->ad_handle, "_TSS", &buf);

       if (ACPI_FAILURE(rv))
               return rv;

       obj = buf.Pointer;

       if (obj->Type != ACPI_TYPE_PACKAGE) {
               rv = AE_TYPE;
               goto out;
       }

       sc->sc_tstate_count = obj->Package.Count;

       if (sc->sc_tstate_count == 0) {
               rv = AE_NOT_EXIST;
               goto out;
       }

       sc->sc_tstate = kmem_zalloc(sc->sc_tstate_count *
           sizeof(struct acpicpu_tstate), KM_SLEEP);

       if (sc->sc_tstate == NULL) {
               rv = AE_NO_MEMORY;
               goto out;
       }

       for (count = i = 0; i < sc->sc_tstate_count; i++) {

               ts = &sc->sc_tstate[i];
               rv = acpicpu_tstate_tss_add(ts, &obj->Package.Elements[i]);

               if (ACPI_FAILURE(rv)) {
                       ts->ts_percent = 0;
                       continue;
               }

               for (j = 0; j < i; j++) {

                       if (ts->ts_percent >= sc->sc_tstate[j].ts_percent) {
                               ts->ts_percent = 0;
                               break;
                       }
               }

               if (ts->ts_percent != 0)
                       count++;
       }

       if (count == 0) {
               rv = AE_NOT_EXIST;
               goto out;
       }

       /*
        * There must be an entry with the percent
        * field of 100. If this is not true, and if
        * this entry is not in the expected index,
        * invalidate the use of T-states via _TSS.
        */
       if (sc->sc_tstate[0].ts_percent != 100) {
               rv = AE_BAD_DECIMAL_CONSTANT;
               goto out;
       }

out:
       if (buf.Pointer != NULL)
               ACPI_FREE(buf.Pointer);

       return rv;
}

static ACPI_STATUS
acpicpu_tstate_tss_add(struct acpicpu_tstate *ts, ACPI_OBJECT *obj)
{
       ACPI_OBJECT *elm;
       uint32_t val[5];
       uint32_t *p;
       int i;

       if (obj->Type != ACPI_TYPE_PACKAGE)
               return AE_TYPE;

       if (obj->Package.Count != 5)
               return AE_BAD_DATA;

       elm = obj->Package.Elements;

       for (i = 0; i < 5; i++) {

               if (elm[i].Type != ACPI_TYPE_INTEGER)
                       return AE_TYPE;

               if (elm[i].Integer.Value > UINT32_MAX)
                       return AE_AML_NUMERIC_OVERFLOW;

               val[i] = elm[i].Integer.Value;
       }

       p = &ts->ts_percent;

       for (i = 0; i < 5; i++, p++)
               *p = val[i];

       /*
        * The minimum should be either 12.5 % or 6.5 %,
        * the latter 4-bit dynamic range being available
        * in some newer models; see Section 14.5.3.1 in
        *
        *      Intel 64 and IA-32 Architectures Software
        *      Developer's Manual. Volume 3B, Part 2. 2013.
        */
       if (ts->ts_percent < 6 || ts->ts_percent > 100)
               return AE_BAD_DECIMAL_CONSTANT;

       if (ts->ts_latency == 0 || ts->ts_latency > 1000)
               ts->ts_latency = 1;

       return AE_OK;
}

ACPI_STATUS
acpicpu_tstate_ptc(struct acpicpu_softc *sc)
{
       static const size_t size = sizeof(struct acpicpu_reg);
       struct acpicpu_reg *reg[2];
       ACPI_OBJECT *elm, *obj;
       ACPI_BUFFER buf;
       ACPI_STATUS rv;
       int i;

       rv = acpi_eval_struct(sc->sc_node->ad_handle, "_PTC", &buf);

       if (ACPI_FAILURE(rv))
               return rv;

       obj = buf.Pointer;

       if (obj->Type != ACPI_TYPE_PACKAGE) {
               rv = AE_TYPE;
               goto out;
       }

       if (obj->Package.Count != 2) {
               rv = AE_LIMIT;
               goto out;
       }

       for (i = 0; i < 2; i++) {

               elm = &obj->Package.Elements[i];

               if (elm->Type != ACPI_TYPE_BUFFER) {
                       rv = AE_TYPE;
                       goto out;
               }

               if (size > elm->Buffer.Length) {
                       rv = AE_AML_BAD_RESOURCE_LENGTH;
                       goto out;
               }

               reg[i] = (struct acpicpu_reg *)elm->Buffer.Pointer;

               switch (reg[i]->reg_spaceid) {

               case ACPI_ADR_SPACE_SYSTEM_MEMORY:

                       if (reg[i]->reg_addr == 0) {
                               rv = AE_AML_ILLEGAL_ADDRESS;
                               goto out;
                       }

                       break;

               case ACPI_ADR_SPACE_SYSTEM_IO:

                       if (reg[i]->reg_addr == 0) {
                               rv = AE_AML_ILLEGAL_ADDRESS;
                               goto out;
                       }

#if defined(__i386__) || defined(__x86_64__)
                       /*
                        * Check that the values match the IA32 clock
                        * modulation MSR, where the bit 0 is reserved,
                        * bits 1 through 3 define the duty cycle, and
                        * the fourth bit enables the modulation.
                        */
                       if (reg[i]->reg_bitwidth != 4) {
                               rv = AE_AML_BAD_RESOURCE_VALUE;
                               goto out;
                       }

                       if (reg[i]->reg_bitoffset != 1) {
                               rv = AE_AML_BAD_RESOURCE_VALUE;
                               goto out;
                       }
#endif

                       break;

               case ACPI_ADR_SPACE_FIXED_HARDWARE:

                       if ((sc->sc_flags & ACPICPU_FLAG_T_FFH) == 0) {
                               rv = AE_SUPPORT;
                               goto out;
                       }

                       break;

               default:
                       rv = AE_AML_INVALID_SPACE_ID;
                       goto out;
               }
       }

       if (reg[0]->reg_spaceid != reg[1]->reg_spaceid) {
               rv = AE_AML_INVALID_SPACE_ID;
               goto out;
       }

       (void)memcpy(&sc->sc_tstate_control, reg[0], size);
       (void)memcpy(&sc->sc_tstate_status,  reg[1], size);

out:
       if (buf.Pointer != NULL)
               ACPI_FREE(buf.Pointer);

       return rv;
}

static ACPI_STATUS
acpicpu_tstate_dep(struct acpicpu_softc *sc)
{
       ACPI_OBJECT *elm, *obj;
       ACPI_BUFFER buf;
       ACPI_STATUS rv;
       uint32_t val;
       uint8_t i, n;

       rv = acpi_eval_struct(sc->sc_node->ad_handle, "_TSD", &buf);

       if (ACPI_FAILURE(rv))
               goto out;

       obj = buf.Pointer;

       if (obj->Type != ACPI_TYPE_PACKAGE) {
               rv = AE_TYPE;
               goto out;
       }

       if (obj->Package.Count != 1) {
               rv = AE_LIMIT;
               goto out;
       }

       elm = &obj->Package.Elements[0];

       if (obj->Type != ACPI_TYPE_PACKAGE) {
               rv = AE_TYPE;
               goto out;
       }

       n = elm->Package.Count;

       if (n != 5) {
               rv = AE_LIMIT;
               goto out;
       }

       elm = elm->Package.Elements;

       for (i = 0; i < n; i++) {

               if (elm[i].Type != ACPI_TYPE_INTEGER) {
                       rv = AE_TYPE;
                       goto out;
               }

               if (elm[i].Integer.Value > UINT32_MAX) {
                       rv = AE_AML_NUMERIC_OVERFLOW;
                       goto out;
               }
       }

       val = elm[1].Integer.Value;

       if (val != 0)
               aprint_debug_dev(sc->sc_dev, "invalid revision in _TSD\n");

       val = elm[3].Integer.Value;

       if (val < ACPICPU_DEP_SW_ALL || val > ACPICPU_DEP_HW_ALL) {
               rv = AE_AML_BAD_RESOURCE_VALUE;
               goto out;
       }

       val = elm[4].Integer.Value;

       if (val > sc->sc_ncpus) {
               rv = AE_BAD_VALUE;
               goto out;
       }

       sc->sc_tstate_dep.dep_domain = elm[2].Integer.Value;
       sc->sc_tstate_dep.dep_type   = elm[3].Integer.Value;
       sc->sc_tstate_dep.dep_ncpus  = elm[4].Integer.Value;

out:
       if (ACPI_FAILURE(rv) && rv != AE_NOT_FOUND)
               aprint_debug_dev(sc->sc_dev, "failed to evaluate "
                   "_TSD: %s\n", AcpiFormatException(rv));

       if (buf.Pointer != NULL)
               ACPI_FREE(buf.Pointer);

       return rv;
}

static ACPI_STATUS
acpicpu_tstate_fadt(struct acpicpu_softc *sc)
{
       static const size_t size = sizeof(struct acpicpu_tstate);
       const uint8_t offset = AcpiGbl_FADT.DutyOffset;
       const uint8_t width = AcpiGbl_FADT.DutyWidth;
       uint8_t beta, count, i;

       if (sc->sc_object.ao_pblkaddr == 0)
               return AE_AML_ILLEGAL_ADDRESS;

       /*
        * A zero DUTY_WIDTH may be used announce
        * that T-states are not available via FADT
        * (ACPI 4.0, p. 121). See also (section 9.3):
        *
        *      Advanced Micro Devices: BIOS and Kernel
        *      Developer's Guide for AMD Athlon 64 and
        *      AMD Opteron Processors. Revision 3.30,
        *      February 2006.
        */
       if (width == 0 || width + offset > 4)
               return AE_AML_BAD_RESOURCE_VALUE;

       count = 1 << width;

       if (sc->sc_tstate != NULL)
               kmem_free(sc->sc_tstate, sc->sc_tstate_count * size);

       sc->sc_tstate = kmem_zalloc(count * size, KM_SLEEP);
       sc->sc_tstate_count = count;

       /*
        * Approximate duty cycles and set the MSR values.
        */
       for (beta = 100 / count, i = 0; i < count; i++) {
               sc->sc_tstate[i].ts_percent = 100 - beta * i;
               sc->sc_tstate[i].ts_latency = 1;
       }

       for (i = 1; i < count; i++)
               sc->sc_tstate[i].ts_control = (count - i) | __BIT(3);

       /*
        * Fake values for throttling registers.
        */
       (void)memset(&sc->sc_tstate_status, 0, sizeof(struct acpicpu_reg));
       (void)memset(&sc->sc_tstate_control, 0, sizeof(struct acpicpu_reg));

       sc->sc_tstate_status.reg_bitwidth = width;
       sc->sc_tstate_status.reg_bitoffset = offset;
       sc->sc_tstate_status.reg_addr = sc->sc_object.ao_pblkaddr;
       sc->sc_tstate_status.reg_spaceid = ACPI_ADR_SPACE_SYSTEM_IO;

       sc->sc_tstate_control.reg_bitwidth = width;
       sc->sc_tstate_control.reg_bitoffset = offset;
       sc->sc_tstate_control.reg_addr = sc->sc_object.ao_pblkaddr;
       sc->sc_tstate_control.reg_spaceid = ACPI_ADR_SPACE_SYSTEM_IO;

       return AE_OK;
}

static ACPI_STATUS
acpicpu_tstate_change(struct acpicpu_softc *sc)
{
       ACPI_INTEGER val;
       ACPI_STATUS rv;

       acpicpu_tstate_reset(sc);

       /*
        * Evaluate the available T-state window:
        *
        *   _TPC : either this maximum or any lower power
        *          (i.e. higher numbered) state may be used.
        *
        *   _TDL : either this minimum or any higher power
        *          (i.e. lower numbered) state may be used.
        *
        *   _TDL >= _TPC || _TDL >= _TSS[last entry].
        */
       rv = acpi_eval_integer(sc->sc_node->ad_handle, "_TPC", &val);

       if (ACPI_SUCCESS(rv) && val < sc->sc_tstate_count) {

               if (sc->sc_tstate[val].ts_percent != 0)
                       sc->sc_tstate_max = val;
       }

       rv = acpi_eval_integer(sc->sc_node->ad_handle, "_TDL", &val);

       if (ACPI_SUCCESS(rv) && val < sc->sc_tstate_count) {

               if (val >= sc->sc_tstate_max &&
                   sc->sc_tstate[val].ts_percent != 0)
                       sc->sc_tstate_min = val;
       }

       return AE_OK;
}

static void
acpicpu_tstate_reset(struct acpicpu_softc *sc)
{

       sc->sc_tstate_max = 0;
       sc->sc_tstate_min = sc->sc_tstate_count - 1;
}

int
acpicpu_tstate_get(struct cpu_info *ci, uint32_t *percent)
{
       struct acpicpu_tstate *ts = NULL;
       struct acpicpu_softc *sc;
       uint32_t i, val = 0;
       int rv;

       sc = acpicpu_sc[ci->ci_acpiid];

       if (__predict_false(sc == NULL)) {
               rv = ENXIO;
               goto fail;
       }

       if (__predict_false(sc->sc_cold != false)) {
               rv = EBUSY;
               goto fail;
       }

       if (__predict_false((sc->sc_flags & ACPICPU_FLAG_T) == 0)) {
               rv = ENODEV;
               goto fail;
       }

       mutex_enter(&sc->sc_mtx);

       if (sc->sc_tstate_current != ACPICPU_T_STATE_UNKNOWN) {
               *percent = sc->sc_tstate_current;
               mutex_exit(&sc->sc_mtx);
               return 0;
       }

       mutex_exit(&sc->sc_mtx);

       switch (sc->sc_tstate_status.reg_spaceid) {

       case ACPI_ADR_SPACE_FIXED_HARDWARE:

               rv = acpicpu_md_tstate_get(sc, percent);

               if (__predict_false(rv != 0))
                       goto fail;

               break;

       case ACPI_ADR_SPACE_SYSTEM_IO:
       case ACPI_ADR_SPACE_SYSTEM_MEMORY:

               val = acpicpu_readreg(&sc->sc_tstate_status);

               for (i = 0; i < sc->sc_tstate_count; i++) {

                       if (sc->sc_tstate[i].ts_percent == 0)
                               continue;

                       if (val == sc->sc_tstate[i].ts_status) {
                               ts = &sc->sc_tstate[i];
                               break;
                       }
               }

               if (ts == NULL) {
                       rv = EIO;
                       goto fail;
               }

               *percent = ts->ts_percent;
               break;

       default:
               rv = ENOTTY;
               goto fail;
       }

       mutex_enter(&sc->sc_mtx);
       sc->sc_tstate_current = *percent;
       mutex_exit(&sc->sc_mtx);

       return 0;

fail:
       aprint_error_dev(sc->sc_dev, "failed "
           "to get T-state (err %d)\n", rv);

       mutex_enter(&sc->sc_mtx);
       *percent = sc->sc_tstate_current = ACPICPU_T_STATE_UNKNOWN;
       mutex_exit(&sc->sc_mtx);

       return rv;
}

void
acpicpu_tstate_set(struct cpu_info *ci, uint32_t percent)
{
       uint64_t xc;

       xc = xc_broadcast(0, acpicpu_tstate_set_xcall, &percent, NULL);
       xc_wait(xc);
}

static void
acpicpu_tstate_set_xcall(void *arg1, void *arg2)
{
       struct acpicpu_tstate *ts = NULL;
       struct cpu_info *ci = curcpu();
       struct acpicpu_softc *sc;
       uint32_t i, percent, val;
       int rv;

       percent = *(uint32_t *)arg1;
       sc = acpicpu_sc[ci->ci_acpiid];

       if (__predict_false(sc == NULL)) {
               rv = ENXIO;
               goto fail;
       }

       if (__predict_false(sc->sc_cold != false)) {
               rv = EBUSY;
               goto fail;
       }

       if (__predict_false((sc->sc_flags & ACPICPU_FLAG_T) == 0)) {
               rv = ENODEV;
               goto fail;
       }

       mutex_enter(&sc->sc_mtx);

       if (sc->sc_tstate_current == percent) {
               mutex_exit(&sc->sc_mtx);
               return;
       }

       for (i = sc->sc_tstate_max; i <= sc->sc_tstate_min; i++) {

               if (__predict_false(sc->sc_tstate[i].ts_percent == 0))
                       continue;

               if (sc->sc_tstate[i].ts_percent == percent) {
                       ts = &sc->sc_tstate[i];
                       break;
               }
       }

       mutex_exit(&sc->sc_mtx);

       if (__predict_false(ts == NULL)) {
               rv = EINVAL;
               goto fail;
       }

       switch (sc->sc_tstate_control.reg_spaceid) {

       case ACPI_ADR_SPACE_FIXED_HARDWARE:

               rv = acpicpu_md_tstate_set(ts);

               if (__predict_false(rv != 0))
                       goto fail;

               break;

       case ACPI_ADR_SPACE_SYSTEM_IO:
       case ACPI_ADR_SPACE_SYSTEM_MEMORY:

               acpicpu_writereg(&sc->sc_tstate_control, ts->ts_control);

               /*
                * If the status field is zero, the transition is
                * specified to be "asynchronous" and there is no
                * need to check the status (ACPI 4.0, 8.4.3.2).
                */
               if (ts->ts_status == 0)
                       break;

               for (i = 0; i < ACPICPU_T_STATE_RETRY; i++) {

                       val = acpicpu_readreg(&sc->sc_tstate_status);

                       if (val == ts->ts_status)
                               break;

                       DELAY(ts->ts_latency);
               }

               if (i == ACPICPU_T_STATE_RETRY) {
                       rv = EAGAIN;
                       goto fail;
               }

               break;

       default:
               rv = ENOTTY;
               goto fail;
       }

       mutex_enter(&sc->sc_mtx);
       ts->ts_evcnt.ev_count++;
       sc->sc_tstate_current = percent;
       mutex_exit(&sc->sc_mtx);

       return;

fail:
       if (rv != EINVAL)
               aprint_error_dev(sc->sc_dev, "failed to "
                   "throttle to %u %% (err %d)\n", percent, rv);

       mutex_enter(&sc->sc_mtx);
       sc->sc_tstate_current = ACPICPU_T_STATE_UNKNOWN;
       mutex_exit(&sc->sc_mtx);
}