Platform Objects

Introduction

The Platform module provides a common interface to platform-specific functionality, such as memory allocation, resource locking, interrupts, signalling, and others.

The Platform object provides low-level platform-specific functionality and depends upon the combination of the operating system and the C compiler used for development. The Platform module was written to provide platform-independent access functions for use by the MPI. Unless your application needs to be written for compatibility with different platforms, MEI encourages the use of OS-specific functions. If an MEIPlatform object handle is required, one should obtain this handle from the MPIControl method meiControlPlatform.

WARNING!
Do NOT attempt to use the (intentionally undocumented) method, meiPlatformCreate(). Using this method will interfere with the inner workings of the MPI.

The meiObjectGive/Take(...) methods all use the meiPlatformLockGive/Take(...) methods. When you take a lock, you take exclusive access to the resource (i.e., the section of XMP firmware memory associated with that Object). When you give a lock, you release (give up) that exclusive access. Think of it as TakeAccessOf and GiveUpAccess.

Methods

	meiPlatformAlloc	Allocate system memory.
	meiPlatformAssertSet	Set an assertion handling function to be used by the MPI library.
	meiPlatformAtof	Convert a numeric string to a double.
	meiPlatformAtol	Convert a numeric string to a long.
	meiPlatformExmpTempGet
	meiPlatformExmpTempInit
	meiPlatformFileClose	Close a file handle.
	meiPlatformFileOpen	Open a file handle.
	meiPlatformFileRead	Read data from a file handle created by meiPlatformFileOpen.
	meiPlatformFileWrite	Writes data to a file whose handle was created by meiPlatformFileOpen.
	meiPlatformFirmwareAddress16To32
	meiPlatformFirmwareAddress32To16
	meiPlatformFirmwareAddress32To64
	meiPlatformFirmwareAddress64To32
	meiPlatformFree	Free system memory.
	meiPlatformHostAddress32To64
	meiPlatformHostAddress64To32
	meiPlatformKey	Return an input character if an input character is available.
	meiPlatformMemoryGet64
	meiPlatformMemorySet64
	meiPlatformMemoryToFirmware	Convert a host memory address to a controller memory address.
	meiPlatformMemoryToHost	Covert a controller memory address to a host memory address.
	meiPlatformSleep	Put the current thread to sleep for the number of milliseconds specified.
	meiPlatformProcessId	Return the process identification number of the current process.
	meiPlatformTimerCount	Write to ticks the current timer count.
	meiPlatformTimerFrequency	Write to frequency the timer frequency of the current platform.
	meiPlatformTrace	Display printf(...)-style trace information
	meiPlatformTraceEol	Set the end-of-line (eol) to be used by meiPlatformTrace(...).
	meiPlatformTraceFile	Redirect trace output.
	meiPlatformTraceFunction	Display the trace output.
	meiPlatformWord64Orient

Data Types

	MEIPlatformBoardType
	MEIPlatformFileMode
	MEIPlatformInfo
	MEIPlatformMessage

Constants

	MEIPlatformControlCountMax
	MEIPlatformInfoCHAR_MAX