f8ffb2cf5a
According to IEEE 802.1AS-2011, the BMCA used in gPTP is the same as that used in IEEE 1588 with the following exceptions: (1) Announce messages received on a slave port that were not sent by the receiving time-aware system are used immediately, i.e., there is no foreign-master qualification. (2) A port that the BMCA determines should be a master port enters the master state immediately, i.e., there is no pre-master state. (3) The uncalibrated state is not needed and, therefore, not used. (4) All time-aware systems are required to participate in best master selection (even if it is not grandmaster capable). This patch is to support (1) by using a specific FOREIGN_MASTER_THRESHOLD case. (Treat FOREIGN_MASTER_THRESHOLD as 1.) To support (2) and (3), reuse ptp_fsm and drop pre-master/uncalibrated states. The (4) item is supported since IEEE 802.1AS reuses OC/BC. Signed-off-by: Erik Hons <erik.hons@ni.com> Signed-off-by: Rodney Greenstreet <rodney.greenstreet@ni.com> Signed-off-by: Yangbo Lu <yangbo.lu@nxp.com>
93 lines
2.6 KiB
C
93 lines
2.6 KiB
C
/**
|
|
* @file fsm.h
|
|
* @brief The finite state machine for ports on boundary and ordinary clocks.
|
|
* @note Copyright (C) 2011 Richard Cochran <richardcochran@gmail.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
#ifndef HAVE_FSM_H
|
|
#define HAVE_FSM_H
|
|
|
|
/** Defines the state of a port. */
|
|
enum port_state {
|
|
PS_INITIALIZING = 1,
|
|
PS_FAULTY,
|
|
PS_DISABLED,
|
|
PS_LISTENING,
|
|
PS_PRE_MASTER,
|
|
PS_MASTER,
|
|
PS_PASSIVE,
|
|
PS_UNCALIBRATED,
|
|
PS_SLAVE,
|
|
PS_GRAND_MASTER, /*non-standard extension*/
|
|
};
|
|
|
|
/** Defines the events for the port state machine. */
|
|
enum fsm_event {
|
|
EV_NONE,
|
|
EV_POWERUP,
|
|
EV_INITIALIZE,
|
|
EV_DESIGNATED_ENABLED,
|
|
EV_DESIGNATED_DISABLED,
|
|
EV_FAULT_CLEARED,
|
|
EV_FAULT_DETECTED,
|
|
EV_STATE_DECISION_EVENT,
|
|
EV_QUALIFICATION_TIMEOUT_EXPIRES,
|
|
EV_ANNOUNCE_RECEIPT_TIMEOUT_EXPIRES,
|
|
EV_SYNCHRONIZATION_FAULT,
|
|
EV_MASTER_CLOCK_SELECTED,
|
|
EV_INIT_COMPLETE,
|
|
EV_RS_MASTER,
|
|
EV_RS_GRAND_MASTER,
|
|
EV_RS_SLAVE,
|
|
EV_RS_PASSIVE,
|
|
};
|
|
|
|
enum bmca_select {
|
|
BMCA_PTP,
|
|
BMCA_NOOP,
|
|
};
|
|
|
|
/**
|
|
* Run the state machine for a BC or OC port.
|
|
* @param state The current state of the port.
|
|
* @param event The event to be processed.
|
|
* @param mdiff Whether a new master has been selected.
|
|
* @return The new state for the port.
|
|
*/
|
|
enum port_state ptp_fsm(enum port_state state, enum fsm_event event, int mdiff);
|
|
|
|
/**
|
|
* Run the state machine for a slave only clock.
|
|
* @param state The current state of the port.
|
|
* @param event The event to be processed.
|
|
* @param mdiff Whether a new master has been selected.
|
|
* @return The new state for the port.
|
|
*/
|
|
enum port_state ptp_slave_fsm(enum port_state state, enum fsm_event event,
|
|
int mdiff);
|
|
|
|
/**
|
|
* Run the state machine for a ieee8021as port.
|
|
* @param state The current state of the port.
|
|
* @param event The event to be processed.
|
|
* @param mdiff Whether a new master has been selected.
|
|
* @return The new state for the port.
|
|
*/
|
|
enum port_state ieee8021as_fsm(enum port_state state, enum fsm_event event,
|
|
int mdiff);
|
|
|
|
#endif
|