transaction.c File Reference

#include <stdlib.h>
#include "dbg_msg.h"
#include "arm_gdbstub_callback.h"
#include "transaction.h"

Data Structures

struct transactionMemPool

Defines

#define BUCKET_SIZE 32

Functions

static struct transaction * allocFromMemPool (size_t param_size)
static void moveToMemPool (struct transaction *tr)
static void activateMemCleanUp (void)
static int memCleanUpCB (int unusedArg, int unusedCnt, struct context *noContext)
struct transaction * transactionCreate (struct transaction *uplevel, void(*cbFnct)(struct transaction *context), size_t param_size)
void transactionActivate (struct transaction *newElement)
void transactionActivateFinal (struct transaction *newElement)
struct transaction * transactionGet (void)
void transactionExecute (void)
int transactionPenting (void)
void transactionErase (struct transaction *self)

Variables

static struct transactionHead transactionHead = {NULL, NULL}
static struct transaction * transactionCurrent = NULL
static struct transactionMemPool memPool

Detailed Description

The first part of a transaction can be done imediatly after activation (e.g. filling up an USB transmit buffer).
The second part of a transaction can be done later inside of execution part (e.g. sending all USB all data once and collecting the response in correct order).

 #1-------#2------X     ~1      ~2
 |        |       |     ^       ^
 #11-#12  #21-#22 | ~11 ~12 ~21 ~22
 |   |    |   |   | ^   ^   ^   ^
 +11 +12  +21 +22 O-*11-*12-*21-*22

 fnct_0
   for (i=0;i<2;i++)
   {
     tr = transactionCreate(NULL,fnct_0_cb,0);
     transactionActivate(tr);
     fnct_1();
   }
   transactionExecute()

 fnct_0_cb
   ..
   transactionErase(context);

 fnct_1
   uplevel = transactionGet();
   tr = transactionCreate(NULL,fnct_1a_cb,0);
   transactionActivate(tr);
   fnct_low();
   tr = transactionCreate(uplevel,fnct_1b_cb,0);
   transactionActivate(tr);
   fnct_low();

 fnct_1a_cb
   ..
   transactionErase(context);

 fnct_1b_cb
   ..
   transactionErase(context);

 fnct_low
   uplevel = transactionGet();
   tr = transactionCreate(uplevel,fnct_low_cb,0);
   transactionActivateFinal(tr);

 fnct_low_cb
   ..
   transactionErase(context);

Define Documentation

#define BUCKET_SIZE 32

Referenced by allocFromMemPool(), memCleanUpCB(), and moveToMemPool().

Function Documentation

static struct transaction * allocFromMemPool ( size_t param_size ) [static, read]

References transactionMemPool::bucket, BUCKET_SIZE, transactionHead::first, transactionHead::last, transactionMemPool::lastIdx, memPool, transaction::next, and transactionMemPool::sizeOfIdx.

Referenced by transactionCreate().

static void moveToMemPool ( struct transaction * tr ) [static]

References transactionMemPool::bucket, BUCKET_SIZE, transactionHead::first, transactionHead::last, transactionMemPool::lastIdx, memPool, transaction::next, transaction::size, and transactionMemPool::sizeOfIdx.

Referenced by transactionActivateFinal(), and transactionErase().

static void activateMemCleanUp ( void ) [static]

References allocateCmdCallbackEntry(), transactionMemPool::cleanUpCnt, transactionMemPool::cleanUpPending, inQueueCmdCallbackEntry(), memCleanUpCB(), and memPool.

Referenced by transactionErase().

static int memCleanUpCB	(	int	unusedArg,
		int	unusedCnt,
		struct context *	noContext
	)			`[static]`

References allocateCmdCallbackEntry(), transactionMemPool::bucket, BUCKET_SIZE, transactionMemPool::cleanUpCnt, transactionMemPool::cleanUpPending, DBG_LEVEL_GDB_ARM_ERROR, dbgPrintf(), transactionHead::first, inQueueCmdCallbackEntry(), transactionHead::last, transactionMemPool::lastIdx, memPool, and transaction::next.

Referenced by activateMemCleanUp().

struct transaction* transactionCreate	(	struct transaction *	uplevel,
		void()(struct transaction context)	cbFnct,
		size_t	param_size
	)			`[read]`

create a new transaction element

Parameters:

	uplevel	pointer to upper level of the transaction (caller)
	cbFnct	callback function at execution point
	param_size	size of extra data buffer containing callback parameter and/or return data