cell_spu.c File Reference

Include dependency graph for cell_spu.c:

Go to the source code of this file.

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.
static void *	cell_thread_function (void *arg)
	Called by pthread_create() to spawn an SPU thread.
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.

---

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 */
   }
}

static void* cell_thread_function

(

void *

arg

)

[static]

Called by pthread_create() to spawn an SPU thread.

Definition at line 89 of file cell_spu.c.

References ASSERT_ALIGN16, cell_global, cell_init_info::id, and cell_global_info::spe_contexts.

{
   struct cell_init_info *init = (struct cell_init_info *) arg;
   unsigned entry = SPE_DEFAULT_ENTRY;

   ASSERT_ALIGN16(init);

   if (spe_context_run(cell_global.spe_contexts[init->id], &entry, 0,
                       init, NULL, NULL) < 0) {
      fprintf(stderr, "spe_context_run() failed\n");
      exit(1);
   }

   pthread_exit(NULL);
}

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.

---