/**************************************************************************** ** ** ** Name: EmmDeregisteredNormalService() ** ** ** ** Description: Handles the behaviour of the UE while the EMM-SAP is in ** ** EMM-DEREGISTERED.NORMAL-SERVICE state. ** ** ** ** 3GPP TS 24.301, section 5.2.2.3.1 ** ** The UE shall initiate an attach or combined attach proce- ** ** dure. ** ** ** ** Inputs: evt: The received EMM-SAP event ** ** Others: emm_fsm_status ** ** ** ** Outputs: None ** ** Return: RETURNok, RETURNerror ** ** Others: emm_fsm_status ** ** ** ***************************************************************************/ int EmmDeregisteredNormalService(const emm_reg_t *evt) { LOG_FUNC_IN; int rc = RETURNerror; assert(emm_fsm_get_status() == EMM_DEREGISTERED_NORMAL_SERVICE); switch (evt->primitive) { case _EMMREG_REGISTER_REQ: /* * The user manually re-selected a 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_ATTACH_INIT: /* * Initiate the attach procedure for EPS services */ rc = emm_proc_attach(EMM_ATTACH_TYPE_EPS); break; case _EMMREG_ATTACH_REQ: /* * An EPS network attach has been requested (Attach Request * message successfully delivered to the network); * enter state EMM-REGISTERED-INITIATED */ rc = emm_fsm_set_status(EMM_REGISTERED_INITIATED); break; case _EMMREG_LOWERLAYER_SUCCESS: /* * Initial NAS message has been successfully delivered * to the network */ rc = emm_proc_lowerlayer_success(); break; case _EMMREG_LOWERLAYER_FAILURE: /* * Initial NAS message failed to be delivered to the network */ rc = emm_proc_lowerlayer_failure(TRUE); break; case _EMMREG_LOWERLAYER_RELEASE: /* * NAS signalling connection has been released */ rc = emm_proc_lowerlayer_release(); break; case _EMMREG_ATTACH_CNF: /* * Attach procedure successful and default EPS bearer * context activated; * enter state EMM-REGISTERED. */ rc = emm_fsm_set_status(EMM_REGISTERED); 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: EmmRegistered() ** ** ** ** Description: Handles the behaviour of the UE and the MME while the ** ** EMM-SAP is in EMM-REGISTERED state. ** ** ** ** Inputs: evt: The received EMM-SAP event ** ** Others: emm_fsm_status ** ** ** ** Outputs: None ** ** Return: RETURNok, RETURNerror ** ** Others: emm_fsm_status ** ** ** ***************************************************************************/ int EmmRegistered(const emm_reg_t *evt) { LOG_FUNC_IN; int rc = RETURNerror; #ifdef NAS_UE assert(emm_fsm_get_status() == EMM_REGISTERED); #endif #ifdef NAS_MME assert(emm_fsm_get_status(evt->ueid, evt->ctx) == EMM_REGISTERED); #endif switch (evt->primitive) { #ifdef NAS_UE 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: /* * 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_DETACH_CNF: /* * The UE implicitly detached from the network (all EPS * bearer contexts may have been deactivated) */ rc = emm_fsm_set_status(EMM_DEREGISTERED); break; case _EMMREG_TAU_REQ: /* * TODO: Tracking Area Update has been requested */ LOG_TRACE(ERROR, "EMM-FSM - Tracking Area Update procedure " "is not implemented"); break; case _EMMREG_SERVICE_REQ: /* * TODO: Service Request has been requested */ LOG_TRACE(ERROR, "EMM-FSM - Service Request procedure " "is not implemented"); break; case _EMMREG_LOWERLAYER_SUCCESS: /* * Data transfer message has been successfully delivered */ rc = emm_proc_lowerlayer_success(); break; case _EMMREG_LOWERLAYER_FAILURE: /* * Data transfer message failed to be delivered */ rc = emm_proc_lowerlayer_failure(FALSE); break; case _EMMREG_LOWERLAYER_RELEASE: /* * NAS signalling connection has been released */ rc = emm_proc_lowerlayer_release(); break; #endif #ifdef NAS_MME case _EMMREG_DETACH_REQ: /* * Network detach has been requested (implicit detach); * enter state EMM-DEREGISTERED */ rc = emm_fsm_set_status(evt->ueid, evt->ctx, EMM_DEREGISTERED); 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_TAU_REJ: /* * TODO: Tracking Area Update has been rejected */ LOG_TRACE(ERROR, "EMM-FSM - Tracking Area Update procedure " "is not implemented"); break; 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; #endif default: LOG_TRACE(ERROR, "EMM-FSM - Primitive is not valid (%d)", evt->primitive); break; } LOG_FUNC_RETURN (rc); }