sys/dev/psci/psci.h

   1 /*-
   2  * Copyright (c) 2013, 2014 Robin Randhawa
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28
  29 #ifndef _MACHINE_PSCI_H_
  30 #define _MACHINE_PSCI_H_
  31
  32 #include <sys/types.h>
  33
  34 typedef int (*psci_initfn_t)(device_t dev);
  35 typedef int (*psci_callfn_t)(register_t, register_t, register_t, register_t);
  36
  37 extern int psci_present;
  38
  39 void    psci_reset(void);
  40 int     psci_cpu_on(unsigned long, unsigned long, unsigned long);
  41 int     psci_hvc_despatch(register_t, register_t, register_t, register_t);
  42 int     psci_smc_despatch(register_t, register_t, register_t, register_t);
  43
  44 int     psci_get_version(void);
  45
  46 /*
  47  * PSCI return codes.
  48  */
  49 #define PSCI_RETVAL_SUCCESS             0
  50 #define PSCI_RETVAL_NOT_SUPPORTED       -1
  51 #define PSCI_RETVAL_INVALID_PARAMS      -2
  52 #define PSCI_RETVAL_DENIED              -3
  53 #define PSCI_RETVAL_ALREADY_ON          -4
  54 #define PSCI_RETVAL_ON_PENDING          -5
  55 #define PSCI_RETVAL_INTERNAL_FAILURE    -6
  56 #define PSCI_RETVAL_NOT_PRESENT         -7
  57 #define PSCI_RETVAL_DISABLED            -8
  58 /*
  59  * Used to signal PSCI is not available, e.g. to start a CPU.
  60  */
  61 #define PSCI_MISSING                    1
  62
  63 /*
  64  * PSCI function codes (as per PSCI v0.2).
  65  */
  66 #ifdef __aarch64__
  67 #define PSCI_FNID_VERSION               0x84000000
  68 #define PSCI_FNID_CPU_SUSPEND           0xc4000001
  69 #define PSCI_FNID_CPU_OFF               0x84000002
  70 #define PSCI_FNID_CPU_ON                0xc4000003
  71 #define PSCI_FNID_AFFINITY_INFO         0xc4000004
  72 #define PSCI_FNID_MIGRATE               0xc4000005
  73 #define PSCI_FNID_MIGRATE_INFO_TYPE     0x84000006
  74 #define PSCI_FNID_MIGRATE_INFO_UP_CPU   0xc4000007
  75 #define PSCI_FNID_SYSTEM_OFF            0x84000008
  76 #define PSCI_FNID_SYSTEM_RESET          0x84000009
  77 #else
  78 #define PSCI_FNID_VERSION               0x84000000
  79 #define PSCI_FNID_CPU_SUSPEND           0x84000001
  80 #define PSCI_FNID_CPU_OFF               0x84000002
  81 #define PSCI_FNID_CPU_ON                0x84000003
  82 #define PSCI_FNID_AFFINITY_INFO         0x84000004
  83 #define PSCI_FNID_MIGRATE               0x84000005
  84 #define PSCI_FNID_MIGRATE_INFO_TYPE     0x84000006
  85 #define PSCI_FNID_MIGRATE_INFO_UP_CPU   0x84000007
  86 #define PSCI_FNID_SYSTEM_OFF            0x84000008
  87 #define PSCI_FNID_SYSTEM_RESET          0x84000009
  88 #endif
  89
  90 #define PSCI_VER_MAJOR(v)               (((v) >> 16) & 0xFF)
  91 #define PSCI_VER_MINOR(v)               ((v) & 0xFF)
  92
  93 enum psci_fn {
  94         PSCI_FN_VERSION,
  95         PSCI_FN_CPU_SUSPEND,
  96         PSCI_FN_CPU_OFF,
  97         PSCI_FN_CPU_ON,
  98         PSCI_FN_AFFINITY_INFO,
  99         PSCI_FN_MIGRATE,
 100         PSCI_FN_MIGRATE_INFO_TYPE,
 101         PSCI_FN_MIGRATE_INFO_UP_CPU,
 102         PSCI_FN_SYSTEM_OFF,
 103         PSCI_FN_SYSTEM_RESET,
 104         PSCI_FN_MAX
 105 };
 106
 107 #endif /* _MACHINE_PSCI_H_ */