/**************************************************************************** ** ** ** Name: EmmDeregisteredAttemptingToAttach() ** ** ** ** Description: Handles the behaviour of the UE while the EMM-SAP is in ** ** EMM-DEREGISTERED.ATTEMPTING-TO-ATTACH state. ** ** ** ** 3GPP TS 24.301, section 5.2.2.3.3 ** ** ** ** Inputs: evt: The received EMM-SAP event ** ** Others: emm_fsm_status ** ** ** ** Outputs: None ** ** Return: RETURNok, RETURNerror ** ** Others: emm_fsm_status ** ** ** ***************************************************************************/ int EmmDeregisteredAttemptingToAttach(const emm_reg_t *evt) { LOG_FUNC_IN; int rc = RETURNerror; assert(emm_fsm_get_status() == EMM_DEREGISTERED_ATTEMPTING_TO_ATTACH); switch (evt->primitive) { case _EMMREG_ATTACH_INIT: /* * Attach procedure has to be restarted (timers T3402 or T3411 * expired) */ /* Move to the corresponding initial EMM state */ if (evt->u.attach.is_emergency) { rc = emm_fsm_set_status(EMM_DEREGISTERED_LIMITED_SERVICE); } else { rc = emm_fsm_set_status(EMM_DEREGISTERED_NORMAL_SERVICE); } if (rc != RETURNerror) { /* Restart the attach procedure */ rc = emm_proc_attach_restart(); } break; case _EMMREG_LOWERLAYER_SUCCESS: /* * Data successfully delivered to the network */ rc = emm_proc_lowerlayer_success(); break; case _EMMREG_LOWERLAYER_FAILURE: /* * Data failed to be delivered to the network */ rc = emm_proc_lowerlayer_failure(FALSE); break; default: LOG_TRACE(ERROR, "EMM-FSM - Primitive is not valid (%d)", evt->primitive); break; } LOG_FUNC_RETURN (rc); }
/**************************************************************************** ** ** ** Name: EmmRegisteredInitiated() ** ** ** ** Description: Handles the behaviour of the UE while the EMM-SAP is in ** ** EMM-REGISTERED-INITIATED state. ** ** ** ** Inputs: evt: The received EMM-SAP event ** ** Others: emm_fsm_status ** ** ** ** Outputs: None ** ** Return: RETURNok, RETURNerror ** ** Others: emm_fsm_status ** ** ** ***************************************************************************/ int EmmRegisteredInitiated(const emm_reg_t *evt) { LOG_FUNC_IN; int rc = RETURNerror; assert(emm_fsm_get_status() == EMM_REGISTERED_INITIATED); switch (evt->primitive) { case _EMMREG_ATTACH_INIT: /* * Attach procedure has to be restarted (timers T3402 or T3411 * expired) */ /* Move to the corresponding initial EMM state */ if (evt->u.attach.is_emergency) { rc = emm_fsm_set_status(EMM_DEREGISTERED_LIMITED_SERVICE); } else { rc = emm_fsm_set_status(EMM_DEREGISTERED_NORMAL_SERVICE); } if (rc != RETURNerror) { /* Restart the attach procedure */ rc = emm_proc_attach_restart(); } break; case _EMMREG_ATTACH_FAILED: /* * Attempt to attach to the network failed (abnormal case or * timer T3410 expired). The network attach procedure shall be * restarted when timer T3411 expires. */ rc = emm_fsm_set_status(EMM_DEREGISTERED_ATTEMPTING_TO_ATTACH); break; case _EMMREG_ATTACH_EXCEEDED: /* * Attempt to attach to the network failed (abnormal case or * timer T3410 expired) and the attach attempt counter reached * its maximum value. The state is changed to EMM-DEREGISTERED. * ATTEMPTING-TO-ATTACH or optionally to EMM-DEREGISTERED.PLMN- * SEARCH in order to perform a PLMN selection. */ /* TODO: ATTEMPTING-TO-ATTACH or PLMN-SEARCH ??? */ rc = emm_fsm_set_status(EMM_DEREGISTERED_ATTEMPTING_TO_ATTACH); break; case _EMMREG_ATTACH_CNF: /* * EPS network attach accepted by the network; * enter state EMM-REGISTERED. */ rc = emm_fsm_set_status(EMM_REGISTERED); if (rc != RETURNerror) { /* * Notify EMM that the MT is registered */ rc = emm_proc_registration_notify(NET_REG_STATE_HN); if (rc != RETURNok) { LOG_TRACE(WARNING, "EMM-FSM - " "Failed to notify registration update"); } } break; case _EMMREG_AUTH_REJ: /* * UE authentication rejected by the network; * abort any EMM signalling procedure */ case _EMMREG_ATTACH_REJ: /* * EPS network attach rejected by the network; * enter state EMM-DEREGISTERED. */ rc = emm_fsm_set_status(EMM_DEREGISTERED); if (rc != RETURNerror) { /* * Notify EMM that the MT's registration is denied */ rc = emm_proc_registration_notify(NET_REG_STATE_DENIED); if (rc != RETURNok) { LOG_TRACE(WARNING, "EMM-FSM - " "Failed to notify registration update"); } } break; case _EMMREG_REGISTER_REQ: /* * The UE has to select a new PLMN to register to */ rc = emm_fsm_set_status(EMM_DEREGISTERED_PLMN_SEARCH); if (rc != RETURNerror) { /* Process the network registration request */ rc = emm_fsm_process(evt); } break; case _EMMREG_REGISTER_REJ: /* * The UE failed to register to the network for normal EPS service */ rc = emm_fsm_set_status(EMM_DEREGISTERED_LIMITED_SERVICE); break; case _EMMREG_NO_IMSI: /* * The UE failed to register to the network for emergency * bearer services */ rc = emm_fsm_set_status(EMM_DEREGISTERED_NO_IMSI); break; case _EMMREG_DETACH_INIT: /* * Initiate detach procedure for EPS services */ rc = emm_proc_detach(EMM_DETACH_TYPE_EPS, evt->u.detach.switch_off); break; case _EMMREG_DETACH_REQ: /* * An EPS network detach has been requested (Detach Request * message successfully delivered to the network); * enter state EMM-DEREGISTERED-INITIATED */ rc = emm_fsm_set_status(EMM_DEREGISTERED_INITIATED); break; case _EMMREG_LOWERLAYER_SUCCESS: /* * Data transfer message has been successfully delivered; * The NAS message may be Attach Complete, Detach Request or * any message transfered by EMM common procedures requested * by the network. */ rc = emm_proc_lowerlayer_success(); break; case _EMMREG_LOWERLAYER_FAILURE: /* * Data transfer message failed to be delivered; * The NAS message may be Attach Complete, Detach Request or * any message transfered by EMM common procedures requested * by the network. */ rc = emm_proc_lowerlayer_failure(FALSE); break; case _EMMREG_LOWERLAYER_RELEASE: /* * NAS signalling connection has been released before the Attach * Accept, Attach Reject, or any message transfered by EMM common * procedures requested by the network, is received. */ rc = emm_proc_lowerlayer_release(); break; default: LOG_TRACE(ERROR, "EMM-FSM - Primitive is not valid (%d)", evt->primitive); break; } LOG_FUNC_RETURN (rc); }
/**************************************************************************** ** ** ** Name: EmmDeregistered() ** ** ** ** Description: Handles the behaviour of the UE and the MME while the ** ** EMM-SAP is in EMM-DEREGISTERED state. ** ** ** ** 3GPP TS 24.301, section 5.2.2.2 ** ** ** ** Inputs: evt: The received EMM-SAP event ** ** Others: emm_fsm_status ** ** ** ** Outputs: None ** ** Return: RETURNok, RETURNerror ** ** Others: emm_fsm_status ** ** ** ***************************************************************************/ int EmmDeregistered(const emm_reg_t *evt) { LOG_FUNC_IN; int rc = RETURNerror; #ifdef NAS_UE assert(emm_fsm_get_status() == EMM_DEREGISTERED); #endif #ifdef NAS_MME assert(emm_fsm_get_status(evt->ueid, evt->ctx) == EMM_DEREGISTERED); #endif #ifdef NAS_UE /* Delete the authentication data RAND and RES */ rc = emm_proc_authentication_delete(); if (rc != RETURNok) { LOG_FUNC_RETURN (rc); } /* TODO: 3GPP TS 24.301, section 4.4.2.1 * The UE shall store the current native EPS security context as specified * in annex C and mark it as valid only when the UE enters state EMM- * DEREGISTERED from any other state except EMM-NULL or when the UE aborts * the attach procedure without having left EMM-DEREGISTERED. */ #endif switch (evt->primitive) { #ifdef NAS_UE case _EMMREG_NO_IMSI: /* * The UE was powered on without a valid USIM application present */ rc = emm_fsm_set_status(EMM_DEREGISTERED_NO_IMSI); break; case _EMMREG_REGISTER_REQ: /* * The default EMM primary substate when the UE is switched on * with valid USIM application shall be PLMN-SEARCH */ rc = emm_fsm_set_status(EMM_DEREGISTERED_PLMN_SEARCH); if (rc != RETURNerror) { /* Process the network registration request */ rc = emm_fsm_process(evt); } break; case _EMMREG_ATTACH_INIT: /* * Attach procedure has to be restarted (timers T3402 or T3411 * expired) while the UE locally detached from the network */ /* Move to the corresponding initial EMM state */ if (evt->u.attach.is_emergency) { rc = emm_fsm_set_status(EMM_DEREGISTERED_LIMITED_SERVICE); } else { rc = emm_fsm_set_status(EMM_DEREGISTERED_NORMAL_SERVICE); } if (rc != RETURNerror) { /* Restart the attach procedure */ rc = emm_proc_attach_restart(); } break; #endif #ifdef NAS_MME case _EMMREG_PROC_ABORT: /* * Ongoing EMM procedure aborted */ rc = RETURNok; break; case _EMMREG_COMMON_PROC_REQ: /* * An EMM common procedure has been initiated; * enter state EMM-COMMON-PROCEDURE-INITIATED. */ rc = emm_fsm_set_status(evt->ueid, evt->ctx, EMM_COMMON_PROCEDURE_INITIATED); break; case _EMMREG_ATTACH_CNF: /* * Attach procedure successful and default EPS bearer * context activated; * enter state EMM-REGISTERED. */ rc = emm_fsm_set_status(evt->ueid, evt->ctx, EMM_REGISTERED); break; #endif case _EMMREG_LOWERLAYER_SUCCESS: /* * Data successfully delivered to the network */ rc = RETURNok; break; case _EMMREG_LOWERLAYER_FAILURE: /* * Data failed to be delivered to the network */ rc = RETURNok; break; default: LOG_TRACE(ERROR, "EMM-FSM - Primitive is not valid (%d)", evt->primitive); break; } #ifdef NAS_UE /* TODO: 3GPP TS 24.301, section 4.4.2.1 * The UE shall mark the EPS security context on the USIM or in the non- * volatile memory as invalid when the UE initiates an attach procedure * or when the UE leaves state EMM-DEREGISTERED for any other state except * EMM-NULL. */ #endif LOG_FUNC_RETURN (rc); }