2 * spu_csa.h: Definitions for SPU context save area (CSA).
4 * (C) Copyright IBM 2005
6 * Author: Mark Nutter <mnutter@us.ibm.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2, or (at your option)
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 * Total number of 128-bit registers.
30 #define NR_SPU_GPRS 128
32 #define NR_SPU_REGS_PAD 7
33 #define NR_SPU_SPILL_REGS 144 /* GPRS + SPRS + PAD */
34 #define SIZEOF_SPU_SPILL_REGS NR_SPU_SPILL_REGS * 16
36 #define SPU_SAVE_COMPLETE 0x3FFB
37 #define SPU_RESTORE_COMPLETE 0x3FFC
40 * Definitions for various 'stopped' status conditions,
41 * to be recreated during context restore.
43 #define SPU_STOPPED_STATUS_P 1
44 #define SPU_STOPPED_STATUS_I 2
45 #define SPU_STOPPED_STATUS_H 3
46 #define SPU_STOPPED_STATUS_S 4
47 #define SPU_STOPPED_STATUS_S_I 5
48 #define SPU_STOPPED_STATUS_S_P 6
49 #define SPU_STOPPED_STATUS_P_H 7
50 #define SPU_STOPPED_STATUS_P_I 8
51 #define SPU_STOPPED_STATUS_R 9
55 * spu_reg128 - generic 128-bit register definition.
62 * struct spu_lscsa - Local Store Context Save Area.
63 * @gprs: Array of saved registers.
64 * @fpcr: Saved floating point status control register.
65 * @decr: Saved decrementer value.
66 * @decr_status: Indicates decrementer run status.
67 * @ppu_mb: Saved PPU mailbox data.
68 * @ppuint_mb: Saved PPU interrupting mailbox data.
69 * @tag_mask: Saved tag group mask.
70 * @event_mask: Saved event mask.
72 * @stopped_status: Conditions to be recreated by restore.
73 * @ls: Saved contents of Local Storage Area.
75 * The LSCSA represents state that is primarily saved and
76 * restored by SPU-side code.
79 struct spu_reg128 gprs[128];
80 struct spu_reg128 fpcr;
81 struct spu_reg128 decr;
82 struct spu_reg128 decr_status;
83 struct spu_reg128 ppu_mb;
84 struct spu_reg128 ppuint_mb;
85 struct spu_reg128 tag_mask;
86 struct spu_reg128 event_mask;
87 struct spu_reg128 srr0;
88 struct spu_reg128 stopped_status;
91 * 'ls' must be page-aligned on all configurations.
92 * Since we don't want to rely on having the spu-gcc
93 * installed to build the kernel and this structure
94 * is used in the SPU-side code, make it 64k-page
97 unsigned char ls[LS_SIZE] __attribute__((aligned(65536)));
102 * struct spu_problem_collapsed - condensed problem state area, w/o pads.
104 struct spu_problem_collapsed {
109 union mfc_tag_size_class_cmd mfc_union_W;
111 u32 dma_querytype_RW;
112 u32 dma_querymask_RW;
127 * struct spu_priv1_collapsed - condensed privileged 1 area, w/o pads.
129 struct spu_priv1_collapsed {
135 u64 int_mask_class0_RW;
136 u64 int_mask_class1_RW;
137 u64 int_mask_class2_RW;
138 u64 int_stat_class0_RW;
139 u64 int_stat_class1_RW;
140 u64 int_stat_class2_RW;
142 u64 mfc_atomic_flush_RW;
143 u64 resource_allocation_groupID_RW;
144 u64 resource_allocation_enable_RW;
146 u64 mfc_fir_status_or_W;
147 u64 mfc_fir_status_and_W;
149 u64 mfc_fir_mask_or_W;
150 u64 mfc_fir_mask_and_W;
151 u64 mfc_fir_chkstp_enable_RW;
152 u64 smf_sbi_signal_sel;
153 u64 smf_ato_signal_sel;
155 u64 tlb_index_hint_RO;
159 u64 tlb_invalidate_entry_W;
160 u64 tlb_invalidate_all_W;
170 u64 mfc_tclass_id_RW;
172 u64 smf_dma_signal_sel;
192 * struct spu_priv2_collapsed - condensed priviliged 2 area, w/o pads.
194 struct spu_priv2_collapsed {
198 u64 slb_invalidate_entry_W;
199 u64 slb_invalidate_all_W;
200 struct mfc_cq_sr spuq[16];
201 struct mfc_cq_sr puq[8];
206 u64 spu_chnlcntptr_RW;
210 u64 spu_tag_status_query_RW;
213 u64 spu_atomic_status_RW;
218 * @lscsa: Local Store Context Save Area.
219 * @prob: Collapsed Problem State Area, w/o pads.
220 * @priv1: Collapsed Privileged 1 Area, w/o pads.
221 * @priv2: Collapsed Privileged 2 Area, w/o pads.
222 * @spu_chnlcnt_RW: Array of saved channel counts.
223 * @spu_chnldata_RW: Array of saved channel data.
224 * @suspend_time: Time stamp when decrementer disabled.
225 * @slb_esid_RW: Array of saved SLB esid entries.
226 * @slb_vsid_RW: Array of saved SLB vsid entries.
228 * Structure representing the whole of the SPU
229 * context save area (CSA). This struct contains
230 * all of the state necessary to suspend and then
231 * later optionally resume execution of an SPU
234 * The @lscsa region is by far the largest, and is
235 * allocated separately so that it may either be
236 * pinned or mapped to/from application memory, as
237 * appropriate for the OS environment.
240 struct spu_lscsa *lscsa;
241 struct spu_problem_collapsed prob;
242 struct spu_priv1_collapsed priv1;
243 struct spu_priv2_collapsed priv2;
244 u64 spu_chnlcnt_RW[32];
245 u64 spu_chnldata_RW[32];
246 u32 spu_mailbox_data[4];
247 u32 pu_mailbox_data[1];
248 unsigned long suspend_time;
251 spinlock_t register_lock;
254 extern void spu_init_csa(struct spu_state *csa);
255 extern void spu_fini_csa(struct spu_state *csa);
256 extern int spu_save(struct spu_state *prev, struct spu *spu);
257 extern int spu_restore(struct spu_state *new, struct spu *spu);
258 extern int spu_switch(struct spu_state *prev, struct spu_state *new,
261 #endif /* !__SPU__ */
262 #endif /* __KERNEL__ */
263 #endif /* !__ASSEMBLY__ */
264 #endif /* _SPU_CSA_H_ */