1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
3 * Copyright (C) 2016-2021 Paul Cercueil <paul@crapouillou.net>
18 # ifdef lightrec_EXPORTS
19 # define __api __declspec(dllexport)
20 # elif !defined(LIGHTREC_STATIC)
21 # define __api __declspec(dllimport)
26 # define __api __attribute__((visibility ("default")))
33 # define __cnst __attribute__((const))
40 # define __pure __attribute__((pure))
56 struct lightrec_state;
57 struct lightrec_mem_map;
60 #define LIGHTREC_EXIT_NORMAL (0)
61 #define LIGHTREC_EXIT_CHECK_INTERRUPT (1 << 0)
62 #define LIGHTREC_EXIT_BREAK (1 << 1)
63 #define LIGHTREC_EXIT_SYSCALL (1 << 2)
64 #define LIGHTREC_EXIT_SEGFAULT (1 << 3)
65 #define LIGHTREC_EXIT_NOMEM (1 << 4)
67 /* Unsafe optimizations flags */
68 #define LIGHTREC_OPT_INV_DMA_ONLY (1 << 0)
69 #define LIGHTREC_OPT_SP_GP_HIT_RAM (1 << 1)
72 PSX_MAP_KERNEL_USER_RAM,
75 PSX_MAP_PARALLEL_PORT,
77 PSX_MAP_CACHE_CONTROL,
87 struct lightrec_mem_map_ops {
88 void (*sb)(struct lightrec_state *, u32 opcode,
89 void *host, u32 addr, u8 data);
90 void (*sh)(struct lightrec_state *, u32 opcode,
91 void *host, u32 addr, u16 data);
92 void (*sw)(struct lightrec_state *, u32 opcode,
93 void *host, u32 addr, u32 data);
94 u8 (*lb)(struct lightrec_state *, u32 opcode, void *host, u32 addr);
95 u16 (*lh)(struct lightrec_state *, u32 opcode, void *host, u32 addr);
96 u32 (*lw)(struct lightrec_state *, u32 opcode, void *host, u32 addr);
99 struct lightrec_mem_map {
103 const struct lightrec_mem_map_ops *ops;
104 const struct lightrec_mem_map *mirror_of;
107 struct lightrec_ops {
108 void (*cop2_notify)(struct lightrec_state *state, u32 op, u32 data);
109 void (*cop2_op)(struct lightrec_state *state, u32 op);
110 void (*enable_ram)(struct lightrec_state *state, _Bool enable);
111 _Bool (*hw_direct)(u32 kaddr, _Bool is_write, u8 size);
112 void (*code_inv)(void *addr, u32 len);
115 struct lightrec_registers {
122 __api struct lightrec_state *lightrec_init(char *argv0,
123 const struct lightrec_mem_map *map,
125 const struct lightrec_ops *ops);
127 __api void lightrec_destroy(struct lightrec_state *state);
129 __api u32 lightrec_execute(struct lightrec_state *state,
130 u32 pc, u32 target_cycle);
131 __api u32 lightrec_run_interpreter(struct lightrec_state *state,
132 u32 pc, u32 target_cycle);
134 __api void lightrec_invalidate(struct lightrec_state *state, u32 addr, u32 len);
135 __api void lightrec_invalidate_all(struct lightrec_state *state);
137 __api void lightrec_set_exit_flags(struct lightrec_state *state, u32 flags);
138 __api u32 lightrec_exit_flags(struct lightrec_state *state);
140 __api void lightrec_set_unsafe_opt_flags(struct lightrec_state *state, u32 flags);
142 __api __cnst struct lightrec_registers *
143 lightrec_get_registers(struct lightrec_state *state);
145 __api u32 lightrec_current_cycle_count(const struct lightrec_state *state);
146 __api void lightrec_reset_cycle_count(struct lightrec_state *state, u32 cycles);
147 __api void lightrec_set_target_cycle_count(struct lightrec_state *state,
149 __api void lightrec_set_cycles_per_opcode(struct lightrec_state *state, u32 cycles);
155 #endif /* __LIGHTREC_H__ */