summaryrefslogtreecommitdiff
path: root/cesar/mac/pbproc/test/fsm/src/test_fsm.c
blob: fc4efd4c9888a83b7f51de4fcc57651c7d42c454 (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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
/* Cesar project {{{
 *
 * Copyright (C) 2007 Spidcom
 *
 * <<<Licence>>>
 *
 * }}} */
/**
 * \file    src/test_fsm.c
 * \brief   Test FSM engine.
 * \ingroup test
 */
#include "common/std.h"

#include "lib/test.h"
#include "lib/rnd.h"

#include "mac/pbproc/inc/context.h"

#define NB_ITER 10000
#define NB_EVENT 3

/** Test transition description. */
struct fsm_basic_trans_desc_t
{
    /** Is an unexpected transition. */
    bool unexpected;
    /** Will ask a DSR. */
    bool defer;
    /** Next state. */
    pbproc_fsm_state_t next_state;
};
typedef struct fsm_basic_trans_desc_t fsm_basic_trans_desc_t;

/** Test description structure. */
struct fsm_basic_desc_t
{
    /** Current state. */
    pbproc_fsm_state_t state;
    /** Expect callback (0-2 for event, -1 for DSR). */
    int expected;
    /** Set by the callback if ok. */
    bool ok;
    /** Transition table. */
    fsm_basic_trans_desc_t trans[PBPROC_FSM_STATE_NB][NB_EVENT];
};
typedef struct fsm_basic_desc_t fsm_basic_desc_t;

/** FSM DSR event callback. */
void
fsm_deferred_cb (pbproc_t *ctx)
{
    fsm_basic_desc_t *d;
    dbg_assert (ctx);
    d = ctx->user_data;
    dbg_assert (d);
    dbg_assert (d->state < PBPROC_FSM_STATE_NB);
    if (d->expected == -1)
    {
        d->ok = true;
    }
}

/** FSM any event callback. */
void
fsm_event_cb (pbproc_t *ctx, int event)
{
    fsm_basic_desc_t *d;
    dbg_assert (ctx);
    dbg_assert (event >= 0 && event < NB_EVENT);
    d = ctx->user_data;
    dbg_assert (d);
    dbg_assert (d->state < PBPROC_FSM_STATE_NB);
    fsm_basic_trans_desc_t *t = &d->trans[d->state][event];
    if (d->expected == event && !t->unexpected)
    {
        d->ok = true;
        if (t->defer)
            pbproc_fsm_schedule_deferred (ctx, fsm_deferred_cb);
        pbproc_fsm_change_state (ctx, t->next_state);
    }
}

/** FSM RX FC event callback. */
void
fsm_rx_fc_cb (pbproc_t *ctx, u32 rx_date, const pbproc_fc_t *fc_av)
{
    fsm_event_cb (ctx, 0);
}

/** FSM ACCESS event callback. */
void
fsm_access_cb (pbproc_t *ctx)
{
    fsm_event_cb (ctx, 1);
}

/** FSM ACCESS CONFIRM event callback. */
void
fsm_access_conf_cb (pbproc_t *ctx)
{
    fsm_event_cb (ctx, 2);
}

void
fsm_basic_test_case (test_t t)
{
    pbproc_t pbproc;
    fsm_basic_desc_t d;
    pbproc_fsm_state_t s;
    uint i;
    lib_rnd_t rnd[1];
    test_case_begin (t, "basic");
    lib_rnd_init (rnd, 1234);
    /* Initialise FSM part. */
    pbproc_fsm_init (&pbproc);
    /* Randomize automaton. */
    d.state = PBPROC_FSM_STATE_IDLE;
    d.expected = 0;
    d.ok = false;
    for (s = 0; s < PBPROC_FSM_STATE_NB; s++)
    {
        bool one_expected = false;
        for (i = 0; i < NB_EVENT; i++)
        {
            d.trans[s][i].unexpected = (one_expected || i != NB_EVENT - 1)
                && lib_rnd_flip_coin (rnd, LIB_RND_RATIO (0.3));
            if (!d.trans[s][i].unexpected)
            {
                d.trans[s][i].defer =
                    lib_rnd_flip_coin (rnd, LIB_RND_RATIO (0.5));
                d.trans[s][i].next_state =
                    lib_rnd_uniform (rnd, PBPROC_FSM_STATE_NB);
                one_expected = true;
                switch (i)
                {
                case 0:
                    pbproc.fsm.states[s].rx_fc_cb = fsm_rx_fc_cb;
                    break;
                case 1:
                    pbproc.fsm.states[s].access_cb = fsm_access_cb;
                    break;
                case 2:
                    pbproc.fsm.states[s].access_conf_cb = fsm_access_conf_cb;
                    break;
                }
            }
        }
    }
    pbproc.user_data = &d;
    /* Run automaton. */
    test_begin (t, "random transitions")
    {
        int event;
        bool defer;
        for (i = 0; i < NB_ITER; i++)
        {
            do {
                event = lib_rnd_uniform (rnd, NB_EVENT);
            } while (d.trans[d.state][event].unexpected);
            d.expected = event;
            switch (event)
            {
            case 0:
                defer = pbproc_fsm_handle_rx_fc_event (&pbproc, 0, NULL);
                break;
            case 1:
                defer = pbproc_fsm_handle_access_event (&pbproc);
                break;
            case 2:
                defer = pbproc_fsm_handle_access_conf_event (&pbproc);
                break;
            }
            test_fail_unless (d.ok, "callback not called");
            d.ok = false;
            test_fail_unless (pbproc.fsm.current_state ==
                              d.trans[d.state][event].next_state);
            if (defer)
            {
                d.expected = -1;
                pbproc_fsm_handle_deferred (&pbproc);
                test_fail_unless (d.ok, "callback not called");
                d.ok = false;
            }
            else
            {
                test_fail_unless (!pbproc.fsm.deferred_cb);
            }
            d.state = pbproc.fsm.current_state;
        }
    } test_end;
}

void
fsm_test_suite (test_t t)
{
    test_suite_begin (t, "fsm");
    fsm_basic_test_case (t);
}

int
main (int argc, char **argv)
{
    test_t t;
    test_init (t, argc, argv);
    fsm_test_suite (t);
    test_result (t);
    return test_nb_failed (t) == 0 ? 0 : 1;
}