opal.h 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396
  1. /* SPDX-License-Identifier: GPL-2.0-or-later */
  2. /*
  3. * PowerNV OPAL definitions.
  4. *
  5. * Copyright 2011 IBM Corp.
  6. */
  7. #ifndef _ASM_POWERPC_OPAL_H
  8. #define _ASM_POWERPC_OPAL_H
  9. #include <asm/opal-api.h>
  10. #ifndef __ASSEMBLY__
  11. #include <linux/notifier.h>
  12. /* We calculate number of sg entries based on PAGE_SIZE */
  13. #define SG_ENTRIES_PER_NODE ((PAGE_SIZE - 16) / sizeof(struct opal_sg_entry))
  14. /* Default time to sleep or delay between OPAL_BUSY/OPAL_BUSY_EVENT loops */
  15. #define OPAL_BUSY_DELAY_MS 10
  16. /* /sys/firmware/opal */
  17. extern struct kobject *opal_kobj;
  18. /* /ibm,opal */
  19. extern struct device_node *opal_node;
  20. /* API functions */
  21. int64_t opal_invalid_call(void);
  22. int64_t opal_npu_map_lpar(uint64_t phb_id, uint64_t bdf, uint64_t lparid,
  23. uint64_t lpcr);
  24. int64_t opal_npu_spa_setup(uint64_t phb_id, uint32_t bdfn,
  25. uint64_t addr, uint64_t PE_mask);
  26. int64_t opal_npu_spa_clear_cache(uint64_t phb_id, uint32_t bdfn,
  27. uint64_t PE_handle);
  28. int64_t opal_npu_tl_set(uint64_t phb_id, uint32_t bdfn, long cap,
  29. uint64_t rate_phys, uint32_t size);
  30. int64_t opal_console_write(int64_t term_number, __be64 *length,
  31. const uint8_t *buffer);
  32. int64_t opal_console_read(int64_t term_number, __be64 *length,
  33. uint8_t *buffer);
  34. int64_t opal_console_write_buffer_space(int64_t term_number,
  35. __be64 *length);
  36. int64_t opal_console_flush(int64_t term_number);
  37. int64_t opal_rtc_read(__be32 *year_month_day,
  38. __be64 *hour_minute_second_millisecond);
  39. int64_t opal_rtc_write(uint32_t year_month_day,
  40. uint64_t hour_minute_second_millisecond);
  41. int64_t opal_tpo_read(uint64_t token, __be32 *year_mon_day, __be32 *hour_min);
  42. int64_t opal_tpo_write(uint64_t token, uint32_t year_mon_day,
  43. uint32_t hour_min);
  44. int64_t opal_cec_power_down(uint64_t request);
  45. int64_t opal_cec_reboot(void);
  46. int64_t opal_cec_reboot2(uint32_t reboot_type, const char *diag);
  47. int64_t opal_read_nvram(uint64_t buffer, uint64_t size, uint64_t offset);
  48. int64_t opal_write_nvram(uint64_t buffer, uint64_t size, uint64_t offset);
  49. int64_t opal_handle_interrupt(uint64_t isn, __be64 *outstanding_event_mask);
  50. int64_t opal_poll_events(__be64 *outstanding_event_mask);
  51. int64_t opal_pci_set_hub_tce_memory(uint64_t hub_id, uint64_t tce_mem_addr,
  52. uint64_t tce_mem_size);
  53. int64_t opal_pci_set_phb_tce_memory(uint64_t phb_id, uint64_t tce_mem_addr,
  54. uint64_t tce_mem_size);
  55. int64_t opal_pci_config_read_byte(uint64_t phb_id, uint64_t bus_dev_func,
  56. uint64_t offset, uint8_t *data);
  57. int64_t opal_pci_config_read_half_word(uint64_t phb_id, uint64_t bus_dev_func,
  58. uint64_t offset, __be16 *data);
  59. int64_t opal_pci_config_read_word(uint64_t phb_id, uint64_t bus_dev_func,
  60. uint64_t offset, __be32 *data);
  61. int64_t opal_pci_config_write_byte(uint64_t phb_id, uint64_t bus_dev_func,
  62. uint64_t offset, uint8_t data);
  63. int64_t opal_pci_config_write_half_word(uint64_t phb_id, uint64_t bus_dev_func,
  64. uint64_t offset, uint16_t data);
  65. int64_t opal_pci_config_write_word(uint64_t phb_id, uint64_t bus_dev_func,
  66. uint64_t offset, uint32_t data);
  67. int64_t opal_set_xive(uint32_t isn, uint16_t server, uint8_t priority);
  68. int64_t opal_get_xive(uint32_t isn, __be16 *server, uint8_t *priority);
  69. int64_t opal_register_exception_handler(uint64_t opal_exception,
  70. uint64_t handler_address,
  71. uint64_t glue_cache_line);
  72. int64_t opal_pci_eeh_freeze_status(uint64_t phb_id, uint64_t pe_number,
  73. uint8_t *freeze_state,
  74. __be16 *pci_error_type,
  75. __be64 *phb_status);
  76. int64_t opal_pci_eeh_freeze_clear(uint64_t phb_id, uint64_t pe_number,
  77. uint64_t eeh_action_token);
  78. int64_t opal_pci_eeh_freeze_set(uint64_t phb_id, uint64_t pe_number,
  79. uint64_t eeh_action_token);
  80. int64_t opal_pci_err_inject(uint64_t phb_id, uint32_t pe_no, uint32_t type,
  81. uint32_t func, uint64_t addr, uint64_t mask);
  82. int64_t opal_pci_shpc(uint64_t phb_id, uint64_t shpc_action, uint8_t *state);
  83. int64_t opal_pci_phb_mmio_enable(uint64_t phb_id, uint16_t window_type,
  84. uint16_t window_num, uint16_t enable);
  85. int64_t opal_pci_set_phb_mem_window(uint64_t phb_id, uint16_t window_type,
  86. uint16_t window_num,
  87. uint64_t starting_real_address,
  88. uint64_t starting_pci_address,
  89. uint64_t size);
  90. int64_t opal_pci_map_pe_mmio_window(uint64_t phb_id, uint16_t pe_number,
  91. uint16_t window_type, uint16_t window_num,
  92. uint16_t segment_num);
  93. int64_t opal_pci_set_phb_table_memory(uint64_t phb_id, uint64_t rtt_addr,
  94. uint64_t ivt_addr, uint64_t ivt_len,
  95. uint64_t reject_array_addr,
  96. uint64_t peltv_addr);
  97. int64_t opal_pci_set_pe(uint64_t phb_id, uint64_t pe_number, uint64_t bus_dev_func,
  98. uint8_t bus_compare, uint8_t dev_compare, uint8_t func_compare,
  99. uint8_t pe_action);
  100. int64_t opal_pci_set_peltv(uint64_t phb_id, uint32_t parent_pe, uint32_t child_pe,
  101. uint8_t state);
  102. int64_t opal_pci_set_mve(uint64_t phb_id, uint32_t mve_number, uint32_t pe_number);
  103. int64_t opal_pci_set_mve_enable(uint64_t phb_id, uint32_t mve_number,
  104. uint32_t state);
  105. int64_t opal_pci_get_xive_reissue(uint64_t phb_id, uint32_t xive_number,
  106. uint8_t *p_bit, uint8_t *q_bit);
  107. int64_t opal_pci_set_xive_reissue(uint64_t phb_id, uint32_t xive_number,
  108. uint8_t p_bit, uint8_t q_bit);
  109. int64_t opal_pci_msi_eoi(uint64_t phb_id, uint32_t hw_irq);
  110. int64_t opal_pci_set_xive_pe(uint64_t phb_id, uint32_t pe_number,
  111. uint32_t xive_num);
  112. int64_t opal_get_xive_source(uint64_t phb_id, uint32_t xive_num,
  113. __be32 *interrupt_source_number);
  114. int64_t opal_get_msi_32(uint64_t phb_id, uint32_t mve_number, uint32_t xive_num,
  115. uint8_t msi_range, __be32 *msi_address,
  116. __be32 *message_data);
  117. int64_t opal_get_msi_64(uint64_t phb_id, uint32_t mve_number,
  118. uint32_t xive_num, uint8_t msi_range,
  119. __be64 *msi_address, __be32 *message_data);
  120. int64_t opal_start_cpu(uint64_t thread_number, uint64_t start_address);
  121. int64_t opal_query_cpu_status(uint64_t thread_number, uint8_t *thread_status);
  122. int64_t opal_write_oppanel(oppanel_line_t *lines, uint64_t num_lines);
  123. int64_t opal_pci_map_pe_dma_window(uint64_t phb_id, uint16_t pe_number, uint16_t window_id,
  124. uint16_t tce_levels, uint64_t tce_table_addr,
  125. uint64_t tce_table_size, uint64_t tce_page_size);
  126. int64_t opal_pci_map_pe_dma_window_real(uint64_t phb_id, uint16_t pe_number,
  127. uint16_t dma_window_number, uint64_t pci_start_addr,
  128. uint64_t pci_mem_size);
  129. int64_t opal_pci_reset(uint64_t id, uint8_t reset_scope, uint8_t assert_state);
  130. int64_t opal_pci_get_hub_diag_data(uint64_t hub_id, void *diag_buffer,
  131. uint64_t diag_buffer_len);
  132. int64_t opal_pci_get_phb_diag_data(uint64_t phb_id, void *diag_buffer,
  133. uint64_t diag_buffer_len);
  134. int64_t opal_pci_get_phb_diag_data2(uint64_t phb_id, void *diag_buffer,
  135. uint64_t diag_buffer_len);
  136. int64_t opal_pci_fence_phb(uint64_t phb_id);
  137. int64_t opal_pci_reinit(uint64_t phb_id, uint64_t reinit_scope, uint64_t data);
  138. int64_t opal_pci_mask_pe_error(uint64_t phb_id, uint16_t pe_number, uint8_t error_type, uint8_t mask_action);
  139. int64_t opal_set_slot_led_status(uint64_t phb_id, uint64_t slot_id, uint8_t led_type, uint8_t led_action);
  140. int64_t opal_get_epow_status(__be16 *epow_status, __be16 *num_epow_classes);
  141. int64_t opal_get_dpo_status(__be64 *dpo_timeout);
  142. int64_t opal_set_system_attention_led(uint8_t led_action);
  143. int64_t opal_pci_next_error(uint64_t phb_id, __be64 *first_frozen_pe,
  144. __be16 *pci_error_type, __be16 *severity);
  145. int64_t opal_pci_poll(uint64_t id);
  146. int64_t opal_return_cpu(void);
  147. int64_t opal_check_token(uint64_t token);
  148. int64_t opal_reinit_cpus(uint64_t flags);
  149. int64_t opal_xscom_read(uint32_t gcid, uint64_t pcb_addr, __be64 *val);
  150. int64_t opal_xscom_write(uint32_t gcid, uint64_t pcb_addr, uint64_t val);
  151. int64_t opal_lpc_write(uint32_t chip_id, enum OpalLPCAddressType addr_type,
  152. uint32_t addr, uint32_t data, uint32_t sz);
  153. int64_t opal_lpc_read(uint32_t chip_id, enum OpalLPCAddressType addr_type,
  154. uint32_t addr, __be32 *data, uint32_t sz);
  155. int64_t opal_read_elog(uint64_t buffer, uint64_t size, uint64_t log_id);
  156. int64_t opal_get_elog_size(__be64 *log_id, __be64 *size, __be64 *elog_type);
  157. int64_t opal_write_elog(uint64_t buffer, uint64_t size, uint64_t offset);
  158. int64_t opal_send_ack_elog(uint64_t log_id);
  159. void opal_resend_pending_logs(void);
  160. int64_t opal_validate_flash(uint64_t buffer, uint32_t *size, uint32_t *result);
  161. int64_t opal_manage_flash(uint8_t op);
  162. int64_t opal_update_flash(uint64_t blk_list);
  163. int64_t opal_dump_init(uint8_t dump_type);
  164. int64_t opal_dump_info(__be32 *dump_id, __be32 *dump_size);
  165. int64_t opal_dump_info2(__be32 *dump_id, __be32 *dump_size, __be32 *dump_type);
  166. int64_t opal_dump_read(uint32_t dump_id, uint64_t buffer);
  167. int64_t opal_dump_ack(uint32_t dump_id);
  168. int64_t opal_dump_resend_notification(void);
  169. int64_t opal_get_msg(uint64_t buffer, uint64_t size);
  170. int64_t opal_write_oppanel_async(uint64_t token, oppanel_line_t *lines,
  171. uint64_t num_lines);
  172. int64_t opal_check_completion(uint64_t buffer, uint64_t size, uint64_t token);
  173. int64_t opal_sync_host_reboot(void);
  174. int64_t opal_get_param(uint64_t token, uint32_t param_id, uint64_t buffer,
  175. uint64_t length);
  176. int64_t opal_set_param(uint64_t token, uint32_t param_id, uint64_t buffer,
  177. uint64_t length);
  178. int64_t opal_sensor_read(uint32_t sensor_hndl, int token, __be32 *sensor_data);
  179. int64_t opal_sensor_read_u64(u32 sensor_hndl, int token, __be64 *sensor_data);
  180. int64_t opal_handle_hmi(void);
  181. int64_t opal_handle_hmi2(__be64 *out_flags);
  182. int64_t opal_register_dump_region(uint32_t id, uint64_t start, uint64_t end);
  183. int64_t opal_unregister_dump_region(uint32_t id);
  184. int64_t opal_slw_set_reg(uint64_t cpu_pir, uint64_t sprn, uint64_t val);
  185. int64_t opal_config_cpu_idle_state(uint64_t state, uint64_t flag);
  186. int64_t opal_pci_set_phb_cxl_mode(uint64_t phb_id, uint64_t mode, uint64_t pe_number);
  187. int64_t opal_pci_get_pbcq_tunnel_bar(uint64_t phb_id, uint64_t *addr);
  188. int64_t opal_pci_set_pbcq_tunnel_bar(uint64_t phb_id, uint64_t addr);
  189. int64_t opal_ipmi_send(uint64_t interface, struct opal_ipmi_msg *msg,
  190. uint64_t msg_len);
  191. int64_t opal_ipmi_recv(uint64_t interface, struct opal_ipmi_msg *msg,
  192. uint64_t *msg_len);
  193. int64_t opal_i2c_request(uint64_t async_token, uint32_t bus_id,
  194. struct opal_i2c_request *oreq);
  195. int64_t opal_prd_msg(struct opal_prd_msg *msg);
  196. int64_t opal_leds_get_ind(char *loc_code, __be64 *led_mask,
  197. __be64 *led_value, __be64 *max_led_type);
  198. int64_t opal_leds_set_ind(uint64_t token, char *loc_code, const u64 led_mask,
  199. const u64 led_value, __be64 *max_led_type);
  200. int64_t opal_flash_read(uint64_t id, uint64_t offset, uint64_t buf,
  201. uint64_t size, uint64_t token);
  202. int64_t opal_flash_write(uint64_t id, uint64_t offset, uint64_t buf,
  203. uint64_t size, uint64_t token);
  204. int64_t opal_flash_erase(uint64_t id, uint64_t offset, uint64_t size,
  205. uint64_t token);
  206. int64_t opal_get_device_tree(uint32_t phandle, uint64_t buf, uint64_t len);
  207. int64_t opal_pci_get_presence_state(uint64_t id, uint64_t data);
  208. int64_t opal_pci_get_power_state(uint64_t id, uint64_t data);
  209. int64_t opal_pci_set_power_state(uint64_t async_token, uint64_t id,
  210. uint64_t data);
  211. int64_t opal_pci_poll2(uint64_t id, uint64_t data);
  212. int64_t opal_int_get_xirr(uint32_t *out_xirr, bool just_poll);
  213. int64_t opal_int_set_cppr(uint8_t cppr);
  214. int64_t opal_int_eoi(uint32_t xirr);
  215. int64_t opal_int_set_mfrr(uint32_t cpu, uint8_t mfrr);
  216. int64_t opal_pci_tce_kill(uint64_t phb_id, uint32_t kill_type,
  217. uint32_t pe_num, uint32_t tce_size,
  218. uint64_t dma_addr, uint32_t npages);
  219. int64_t opal_nmmu_set_ptcr(uint64_t chip_id, uint64_t ptcr);
  220. int64_t opal_xive_reset(uint64_t version);
  221. int64_t opal_xive_get_irq_info(uint32_t girq,
  222. __be64 *out_flags,
  223. __be64 *out_eoi_page,
  224. __be64 *out_trig_page,
  225. __be32 *out_esb_shift,
  226. __be32 *out_src_chip);
  227. int64_t opal_xive_get_irq_config(uint32_t girq, __be64 *out_vp,
  228. uint8_t *out_prio, __be32 *out_lirq);
  229. int64_t opal_xive_set_irq_config(uint32_t girq, uint64_t vp, uint8_t prio,
  230. uint32_t lirq);
  231. int64_t opal_xive_get_queue_info(uint64_t vp, uint32_t prio,
  232. __be64 *out_qpage,
  233. __be64 *out_qsize,
  234. __be64 *out_qeoi_page,
  235. __be32 *out_escalate_irq,
  236. __be64 *out_qflags);
  237. int64_t opal_xive_set_queue_info(uint64_t vp, uint32_t prio,
  238. uint64_t qpage,
  239. uint64_t qsize,
  240. uint64_t qflags);
  241. int64_t opal_xive_donate_page(uint32_t chip_id, uint64_t addr);
  242. int64_t opal_xive_alloc_vp_block(uint32_t alloc_order);
  243. int64_t opal_xive_free_vp_block(uint64_t vp);
  244. int64_t opal_xive_get_vp_info(uint64_t vp,
  245. __be64 *out_flags,
  246. __be64 *out_cam_value,
  247. __be64 *out_report_cl_pair,
  248. __be32 *out_chip_id);
  249. int64_t opal_xive_set_vp_info(uint64_t vp,
  250. uint64_t flags,
  251. uint64_t report_cl_pair);
  252. int64_t opal_xive_allocate_irq_raw(uint32_t chip_id);
  253. int64_t opal_xive_free_irq(uint32_t girq);
  254. int64_t opal_xive_sync(uint32_t type, uint32_t id);
  255. int64_t opal_xive_dump(uint32_t type, uint32_t id);
  256. int64_t opal_xive_get_queue_state(uint64_t vp, uint32_t prio,
  257. __be32 *out_qtoggle,
  258. __be32 *out_qindex);
  259. int64_t opal_xive_set_queue_state(uint64_t vp, uint32_t prio,
  260. uint32_t qtoggle,
  261. uint32_t qindex);
  262. int64_t opal_xive_get_vp_state(uint64_t vp, __be64 *out_w01);
  263. int64_t opal_imc_counters_init(uint32_t type, uint64_t address,
  264. uint64_t cpu_pir);
  265. int64_t opal_imc_counters_start(uint32_t type, uint64_t cpu_pir);
  266. int64_t opal_imc_counters_stop(uint32_t type, uint64_t cpu_pir);
  267. int opal_get_powercap(u32 handle, int token, u32 *pcap);
  268. int opal_set_powercap(u32 handle, int token, u32 pcap);
  269. int opal_get_power_shift_ratio(u32 handle, int token, u32 *psr);
  270. int opal_set_power_shift_ratio(u32 handle, int token, u32 psr);
  271. int opal_sensor_group_clear(u32 group_hndl, int token);
  272. int opal_sensor_group_enable(u32 group_hndl, int token, bool enable);
  273. int opal_nx_coproc_init(uint32_t chip_id, uint32_t ct);
  274. int opal_secvar_get(const char *key, uint64_t key_len, u8 *data,
  275. uint64_t *data_size);
  276. int opal_secvar_get_next(const char *key, uint64_t *key_len,
  277. uint64_t key_buf_size);
  278. int opal_secvar_enqueue_update(const char *key, uint64_t key_len, u8 *data,
  279. uint64_t data_size);
  280. s64 opal_mpipl_update(enum opal_mpipl_ops op, u64 src, u64 dest, u64 size);
  281. s64 opal_mpipl_register_tag(enum opal_mpipl_tags tag, u64 addr);
  282. s64 opal_mpipl_query_tag(enum opal_mpipl_tags tag, __be64 *addr);
  283. s64 opal_signal_system_reset(s32 cpu);
  284. s64 opal_quiesce(u64 shutdown_type, s32 cpu);
  285. /* Internal functions */
  286. extern int early_init_dt_scan_opal(unsigned long node, const char *uname,
  287. int depth, void *data);
  288. extern int early_init_dt_scan_recoverable_ranges(unsigned long node,
  289. const char *uname, int depth, void *data);
  290. void __init opal_configure_cores(void);
  291. extern int opal_get_chars(uint32_t vtermno, char *buf, int count);
  292. extern int opal_put_chars(uint32_t vtermno, const char *buf, int total_len);
  293. extern int opal_put_chars_atomic(uint32_t vtermno, const char *buf, int total_len);
  294. extern int opal_flush_chars(uint32_t vtermno, bool wait);
  295. extern int opal_flush_console(uint32_t vtermno);
  296. extern void hvc_opal_init_early(void);
  297. extern int opal_message_notifier_register(enum opal_msg_type msg_type,
  298. struct notifier_block *nb);
  299. extern int opal_message_notifier_unregister(enum opal_msg_type msg_type,
  300. struct notifier_block *nb);
  301. extern int opal_async_get_token_interruptible(void);
  302. extern int opal_async_release_token(int token);
  303. extern int opal_async_wait_response(uint64_t token, struct opal_msg *msg);
  304. extern int opal_async_wait_response_interruptible(uint64_t token,
  305. struct opal_msg *msg);
  306. extern int opal_get_sensor_data(u32 sensor_hndl, u32 *sensor_data);
  307. extern int opal_get_sensor_data_u64(u32 sensor_hndl, u64 *sensor_data);
  308. extern int sensor_group_enable(u32 grp_hndl, bool enable);
  309. struct rtc_time;
  310. extern time64_t opal_get_boot_time(void);
  311. extern void opal_nvram_init(void);
  312. extern void opal_flash_update_init(void);
  313. extern void opal_flash_update_print_message(void);
  314. extern int opal_elog_init(void);
  315. extern void opal_platform_dump_init(void);
  316. extern void opal_sys_param_init(void);
  317. extern void opal_msglog_init(void);
  318. extern void opal_msglog_sysfs_init(void);
  319. extern int opal_async_comp_init(void);
  320. extern int opal_sensor_init(void);
  321. extern int opal_hmi_handler_init(void);
  322. extern int opal_event_init(void);
  323. int opal_power_control_init(void);
  324. extern int opal_machine_check(struct pt_regs *regs);
  325. extern bool opal_mce_check_early_recovery(struct pt_regs *regs);
  326. extern int opal_hmi_exception_early(struct pt_regs *regs);
  327. extern int opal_hmi_exception_early2(struct pt_regs *regs);
  328. extern int opal_handle_hmi_exception(struct pt_regs *regs);
  329. extern void opal_shutdown(void);
  330. extern int opal_resync_timebase(void);
  331. extern void opal_lpc_init(void);
  332. extern void opal_kmsg_init(void);
  333. extern int opal_event_request(unsigned int opal_event_nr);
  334. struct opal_sg_list *opal_vmalloc_to_sg_list(void *vmalloc_addr,
  335. unsigned long vmalloc_size);
  336. void opal_free_sg_list(struct opal_sg_list *sg);
  337. extern int opal_error_code(int rc);
  338. ssize_t opal_msglog_copy(char *to, loff_t pos, size_t count);
  339. static inline int opal_get_async_rc(struct opal_msg msg)
  340. {
  341. if (msg.msg_type != OPAL_MSG_ASYNC_COMP)
  342. return OPAL_PARAMETER;
  343. else
  344. return be64_to_cpu(msg.params[1]);
  345. }
  346. void opal_wake_poller(void);
  347. void opal_powercap_init(void);
  348. void opal_psr_init(void);
  349. void opal_sensor_groups_init(void);
  350. #endif /* __ASSEMBLY__ */
  351. #endif /* _ASM_POWERPC_OPAL_H */