summaryrefslogtreecommitdiffstats
path: root/uqmid/sim_fsm.h
blob: 94ef38e01bc17de17e943c66643dbf356fab5f6f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
#ifndef __UQMID_SIM_FSM_H
#define __UQMID_SIM_FSM_H

#include <stdbool.h>

enum sim_fsm_state {
	SIM_ST_IDLE,
	SIM_ST_WAIT_UIM_PRESENT,
	SIM_ST_GET_INFO,
	SIM_ST_CHV_PIN,
	SIM_ST_CHV_PUK,
	SIM_ST_READY,
	SIM_ST_FAILED,
	SIM_ST_NO_PIN_TRIES_LEFT,
	SIM_ST_FAIL_PUK_REQUIRED,
	SIM_ST_FAIL_PIN_REQUIRED,
	SIM_ST_FAIL_NO_SIM_PRESENT,
	SIM_ST_DESTROY,
};

// check uim available (or not configured to be used)
// uim get slot status, uim get card status
// uim check if pin is required, check if puk is required
// uim get IMSI, ICCID, MSISDN?
// setup indication to be notified if sim got removed

// sending information towards modem_fsm-> (removed, ready)

enum sim_fsm_event {
	SIM_EV_REQ_START,
	SIM_EV_REQ_CONFIGURED,
	SIM_EV_REQ_DESTROY,

	SIM_EV_RX_UIM_FAILED, /* UIM failed, need to switch to DMS */

	SIM_EV_RX_UIM_GET_SLOT_FAILED, /* some modem doesn't support GET SLOT */
	SIM_EV_RX_UIM_NO_UIM_FOUND, /* we couldn't find a UIM */
	SIM_EV_RX_UIM_VALID_ICCID, /* when Get Slot Status found a valid ICCID */
	SIM_EV_RX_UIM_CARD_STATUS_VALID, /* Got a valid Get Card Status */

	SIM_EV_RX_UIM_GET_IMSI_SUCCESS,
	SIM_EV_RX_UIM_GET_IMSI_FAILED,

	SIM_EV_RX_UIM_PIN_REQUIRED,
	SIM_EV_RX_UIM_PIN_INVALID,
	SIM_EV_RX_UIM_PIN_VERIFIED,

	SIM_EV_RX_UIM_PUK_REQUIRED,
	SIM_EV_RX_UIM_PUK_INVALID,
	SIM_EV_RX_UIM_PUK_VERIFIED,

	SIM_EV_RX_UIM_REFRESH, /* we need to re-check the UIM. E.g. this can happen when pin verified or puk applied, but with a result which we can't parse */
	SIM_EV_RX_UIM_READY,

	SIM_EV_RX_FAILED,
	SIM_EV_RX_SUCCEED, /* a generic callback succeeded */
};

struct modem;
struct osmo_fsm_inst;

void sim_fsm_start(struct modem *modem);
struct osmo_fsm_inst *sim_fsm_alloc(struct modem *modem);

#endif /* __UQMID_SIM_FSM_H */