Maxim Integrated High-Speed Microcontroller Users Guide: Network Microcontroller Supplement User Manual

Page 219

Advertising
background image

infosendchar

The

infosendchar function sends a character to the serial port 0. The DS80C400 silicon software version of this function accesses the

serial loader pin (P1.7) and does nothing if this pin is in the logic-low state. The DS80C400 silicon software does not use interrupt-dri-

ven I/O to the serial port.

IPchecksum

The

IPchecksum function calculates the IP checksum for an IP packet. The DS80C400 silicon software version of this function does

not use the checksum accelerator feature of the DS80C400.

getMACID

The

getMACID function reads the MAC ID and stores it in the MAC_ID variable (a MAC_ID pointer is given in the ROM export table). The

DS80C400 silicon software version of this function accesses the 1-Wire port and searches for a DS2502-E48 1-Wire chip containing the MAC

ID.

underef

Resolves a physical address into a memory handle. This function undereferences an absolute address and returns a memory handle.

userIOpoll

Allows extension of the WOS_IOPoll mechanism. This function is called on every WOS_IOPoll, i.e., driven by the timer when no inter-

rupts are active. A user could add housekeeping functions, for example. The default implementation of this function does nothing.

errornotification

Provides a means for notification when an error occurs. This function is called when the system error occurs, e.g., not having enough

memory. The list of error causes/reasons currently defined within the ROM is given below. The default implementation of this function

does nothing; however, a user implementation might print an error message or reset the system.

Error Cause

Value

Description

ERROR_KMEM

0

Kernel memory exhausted

ERROR_MRM

1

Heap memory exhausted

ERROR_TCP_MEM

2

TCP detected low memory

ERROR_TCP_RESEND

3

TCP packet has to be resent

ERROR_KFREE_FAIL

4

Attempt to free a kernel memory block failed

ERROR_FREE_NULL

5

Attempt to free a NULL pointer

ERROR_FREE_DEREF

6

Could not dereference a memory handle on free

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

ACC

Value for a given error cause

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

DPTR0

pointer to memory block

ACC

R3:R2

(destroyed)

blockhandle

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

ACC

Success (= 00h) or failure code

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

DPTR0

R5:R4

Pointer to data buffer

Size of data buffer

R1:R0

Checksum

INPUT

DESCRIPTION

OUTPUT

DESCRIPTION

ACC

Character to send

High-Speed Microcontroller User’s

Guide: Network Microcontroller

Supplement

219

Maxim Integrated

Advertising