uhPartnerCmd, uhGLoad
Passes commands to PARTNER
#include <ultrahost.h> /* ultrahost.h */
int uhPartnerCmd(int fd,char * cmd);
int uhGLoad(int fd,char * gamename);
These routines set up and use communication channels for data transfer between PARTNER and 64 on the host application. The device handler that is passed to the commands, fd, is obtained from uhOpenGame. For more information, please see uhOpenGame. .
uhPartnerCmd issues the various commands that PARTNER can use. For more information, see the PARTNER manual.
uhGLoad uses PARTNER to load and execute the 64 game specified by gamename.
uhPartnerCmd
When successful, returns the length of the command sent to PARTNER.
With failure, returns an error code with a negative value.
uhGLoad
Returns 0 when successful and -1 when it fails.
Following is an example of the uh functions used for Partner.
This example is a host application that responds to instructions from the game once it is loaded. In this example, instructions from the game are received and passed after being stored in the structure TCommandPacket. PARTNER must be started before the application is executed.
#include <ultrahost.h>
#define DEV_U64_DATA "PARTNER-N64"
typedef TCommandPacket int;
TCommandPacket cmdpkt;
extern s32 errStop(char *);
main(int argc, char **argv) /* Host side code */
{
int cmd,done;
/* Open the device */
if ((fd = uhOpenGame(DEV_U64_DATA)) < 0)
errStop("device open error");
/* Load the game */
if( uhGLoad(fd ,0) != 0 ) errStop("gload failed");
while (!done)
{
cmd = catchCommand(); // Receive a command from the 64 game.
switch(cmd) // Process according to the command
{
case CMD_A:
....
case CMD_B:
...
}
}
uhCloseGame(fd);
}
int
catchCommand(void) // Receive 64 data. Take care to avoid using the wrong endian format
{
TCommandPacket cmdpkt;
if ( uhReadGame(fd, (void *)&cmdpkt, sizeof(TCommandPacket)) < 0)
errStop("fail uhReadGame");
#ifdef __PARTNER_PC__
rev((unsigned *)&cmdpkt); // Reverse the endian format for PC
#endif
return (int)cmdpkt;
}
1999/04/30 Changed format