mirror of
https://github.com/cesanta/mongoose.git
synced 2024-12-24 16:50:14 +08:00
122 lines
5.2 KiB
C
122 lines
5.2 KiB
C
/*
|
|
* FreeRTOS+TCP V2.3.2
|
|
* Copyright (C) 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
* this software and associated documentation files (the "Software"), to deal in
|
|
* the Software without restriction, including without limitation the rights to
|
|
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
|
* the Software, and to permit persons to whom the Software is furnished to do so,
|
|
* subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in all
|
|
* copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
|
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
|
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
* http://aws.amazon.com/freertos
|
|
* http://www.FreeRTOS.org
|
|
*/
|
|
|
|
#ifndef FREERTOS_DHCP_H
|
|
#define FREERTOS_DHCP_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Application level configuration options. */
|
|
#include "FreeRTOSIPConfig.h"
|
|
#include "IPTraceMacroDefaults.h"
|
|
|
|
#if ( ipconfigUSE_DHCP_HOOK != 0 )
|
|
/* Used in the DHCP callback if ipconfigUSE_DHCP_HOOK is set to 1. */
|
|
typedef enum eDHCP_PHASE
|
|
{
|
|
eDHCPPhasePreDiscover, /* Driver is about to send a DHCP discovery. */
|
|
eDHCPPhasePreRequest /* Driver is about to request DHCP an IP address. */
|
|
} eDHCPCallbackPhase_t;
|
|
|
|
/* Used in the DHCP callback if ipconfigUSE_DHCP_HOOK is set to 1. */
|
|
typedef enum eDHCP_ANSWERS
|
|
{
|
|
eDHCPContinue, /* Continue the DHCP process */
|
|
eDHCPUseDefaults, /* Stop DHCP and use the static defaults. */
|
|
eDHCPStopNoChanges, /* Stop DHCP and continue with current settings. */
|
|
} eDHCPCallbackAnswer_t;
|
|
#endif /* #if( ipconfigUSE_DHCP_HOOK != 0 ) */
|
|
|
|
/* DHCP state machine states. */
|
|
typedef enum
|
|
{
|
|
eInitialWait = 0, /**< Initial state: open a socket and wait a short time. */
|
|
eWaitingSendFirstDiscover, /**< Send a discover the first time it is called, and reset all timers. */
|
|
eWaitingOffer, /**< Either resend the discover, or, if the offer is forthcoming, send a request. */
|
|
eWaitingAcknowledge, /**< Either resend the request. */
|
|
eSendDHCPRequest, /**< Sendto failed earlier, resend the request to lease the IP-address offered. */
|
|
#if ( ipconfigDHCP_FALL_BACK_AUTO_IP != 0 )
|
|
eGetLinkLayerAddress, /* When DHCP didn't respond, try to obtain a LinkLayer address 168.254.x.x. */
|
|
#endif
|
|
eLeasedAddress, /**< Resend the request at the appropriate time to renew the lease. */
|
|
eNotUsingLeasedAddress /**< DHCP failed, and a default IP address is being used. */
|
|
} eDHCPState_t;
|
|
|
|
/**
|
|
* Hold information in between steps in the DHCP state machine.
|
|
*/
|
|
struct xDHCP_DATA
|
|
{
|
|
uint32_t ulTransactionId; /**< The ID of the DHCP transaction */
|
|
uint32_t ulOfferedIPAddress; /**< The IP address offered by the DHCP server */
|
|
uint32_t ulDHCPServerAddress; /**< The IP address of the DHCP server */
|
|
uint32_t ulLeaseTime; /**< The time for which the current IP address is leased */
|
|
TickType_t xDHCPTxTime; /**< The time at which a DHCP request was sent. */
|
|
TickType_t xDHCPTxPeriod; /**< The maximum time that the client will wait for a reply. */
|
|
BaseType_t xUseBroadcast; /**< Try both without and with the broadcast flag */
|
|
eDHCPState_t eDHCPState; /**< Maintains the DHCP state machine state. */
|
|
};
|
|
|
|
typedef struct xDHCP_DATA DHCPData_t;
|
|
|
|
/* Returns the current state of a DHCP process. */
|
|
eDHCPState_t eGetDHCPState( void );
|
|
|
|
/*
|
|
* Send a message to the IP-task, which will call vDHCPProcess().
|
|
*
|
|
*/
|
|
BaseType_t xSendDHCPEvent( void );
|
|
|
|
/*
|
|
* NOT A PUBLIC API FUNCTION.
|
|
* It will be called when the DHCP timer expires, or when
|
|
* data has been received on the DHCP socket.
|
|
*/
|
|
void vDHCPProcess( BaseType_t xReset,
|
|
eDHCPState_t eExpectedState );
|
|
|
|
/* Internal call: returns true if socket is the current DHCP socket */
|
|
BaseType_t xIsDHCPSocket( Socket_t xSocket );
|
|
|
|
#if ( ipconfigUSE_DHCP_HOOK != 0 )
|
|
|
|
/* Prototype of the hook (or callback) function that must be provided by the
|
|
* application if ipconfigUSE_DHCP_HOOK is set to 1. See the following URL for
|
|
* usage information:
|
|
* http://www.FreeRTOS.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/TCP_IP_Configuration.html#ipconfigUSE_DHCP_HOOK
|
|
*/
|
|
eDHCPCallbackAnswer_t xApplicationDHCPHook( eDHCPCallbackPhase_t eDHCPPhase,
|
|
uint32_t ulIPAddress );
|
|
#endif /* ( ipconfigUSE_DHCP_HOOK != 0 ) */
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* FREERTOS_DHCP_H */
|