/** * pm_req_wakeup() - PM call for processor to wake up selected processor * or subsystem * @target Node id of the processor or subsystem to wake up * @ack Flag to specify whether acknowledge requested * @set_address Resume address presence indicator * 1 resume address specified, 0 otherwise * @address Resume address * * This API function is either used to power up another APU core for SMP * (by PSCI) or to power up an entirely different PU or subsystem, such * as RPU0, RPU, or PL_CORE_xx. Resume address for the target PU will be * automatically set by PMU. * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_req_wakeup(enum pm_node_id target, unsigned int set_address, uintptr_t address, enum pm_request_ack ack) { uint32_t payload[PAYLOAD_ARG_CNT]; uint64_t encoded_address; const struct pm_proc *proc = pm_get_proc_by_node(target); /* invoke APU-specific code for waking up another APU core */ pm_client_wakeup(proc); /* encode set Address into 1st bit of address */ encoded_address = address; encoded_address |= !!set_address; /* Send request to the PMU to perform the wake of the PU */ PM_PACK_PAYLOAD5(payload, PM_REQ_WAKEUP, target, encoded_address, encoded_address >> 32, ack); if (ack == REQ_ACK_BLOCKING) return pm_ipi_send_sync(primary_proc, payload, NULL); else return pm_ipi_send(primary_proc, payload); }
/** * pm_mmio_read() - Read value from protected mmio * @address Address to write to * @value Value to write * * This function provides access to PM-related control registers * that may not be directly accessible by a particular PU. * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_mmio_read(uintptr_t address, unsigned int *value) { uint32_t payload[PAYLOAD_ARG_CNT]; /* Send request to the PMU */ PM_PACK_PAYLOAD2(payload, PM_MMIO_READ, address); return pm_ipi_send_sync(primary_proc, payload, value); }
/** * pm_get_api_version() - Get version number of PMU PM firmware * @version Returns 32-bit version number of PMU Power Management Firmware * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_get_api_version(unsigned int *version) { uint32_t payload[PAYLOAD_ARG_CNT]; /* Send request to the PMU */ PM_PACK_PAYLOAD1(payload, PM_GET_API_VERSION); return pm_ipi_send_sync(primary_proc, payload, version); }
/** * pm_reset_get_status() - Get current status of a reset line * @reset Reset ID * @reset_status Returns current status of selected reset line * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_reset_get_status(unsigned int reset, unsigned int *reset_status) { uint32_t payload[PAYLOAD_ARG_CNT]; /* Send request to the PMU */ PM_PACK_PAYLOAD2(payload, PM_RESET_GET_STATUS, reset); return pm_ipi_send_sync(primary_proc, payload, reset_status); }
/** * pm_force_powerdown() - PM call to request for another PU or subsystem to * be powered down forcefully * @target Node id of the targeted PU or subsystem * @ack Flag to specify whether acknowledge is requested * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_force_powerdown(enum pm_node_id target, enum pm_request_ack ack) { uint32_t payload[PAYLOAD_ARG_CNT]; /* Send request to the PMU */ PM_PACK_PAYLOAD3(payload, PM_FORCE_POWERDOWN, target, ack); if (ack == REQ_ACK_BLOCKING) return pm_ipi_send_sync(primary_proc, payload, NULL); else return pm_ipi_send(primary_proc, payload); }
/** * pm_req_suspend() - PM call to request for another PU or subsystem to * be suspended gracefully. * @target Node id of the targeted PU or subsystem * @ack Flag to specify whether acknowledge is requested * @latency Requested wakeup latency (not supported) * @state Requested state (not supported) * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_req_suspend(enum pm_node_id target, enum pm_request_ack ack, unsigned int latency, unsigned int state) { uint32_t payload[PAYLOAD_ARG_CNT]; /* Send request to the PMU */ PM_PACK_PAYLOAD5(payload, PM_REQ_SUSPEND, target, ack, latency, state); if (ack == REQ_ACK_BLOCKING) return pm_ipi_send_sync(primary_proc, payload, NULL); else return pm_ipi_send(primary_proc, payload); }
/** * pm_req_node() - PM call to request a node with specific capabilities * @nid Node id of the slave * @capabilities Requested capabilities of the slave * @qos Quality of service (not supported) * @ack Flag to specify whether acknowledge is requested * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_req_node(enum pm_node_id nid, unsigned int capabilities, unsigned int qos, enum pm_request_ack ack) { uint32_t payload[PAYLOAD_ARG_CNT]; PM_PACK_PAYLOAD5(payload, PM_REQ_NODE, nid, capabilities, qos, ack); if (ack == REQ_ACK_BLOCKING) return pm_ipi_send_sync(primary_proc, payload, NULL); else return pm_ipi_send(primary_proc, payload); }
/** * pm_set_requirement() - PM call to set requirement for PM slaves * @nid Node id of the slave * @capabilities Requested capabilities of the slave * @qos Quality of service (not supported) * @ack Flag to specify whether acknowledge is requested * * This API function is to be used for slaves a PU already has requested * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_set_requirement(const enum pm_node_id nid, const uint32_t capabilities, const uint32_t qos, const enum pm_request_ack ack) { uint32_t payload[PAYLOAD_ARG_CNT]; PM_PACK_PAYLOAD5(payload, PM_SET_REQUIREMENT, nid, capabilities, qos, ack); if (REQ_ACK_BLOCKING == ack) return pm_ipi_send_sync(primary_proc, payload, NULL); else return pm_ipi_send(primary_proc, payload); }
/** * pm_self_suspend() - PM call for processor to suspend itself * @nid Node id of the processor or subsystem * @latency Requested maximum wakeup latency (not supported) * @state Requested state (not supported) * @address Resume address * * This is a blocking call, it will return only once PMU has responded. * On a wakeup, resume address will be automatically set by PMU. * * @return Returns status, either success or error+reason */ enum pm_ret_status pm_self_suspend(enum pm_node_id nid, unsigned int latency, unsigned int state, uintptr_t address) { uint32_t payload[PAYLOAD_ARG_CNT]; unsigned int cpuid = plat_my_core_pos(); const struct pm_proc *proc = pm_get_proc(cpuid); /* * Do client specific suspend operations * (e.g. set powerdown request bit) */ pm_client_suspend(proc); /* Send request to the PMU */ PM_PACK_PAYLOAD6(payload, PM_SELF_SUSPEND, proc->node_id, latency, state, address, (address >> 32)); return pm_ipi_send_sync(proc, payload, NULL); }