cell_spu.h File Reference

Include dependency graph for cell_spu.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	cell_global_info
	Global vars, for now anyway. More...
Defines
#define	MAX_SPUS   8
Functions
void	send_mbox_message (spe_context_ptr_t ctx, unsigned int msg)
	Write a 1-word message to the given SPE mailbox.
uint	wait_mbox_message (spe_context_ptr_t ctx)
	Wait for a 1-word message to arrive in given mailbox.
void	cell_start_spus (struct cell_context *cell)
	Create the SPU threads.
void	cell_spu_exit (struct cell_context *cell)
	Tell all the SPUs to stop/exit.
Variables
struct cell_global_info	cell_global
	Utility/wrappers for communicating with the SPUs.
spe_program_handle_t	g3d_spu
	This is the handle for the actual SPE code.

---

Define Documentation

#define MAX_SPUS   8

Definition at line 39 of file cell_spu.h.

---

Function Documentation

void cell_spu_exit

(

struct cell_context *

cell

)

Tell all the SPUs to stop/exit.

This is done when the driver's exiting / cleaning up.

Definition at line 168 of file cell_spu.c.

References CELL_CMD_EXIT, cell_global, cell_context::num_spus, send_mbox_message(), cell_global_info::spe_contexts, and cell_global_info::spe_threads.

{
   uint i;

   for (i = 0; i < cell->num_spus; i++) {
      send_mbox_message(cell_global.spe_contexts[i], CELL_CMD_EXIT);
   }

   /* wait for threads to exit */
   for (i = 0; i < cell->num_spus; i++) {
      void *value;
      pthread_join(cell_global.spe_threads[i], &value);
      cell_global.spe_threads[i] = 0;
      cell_global.spe_contexts[i] = 0;
   }
}

void cell_start_spus

(

struct cell_context *

cell

)

Create the SPU threads.

This is done once during driver initialization. This involves setting the the "init" message which is sent to each SPU. The init message specifies an SPU id, total number of SPUs, location and number of batch buffers, etc.

Definition at line 113 of file cell_spu.c.

References assert, ASSERT_ALIGN16, cell_init_info::buffer_status, cell_init_info::buffers, cell_global, CELL_NUM_BUFFERS, cell_thread_function(), cell_init_info::cmd, cell_global_info::command, cell_context::debug_flags, cell_init_info::debug_flags, FALSE, g3d_spu, cell_init_info::id, cell_global_info::inits, MAX_SPUS, cell_init_info::num_spus, cell_context::num_spus, one_time_init(), cell_global_info::spe_contexts, cell_global_info::spe_threads, and TRUE.

{
   static boolean one_time_init = FALSE;
   uint i, j;

   if (one_time_init) {
      fprintf(stderr, "PPU: Multiple rendering contexts not yet supported "
              "on Cell.\n");
      abort();
   }

   one_time_init = TRUE;

   assert(cell->num_spus <= MAX_SPUS);

   ASSERT_ALIGN16(&cell_global.command[0]);
   ASSERT_ALIGN16(&cell_global.command[1]);

   ASSERT_ALIGN16(&cell_global.inits[0]);
   ASSERT_ALIGN16(&cell_global.inits[1]);

   for (i = 0; i < cell->num_spus; i++) {
      cell_global.inits[i].id = i;
      cell_global.inits[i].num_spus = cell->num_spus;
      cell_global.inits[i].debug_flags = cell->debug_flags;
      cell_global.inits[i].cmd = &cell_global.command[i];
      for (j = 0; j < CELL_NUM_BUFFERS; j++) {
         cell_global.inits[i].buffers[j] = cell->buffer[j];
      }
      cell_global.inits[i].buffer_status = &cell->buffer_status[0][0][0];

      cell_global.spe_contexts[i] = spe_context_create(0, NULL);
      if (!cell_global.spe_contexts[i]) {
         fprintf(stderr, "spe_context_create() failed\n");
         exit(1);
      }

      if (spe_program_load(cell_global.spe_contexts[i], &g3d_spu)) {
         fprintf(stderr, "spe_program_load() failed\n");
         exit(1);
      }
      
      pthread_create(&cell_global.spe_threads[i], /* returned thread handle */
                     NULL,                        /* pthread attribs */
                     &cell_thread_function,       /* start routine */
                     &cell_global.inits[i]);      /* thread argument */
   }
}

void send_mbox_message	(	spe_context_ptr_t	ctx,
		unsigned int	msg
	)

Write a 1-word message to the given SPE mailbox.

Definition at line 58 of file cell_spu.c.

{
   spe_in_mbox_write(ctx, &msg, 1, SPE_MBOX_ALL_BLOCKING);
}

uint wait_mbox_message

(

spe_context_ptr_t

ctx

)

Wait for a 1-word message to arrive in given mailbox.

Definition at line 68 of file cell_spu.c.

{
   do {
      unsigned data;
      int count = spe_out_mbox_read(ctx, &data, 1);

      if (count == 1) {
         return data;
      }
      
      if (count < 0) {
         /* error */ ;
      }
   } while (1);
}

---

Variable Documentation

struct cell_global_info cell_global

Utility/wrappers for communicating with the SPUs.

Cell/SPU info that's not per-context.

Definition at line 51 of file cell_spu.c.

spe_program_handle_t g3d_spu

This is the handle for the actual SPE code.

---