sq_scpi.h 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283
  1. /*
  2. * Copyright (c) 2018, ARM Limited and Contributors. All rights reserved.
  3. *
  4. * SPDX-License-Identifier: BSD-3-Clause
  5. */
  6. #ifndef SQ_SCPI_H
  7. #define SQ_SCPI_H
  8. #include <stddef.h>
  9. #include <stdint.h>
  10. /*
  11. * An SCPI command consists of a header and a payload.
  12. * The following structure describes the header. It is 64-bit long.
  13. */
  14. typedef struct {
  15. /* Command ID */
  16. uint32_t id : 7;
  17. /* Set ID. Identifies whether this is a standard or extended command. */
  18. uint32_t set : 1;
  19. /* Sender ID to match a reply. The value is sender specific. */
  20. uint32_t sender : 8;
  21. /* Size of the payload in bytes (0 - 511) */
  22. uint32_t size : 9;
  23. uint32_t reserved : 7;
  24. /*
  25. * Status indicating the success of a command.
  26. * See the enum below.
  27. */
  28. uint32_t status;
  29. } scpi_cmd_t;
  30. typedef enum {
  31. SCPI_SET_NORMAL = 0, /* Normal SCPI commands */
  32. SCPI_SET_EXTENDED /* Extended SCPI commands */
  33. } scpi_set_t;
  34. enum {
  35. SCP_OK = 0, /* Success */
  36. SCP_E_PARAM, /* Invalid parameter(s) */
  37. SCP_E_ALIGN, /* Invalid alignment */
  38. SCP_E_SIZE, /* Invalid size */
  39. SCP_E_HANDLER, /* Invalid handler or callback */
  40. SCP_E_ACCESS, /* Invalid access or permission denied */
  41. SCP_E_RANGE, /* Value out of range */
  42. SCP_E_TIMEOUT, /* Time out has ocurred */
  43. SCP_E_NOMEM, /* Invalid memory area or pointer */
  44. SCP_E_PWRSTATE, /* Invalid power state */
  45. SCP_E_SUPPORT, /* Feature not supported or disabled */
  46. SCPI_E_DEVICE, /* Device error */
  47. SCPI_E_BUSY, /* Device is busy */
  48. };
  49. typedef uint32_t scpi_status_t;
  50. typedef enum {
  51. SCPI_CMD_SCP_READY = 0x01,
  52. SCPI_CMD_SET_POWER_STATE = 0x03,
  53. SCPI_CMD_SYS_POWER_STATE = 0x05
  54. } scpi_command_t;
  55. typedef enum {
  56. scpi_power_on = 0,
  57. scpi_power_retention = 1,
  58. scpi_power_off = 3,
  59. } scpi_power_state_t;
  60. typedef enum {
  61. scpi_system_shutdown = 0,
  62. scpi_system_reboot = 1,
  63. scpi_system_reset = 2
  64. } scpi_system_state_t;
  65. extern int scpi_wait_ready(void);
  66. extern void scpi_set_sq_power_state(unsigned int mpidr,
  67. scpi_power_state_t cpu_state,
  68. scpi_power_state_t cluster_state,
  69. scpi_power_state_t css_state);
  70. uint32_t scpi_sys_power_state(scpi_system_state_t system_state);
  71. uint32_t scpi_get_draminfo(struct draminfo *info);
  72. #endif /* SQ_SCPI_H */