//--------------------------------------------------------------------------
// ExtendedRead_Page:
//
// Read a extended page from the current Eprom Touch Memory.
// The record will be placed into a (uchar) memory location
// starting at the location pointed to by (buf). This function will
// read a page out of normal memory. If the page being read is
// redirected then an error is returned
// The following return codes will be provided to the caller:
//
// portnum the port number of the port being used for the
// 1-Wire Network.
// SNum the serial number for the part that the read is
// to be done on.
// buff the buffer for the data that was read
// pg the page that starts the read
//
// return TRUE if the read was successful.
//
SMALLINT ExtendedRead_Page(int portnum, uchar *SNum, uchar *buff, PAGE_TYPE pg)
{
SMALLINT bank;
PAGE_TYPE page;
uchar extra[20];
int len,i;
bank = getBank(portnum,SNum,pg,REGMEM);
page = getPage(portnum,SNum,pg,REGMEM);
if(!owIsWriteOnce(bank,portnum,SNum) && ((SNum[0] != 0x18) &&
(SNum[0] != 0x33) && (SNum[0] != 0xB3)) )
{
OWERROR(OWERROR_NOT_WRITE_ONCE);
return FALSE;
}
// check on the program job to see if this page is in it
if(isJob(portnum,SNum))
{
if(getJobData(portnum,SNum,pg,&buff[1],&len))
{
return TRUE;
}
}
if(owIsWriteOnce(bank,portnum,SNum))
{
if(!owReadPageExtraCRC(bank,portnum,SNum,page,&buff[0],&extra[0]))
return FALSE;
}
else
{
if(!owReadPageExtra(bank,portnum,SNum,page,FALSE,&buff[0],&extra[0]))
return FALSE;
for(i=0;i<owGetExtraInfoLength(bank,SNum);i++)
buff[i+32] = extra[i];
extra[0] = 0xFF;
}
if(extra[0] != 0xFF)
{
OWERROR(OWERROR_REDIRECTED_PAGE);
return FALSE;
}
return TRUE;
}
/**
* Display the information about the current memory back provided.
*
* portnum port number for the device
* SNum serial number for the device
*/
void displayBankInformation (SMALLINT bank, int portnum, uchar SNum[8])
{
printf("\n");
printf("|------------------------------------------------------------------------\n");
printf("| Bank: %s\n",owGetBankDescription(bank,SNum));
printf("| Size: %d starting at physical address %d\n",owGetSize(bank,SNum),
owGetStartingAddress(bank,SNum));
printf("| Features: ");
if(owIsReadWrite(bank,portnum,SNum))
printf("Read/Write ");
if(owIsWriteOnce(bank,portnum,SNum))
printf("Write-once ");
if(owIsReadOnly(bank,portnum,SNum))
printf("Read-only ");
if(owIsGeneralPurposeMemory(bank,SNum))
printf("general-purpose ");
else
printf("not-general-purpose ");
if(owIsNonVolatile(bank,SNum))
printf("non-volatile\n");
else
printf("volatile\n");
if(owNeedsProgramPulse(bank,SNum))
printf("|\tneeds-program-pulse \n");
if(owNeedsPowerDelivery(bank,SNum))
printf("|\tneeds-power-delivery \n");
printf("| Pages: %d pages of length %d bytes ",
owGetNumberPages(bank,SNum),owGetPageLength(bank,SNum));
if(owIsGeneralPurposeMemory(bank,SNum))
printf("giving %d bytes Packet data payload",owGetMaxPacketDataLength(bank,SNum));
printf("\n| Page Features: ");
if(owHasPageAutoCRC(bank,SNum))
printf("page-device-CRC ");
if(owCanRedirectPage(bank,SNum))
printf("pages-redirectable ");
if(owCanLockPage(bank,SNum))
printf("pages-lockable \n");
if((owCanLockPage(bank,SNum)) && (owCanLockRedirectPage(bank,SNum)))
printf("|\tredirection-lockable\n");
else if(owCanLockRedirectPage(bank,SNum))
printf("redirection-lockable.");
if(!owCanLockPage(bank,SNum))
printf("\n");
if(owHasExtraInfo(bank,SNum))
printf("| Extra information for each page: %s length %d\n",
owGetExtraInfoDesc(bank,SNum),
owGetExtraInfoLength(bank,SNum));
printf("|------------------------------------------------------------------------\n\n");
}
//--------------------------------------------------------------------------
// Read_Page:
//
// Read a default data structure page from the current Touch Memory.
// The record will be placed shorto a (uchar) memory location
// starting at the location poshorted to by (buf). This function will
// read a page out of normal memory (flag = REGMEM) or a status memory
// page out of an eprom (flag = STATUSMEM). If the page being read is
// redirected as in an eprom device then the page value passes by referece
// is changed to match the new page.
//
// portnum the port number of the port being used for the
// 1-Wire Network.
// SNum the serial number for the part that the read is
// to be done on.
// flag tells weather to read regular memory or status memory
// buff location for data read
// page page number to read packet from
// len the length of the data read
//
// return TRUE if the data was read correctly
//
SMALLINT Read_Page(int portnum, uchar *SNum, uchar *buff, uchar flag,
PAGE_TYPE *pg, int *len)
{
SMALLINT bank;
PAGE_TYPE page;
int jobopen = FALSE;
int cnt = 0;
uchar extra[3],space;
uchar temp_buff[32];
uchar rd_buf[2];
uchar addpg;
int i;
// Are program jobs possible
// is there a job that has been opened and is this a regular memory read
if(isJob(portnum,SNum))
jobopen = TRUE;
// loop while redirected
for (cnt = 0; cnt <= 256; cnt++)
{
// if an program job is open then check there for page
if(jobopen && (flag != STATUSMEM))
{
if(getJobData(portnum,SNum,*pg,buff,len))
{
return TRUE;
}
}
// nope so look for page in cache
if(FindPage(portnum,SNum,pg,flag,TRUE,buff,len,&space))
{
if(*len == 0x41)
{
*pg = buff[0];
}
else if(flag != STATUSMEM)
{
return TRUE;
}
}
bank = getBank(portnum,SNum,*pg,flag);
page = getPage(portnum,SNum,*pg,flag);
// nope so get it from the part
// if the page is in the status memory then call read status
if (flag == STATUSMEM)
{
if(owIsWriteOnce(bank,portnum,SNum) && owHasExtraInfo(bank,SNum))
{
if(!owReadPageExtraCRC(bank,portnum,SNum,page,&temp_buff[0],&extra[0]))
{
if(extra[0] == 0xFF)
return FALSE;
}
}
else
{
if(owHasPageAutoCRC(bank,SNum))
{
if(!owReadPageCRC(bank,portnum,SNum,page,&temp_buff[0]))
return FALSE;
}
else
{
if(!owReadPage(bank,portnum,SNum,page,FALSE,&temp_buff[0]))
return FALSE;
}
extra[0] = 0xFF;
}
if(extra[0] != 0xFF)
{
rd_buf[0] = ~extra[0];
addpg = AddPage(portnum,SNum,*pg,&rd_buf[0],STATUSMEM);
*pg = (PAGE_TYPE) rd_buf[0];
continue;
}
else
{
*len = 8;
for(i=0;i<*len;i++)
buff[i] = temp_buff[i];
addpg = AddPage(portnum,SNum,*pg,&buff[0],STATUSMEM);
// AddPage(portnum,SNum,*pg,&buff[0],*len);
// AddPage(portnum,SNum,*pg,&buff[0],0x41);
return TRUE;
}
}
// else call on the regular readpack function
else
{
*len = 0;
if(owIsWriteOnce(bank,portnum,SNum) && owHasExtraInfo(bank,SNum))
{
if(!owReadPagePacketExtra(bank,portnum,SNum,page,FALSE,
&temp_buff[0],len,&extra[0]))
{
if(extra[0] == 0xFF)
return FALSE;
}
}
else
{
if(owHasPageAutoCRC(bank,SNum))
{
if(!owReadPageCRC(bank,portnum,SNum,page,&temp_buff[0]))
return FALSE;
}
else
{
if(!owReadPage(bank,portnum,SNum,page,FALSE,&temp_buff[0]))
return FALSE;
}
extra[0] = 0xFF;
}
if(extra[0] != 0xFF)
{
rd_buf[0] = ~extra[0];
addpg = AddPage(portnum,SNum,*pg,&rd_buf[0],REDIRMEM);
*pg = (PAGE_TYPE) rd_buf[0];
continue;
}
else
{
if(*len > 0)
{
if(*len > 32)
{
OWERROR(OWERROR_INVALID_PACKET_LENGTH);
return FALSE;
}
for(i=0;i<(*len);i++)
buff[i] = temp_buff[i];
}
else
{
if(temp_buff[0] > 32)
{
OWERROR(OWERROR_INVALID_PACKET_LENGTH);
return FALSE;
}
for(i=1;i<(temp_buff[0]+1);i++)
buff[i-1] = temp_buff[i];
*len = temp_buff[0];
}
addpg = AddPage(portnum,SNum,*pg,&buff[0],*len);
return TRUE;
}
}
}
// could not find the page
return FALSE;
}
