DHCPc_Start()

Starts the DHCP address configuration and management on the specified interface.

Files

dhcp-c.h/dhcp-c.c

Prototype

          void  DHCPc_Start (NET_IF_NBR       if_nbr,
                             DHCPc_OPT_CODE  *preq_param_tbl,
                             CPU_INT08U       req_param_tbl_qty,
                             DHCPc_ERR       *perr);

Arguments

if_nbr

Interface number to start DHCP configuration and management.

preq_param_tbl

Pointer to table of requested DHCP parameters.

req_param_tbl_qty

Pointer to buffer that will receive the option value.

perr

Pointer to variable that will receive the return error code from this function:

DHCPc_ERR_NONE DHCPc_ERR_INIT_INCOMPLETE DHCPc_ERR_IF_INVALID DHCPc_ERR_PARAM_REQ_TBL_SIZE DHCPc_ERR_MSG_Q DHCPc_OS_ERR_LOCK DHCPc_ERR_IF_INFO_IF_USED DHCPc_ERR_INVALID_HW_ADDR DHCPc_ERR_IF_INFO_NONE_AVAIL DHCPc_ERR_COMM_NONE_AVAIL

Returned Values

None.

Required Configuration

None.

Notes / Warnings

None.

Example Usage

          DHCPc_OPT_CODE  req_param[DHCPc_CFG_PARAM_REQ_TBL_SIZE];
          CPU_INT08U      req_param_qty;
          DHCPc_ERR       err;
           
          req_param[0]  = (DHCPc_OPT_CODE)DHCP_OPT_DOMAIN_NAME_SERVER;
          req_param_qty =  1;
           
          DHCPc_Start((NET_IF_NBR      ) NET_IF_NBR_BASE_CFGD,
                      (DHCPc_OPT_CODE *)&req_param[0],
                      (CPU_INT08U      ) req_param_qty,
                      (DHCPc_ERR      *)&err);
          if (err == DHCPc_ERR_NONE) {
              printf("Interface DHCP management     successfully started\n\r");
          } else { 
              printf("Interface DHCP management NOT successfully started\n\r");
          }