IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

Socket descriptor
Return Value
DX = 0 success AX: 0
DX = -1 = API_ERROR AX: contains error code
Related Topics
Top of list
Index page
Open socket API_OPENSOCKET
Interrupt 0xAC service 0x03: API_BIND, bind TCP or UDP server socket
Parameters
AH
BX
DX:SI
Bind a unnamed socket with an IP address and port number.
0x03 (= API_BIND)
Socket descriptor
Pointer to a sockaddr_in structure, the first three elements of which must be filled in by caller prior to
calling.
Return Value
Comments
DX = 0 success AX: 0
DX != 0 AX: contains error code
The bind call sets a specific port number as an application's source port number. Otherwise a random 16-bit
source port number will be used when no bind call is made.
The bind call is necessary for server applications in order that clients can connect to them at the agreed upon
("well known") port number.
The older TCP and UDP echo client examples also used a bind call, but this was not necessary. If you use
the bind call in a client application, the client uses the given port number as its own source port number.
Related Topics
Top of list
Index page
Get IP address of the Ethernet interface
Convert ASCII IP address to binary
For proper port number byte order: htons function
Page 107 / 400