Project

General

Profile

Statistics
| Branch: | Tag: | Revision:

lustrec / src / machine_code.ml @ 1174cdd9

History | View | Annotate | Download (17.4 KB)

1

    
2
(* ----------------------------------------------------------------------------
3
 * SchedMCore - A MultiCore Scheduling Framework
4
 * Copyright (C) 2009-2013, ONERA, Toulouse, FRANCE - LIFL, Lille, FRANCE
5
 * Copyright (C) 2012-2013, INPT, Toulouse, FRANCE
6
 *
7
 * This file is part of Prelude
8
 *
9
 * Prelude is free software; you can redistribute it and/or
10
 * modify it under the terms of the GNU Lesser General Public License
11
 * as published by the Free Software Foundation ; either version 2 of
12
 * the License, or (at your option) any later version.
13
 *
14
 * Prelude is distributed in the hope that it will be useful, but
15
 * WITHOUT ANY WARRANTY ; without even the implied warranty of
16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17
 * Lesser General Public License for more details.
18
 *
19
 * You should have received a copy of the GNU Lesser General Public
20
 * License along with this program ; if not, write to the Free Software
21
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22
 * USA
23
 *---------------------------------------------------------------------------- *)
24

    
25
(* This module is used for the lustre to C compiler *)
26

    
27
open LustreSpec
28
open Corelang
29
open Clocks
30
open Causality
31

    
32
exception NormalizationError
33

    
34
module OrdVarDecl:Map.OrderedType with type t=var_decl =
35
  struct type t = var_decl;; let compare = compare end
36

    
37
module ISet = Set.Make(OrdVarDecl)
38

    
39
type value_t = 
40
  | Cst of constant
41
  | LocalVar of var_decl
42
  | StateVar of var_decl
43
  | Fun of ident * value_t list 
44
  | Array of value_t list
45
  | Access of value_t * value_t
46
  | Power of value_t * value_t
47

    
48
type instr_t =
49
  | MLocalAssign of var_decl * value_t
50
  | MStateAssign of var_decl * value_t
51
  | MReset of ident
52
  | MStep of var_decl list * ident * value_t list
53
  | MBranch of value_t * (label * instr_t list) list
54
 
55
let rec pp_val fmt v =
56
  match v with
57
    | Cst c         -> Printers.pp_const fmt c 
58
    | LocalVar v    -> Format.pp_print_string fmt v.var_id
59
    | StateVar v    -> Format.pp_print_string fmt v.var_id
60
    | Array vl      -> Format.fprintf fmt "[%a]" (Utils.fprintf_list ~sep:", " pp_val)  vl
61
    | Access (t, i) -> Format.fprintf fmt "%a[%a]" pp_val t pp_val i
62
    | Power (v, n)  -> Format.fprintf fmt "(%a^%a)" pp_val v pp_val n
63
    | Fun (n, vl)   -> Format.fprintf fmt "%s (%a)" n (Utils.fprintf_list ~sep:", " pp_val)  vl
64

    
65
let rec pp_instr fmt i =
66
  match i with 
67
    | MLocalAssign (i,v) -> Format.fprintf fmt "%s<-l- %a" i.var_id pp_val v
68
    | MStateAssign (i,v) -> Format.fprintf fmt "%s<-s- %a" i.var_id pp_val v
69
    | MReset i           -> Format.fprintf fmt "reset %s" i
70
    | MStep (il, i, vl)  ->
71
      Format.fprintf fmt "%a = %s (%a)"
72
	(Utils.fprintf_list ~sep:", " (fun fmt v -> Format.pp_print_string fmt v.var_id)) il
73
	i      
74
	(Utils.fprintf_list ~sep:", " pp_val) vl
75
    | MBranch (g,hl)     ->
76
      Format.fprintf fmt "@[<v 2>case(%a) {@,%a@,}@]"
77
	pp_val g
78
	(Utils.fprintf_list ~sep:"@," pp_branch) hl
79

    
80
and pp_branch fmt (t, h) =
81
  Format.fprintf fmt "@[<v 2>%s:@,%a@]" t (Utils.fprintf_list ~sep:"@," pp_instr) h
82

    
83
type step_t = {
84
  step_checks: (Location.t * value_t) list;
85
  step_inputs: var_decl list;
86
  step_outputs: var_decl list;
87
  step_locals: var_decl list;
88
  step_instrs: instr_t list;
89
}
90

    
91
type static_call = top_decl * (Dimension.dim_expr list)
92

    
93
type machine_t = {
94
  mname: node_desc;
95
  mmemory: var_decl list;
96
  mcalls: (ident * static_call) list; (* map from stateful/stateless instance to node, no internals *)
97
  minstances: (ident * static_call) list; (* sub-map of mcalls, from stateful instance to node *)
98
  minit: instr_t list;
99
  mstatic: var_decl list; (* static inputs only *)
100
  mstep: step_t;
101
  mspec: node_annot option;
102
  mannot: expr_annot option;
103
}
104

    
105
let pp_step fmt s =
106
  Format.fprintf fmt "@[<v>inputs : %a@ outputs: %a@ locals : %a@ checks : %a@ instrs : @[%a@]@]@ "
107
    (Utils.fprintf_list ~sep:", " Printers.pp_var) s.step_inputs
108
    (Utils.fprintf_list ~sep:", " Printers.pp_var) s.step_outputs
109
    (Utils.fprintf_list ~sep:", " Printers.pp_var) s.step_locals
110
    (Utils.fprintf_list ~sep:", " (fun fmt (_, c) -> pp_val fmt c)) s.step_checks
111
    (Utils.fprintf_list ~sep:"@ " pp_instr) s.step_instrs
112

    
113
let pp_static_call fmt (node, args) =
114
 Format.fprintf fmt "%s<%a>"
115
   (node_name node)
116
   (Utils.fprintf_list ~sep:", " Dimension.pp_dimension) args
117

    
118
let pp_machine fmt m =
119
  Format.fprintf fmt 
120
    "@[<v 2>machine %s@ mem      : %a@ instances: %a@ init     : %a@ step     :@   @[<v 2>%a@]@ @]@ "
121
    m.mname.node_id
122
    (Utils.fprintf_list ~sep:", " Printers.pp_var) m.mmemory
123
    (Utils.fprintf_list ~sep:", " (fun fmt (o1, o2) -> Format.fprintf fmt "(%s, %a)" o1 pp_static_call o2)) m.minstances
124
    (Utils.fprintf_list ~sep:"@ " pp_instr) m.minit
125
    pp_step m.mstep
126

    
127
(* Returns the declared stateless status and the computed one. *)
128
let get_stateless_status m =
129
 (m.mname.node_dec_stateless, Utils.desome m.mname.node_stateless)
130

    
131
let is_input m id =
132
  List.exists (fun o -> o.var_id = id.var_id) m.mstep.step_inputs
133

    
134
let is_output m id =
135
  List.exists (fun o -> o.var_id = id.var_id) m.mstep.step_outputs
136

    
137
let is_memory m id =
138
  List.exists (fun o -> o.var_id = id.var_id) m.mmemory
139

    
140
let conditional c t e =
141
  MBranch(c, [ (tag_true, t); (tag_false, e) ])
142

    
143
let dummy_var_decl name typ =
144
  {
145
    var_id = name;
146
    var_dec_type = dummy_type_dec;
147
    var_dec_clock = dummy_clock_dec;
148
    var_dec_const = false;
149
    var_type =  typ;
150
    var_clock = Clocks.new_ck (Clocks.Cvar Clocks.CSet_all) true;
151
    var_loc = Location.dummy_loc
152
  }
153

    
154
let arrow_id = "_arrow"
155

    
156
let arrow_typ = Types.new_ty Types.Tunivar
157

    
158
let arrow_desc =
159
  {
160
    node_id = arrow_id;
161
    node_type = Type_predef.type_bin_poly_op;
162
    node_clock = Clock_predef.ck_bin_univ;
163
    node_inputs= [dummy_var_decl "_in1" arrow_typ; dummy_var_decl "_in2" arrow_typ];
164
    node_outputs= [dummy_var_decl "_out" arrow_typ];
165
    node_locals= [];
166
    node_gencalls = [];
167
    node_checks = [];
168
    node_asserts = [];
169
    node_eqs= [];
170
    node_dec_stateless = false;
171
    node_stateless = Some false;
172
    node_spec = None;
173
    node_annot = None;  }
174

    
175
let arrow_top_decl =
176
  {
177
    top_decl_desc = Node arrow_desc;
178
    top_decl_loc = Location.dummy_loc
179
  }
180

    
181
let arrow_machine =
182
  let state = "_first" in
183
  let var_state = dummy_var_decl state (Types.new_ty Types.Tbool) in
184
  let var_input1 = List.nth arrow_desc.node_inputs 0 in
185
  let var_input2 = List.nth arrow_desc.node_inputs 1 in
186
  let var_output = List.nth arrow_desc.node_outputs 0 in
187
  {
188
    mname = arrow_desc;
189
    mmemory = [var_state];
190
    mcalls = [];
191
    minstances = [];
192
    minit = [MStateAssign(var_state, Cst (const_of_bool true))];
193
    mstatic = [];
194
    mstep = {
195
      step_inputs = arrow_desc.node_inputs;
196
      step_outputs = arrow_desc.node_outputs;
197
      step_locals = [];
198
      step_checks = [];
199
      step_instrs = [conditional (StateVar var_state)
200
			         [MStateAssign(var_state, Cst (const_of_bool false));
201
                                  MLocalAssign(var_output, LocalVar var_input1)]
202
                                 [MLocalAssign(var_output, LocalVar var_input2)] ]
203
    };
204
    mspec = None;
205
    mannot = None;
206
  }
207

    
208
let new_instance =
209
  let cpt = ref (-1) in
210
  fun caller callee tag ->
211
    begin
212
      let o =
213
	if Stateless.check_node callee then
214
	  node_name callee
215
	else
216
	  Printf.sprintf "ni_%d" (incr cpt; !cpt) in
217
      let o =
218
	if !Options.ansi && is_generic_node callee
219
	then Printf.sprintf "%s_inst_%d" o (Utils.position (fun e -> e.expr_tag = tag) caller.node_gencalls)
220
	else o in
221
      o
222
    end
223

    
224
(* translate_<foo> : node -> context -> <foo> -> machine code/expression *)
225
(* the context contains  m : state aka memory variables  *)
226
(*                      si : initialization instructions *)
227
(*                       j : node aka machine instances  *)
228
(*                       d : local variables             *)
229
(*                       s : step instructions           *)
230
let translate_ident node (m, si, j, d, s) id =
231
  try (* id is a node var *)
232
    let var_id = node_var id node in
233
    if ISet.exists (fun v -> v.var_id = id) m
234
    then StateVar var_id
235
    else LocalVar var_id
236
  with Not_found -> (* id is a constant *)
237
    LocalVar (Corelang.var_decl_of_const (Hashtbl.find Corelang.consts_table id))
238

    
239
let rec control_on_clock node ((m, si, j, d, s) as args) ck inst =
240
 match (Clocks.repr ck).cdesc with
241
 | Con    (ck1, cr, l) ->
242
   let id  = Clocks.const_of_carrier cr in
243
   control_on_clock node args ck1 (MBranch (translate_ident node args id,
244
					    [l, [inst]] ))
245
 | _                   -> inst
246

    
247
let rec join_branches hl1 hl2 =
248
 match hl1, hl2 with
249
 | []          , _            -> hl2
250
 | _           , []           -> hl1
251
 | (t1, h1)::q1, (t2, h2)::q2 ->
252
   if t1 < t2 then (t1, h1) :: join_branches q1 hl2 else
253
   if t1 > t2 then (t2, h2) :: join_branches hl1 q2
254
   else (t1, List.fold_right join_guards h1 h2) :: join_branches q1 q2
255

    
256
and join_guards inst1 insts2 =
257
 match inst1, insts2 with
258
 | _                   , []                               ->
259
   [inst1]
260
 | MBranch (x1, hl1), MBranch (x2, hl2) :: q when x1 = x2 ->
261
   MBranch (x1, join_branches (sort_handlers hl1) (sort_handlers hl2))
262
   :: q
263
 | _ -> inst1 :: insts2
264

    
265
let join_guards_list insts =
266
 List.fold_right join_guards insts []
267

    
268
let find_eq x eqs =
269
  let rec aux accu eqs =
270
      match eqs with
271
	| [] ->
272
	  begin
273
	    Format.eprintf "Looking for variable %a in the following equations@.%a@."
274
	      Format.pp_print_string x
275
	      Printers.pp_node_eqs eqs;
276
	    assert false
277
	  end
278
	| hd::tl -> 
279
	  if List.mem x hd.eq_lhs then hd, accu@tl else aux (hd::accu) tl
280
    in
281
    aux [] eqs
282

    
283
let rec translate_expr node ((m, si, j, d, s) as args) expr =
284
 match expr.expr_desc with
285
 | Expr_const v                     -> Cst v
286
 | Expr_ident x                     -> translate_ident node args x
287
 | Expr_array el                    -> Array (List.map (translate_expr node args) el)
288
 | Expr_access (t, i)               -> Access (translate_expr node args t, translate_expr node args (expr_of_dimension i))
289
 | Expr_power  (e, n)               -> Power  (translate_expr node args e, translate_expr node args (expr_of_dimension n))
290
 | Expr_tuple _
291
 | Expr_arrow _ 
292
 | Expr_fby _
293
 | Expr_pre _                       -> (Printers.pp_expr Format.err_formatter expr; Format.pp_print_flush Format.err_formatter (); raise NormalizationError)
294
 | Expr_when    (e1, _, _)          -> translate_expr node args e1
295
 | Expr_merge   (x, _)              -> raise NormalizationError
296
 | Expr_appl (id, e, _) when Basic_library.is_internal_fun id ->
297
   let nd = node_from_name id in
298
   (match e.expr_desc with
299
   | Expr_tuple el -> Fun (node_name nd, List.map (translate_expr node args) el)
300
   | _             -> Fun (node_name nd, [translate_expr node args e]))
301
 | Expr_ite (g,t,e) -> (
302
   (* special treatment depending on the active backend. For horn backend, ite
303
      are preserved in expression. While they are removed for C or Java
304
      backends. *)
305
   match !Options.output with | "horn" -> 
306
     Fun ("ite", [translate_expr node args g; translate_expr node args t; translate_expr node args e])
307
   | "C" | "java" | _ -> 
308
     (Printers.pp_expr Format.err_formatter expr; Format.pp_print_flush Format.err_formatter (); raise NormalizationError)
309
 )
310
 | _                   -> raise NormalizationError
311

    
312
let translate_guard node args expr =
313
  match expr.expr_desc with
314
  | Expr_ident x  -> translate_ident node args x
315
  | _ -> (Format.eprintf "internal error: translate_guard %s %a@." node.node_id Printers.pp_expr expr;assert false)
316

    
317
let rec translate_act node ((m, si, j, d, s) as args) (y, expr) =
318
  match expr.expr_desc with
319
  | Expr_ite   (c, t, e) -> let g = translate_guard node args c in
320
			    conditional g [translate_act node args (y, t)]
321
                              [translate_act node args (y, e)]
322
  | Expr_merge (x, hl)   -> MBranch (translate_ident node args x, List.map (fun (t,  h) -> t, [translate_act node args (y, h)]) hl)
323
  | _                    -> MLocalAssign (y, translate_expr node args expr)
324

    
325
let reset_instance node args i r c =
326
  match r with
327
  | None        -> []
328
  | Some (x, l) -> [control_on_clock node args c (MBranch (translate_ident node args x, [l, [MReset i]]))]
329

    
330
let translate_eq node ((m, si, j, d, s) as args) eq =
331
  (*Format.eprintf "translate_eq %a with clock %a@." Printers.pp_node_eq eq Clocks.print_ck eq.eq_rhs.expr_clock;*)
332
  match eq.eq_lhs, eq.eq_rhs.expr_desc with
333
  | [x], Expr_arrow (e1, e2)                     ->
334
    let var_x = node_var x node in
335
    let o = new_instance node arrow_top_decl eq.eq_rhs.expr_tag in
336
    let c1 = translate_expr node args e1 in
337
    let c2 = translate_expr node args e2 in
338
    (m,
339
     MReset o :: si,
340
     Utils.IMap.add o (arrow_top_decl, []) j,
341
     d,
342
     (control_on_clock node args eq.eq_rhs.expr_clock (MStep ([var_x], o, [c1;c2]))) :: s)
343
  | [x], Expr_pre e1 when ISet.mem (node_var x node) d     ->
344
    let var_x = node_var x node in
345
    (ISet.add var_x m,
346
     si,
347
     j,
348
     d,
349
     control_on_clock node args eq.eq_rhs.expr_clock (MStateAssign (var_x, translate_expr node args e1)) :: s)
350
  | [x], Expr_fby (e1, e2) when ISet.mem (node_var x node) d ->
351
    let var_x = node_var x node in
352
    (ISet.add var_x m,
353
     MStateAssign (var_x, translate_expr node args e1) :: si,
354
     j,
355
     d,
356
     control_on_clock node args eq.eq_rhs.expr_clock (MStateAssign (var_x, translate_expr node args e2)) :: s)
357
  | p  , Expr_appl (f, arg, r)                  ->
358
    let var_p = List.map (fun v -> node_var v node) p in
359
    let el =
360
      match arg.expr_desc with
361
      | Expr_tuple el -> el
362
      | _             -> [arg] in
363
    let vl = List.map (translate_expr node args) el in
364
    let node_f = node_from_name f in
365
    let call_f =
366
      node_f,
367
      NodeDep.filter_static_inputs (node_inputs node_f) el in 
368
    let o = new_instance node node_f eq.eq_rhs.expr_tag in
369
    let call_ck = Clocks.new_var true in
370
    Clock_calculus.unify_imported_clock (Some call_ck) eq.eq_rhs.expr_clock;
371
    (m,
372
     (if Stateless.check_node node_f then si else MReset o :: si),
373
     (if Basic_library.is_internal_fun f then j else Utils.IMap.add o call_f j),
374
     d,
375
     reset_instance node args o r eq.eq_rhs.expr_clock @
376
       (control_on_clock node args call_ck (MStep (var_p, o, vl))) :: s)
377

    
378
   (* special treatment depending on the active backend. For horn backend, x = ite (g,t,e)
379
      are preserved. While they are replaced as if g then x = t else x = e in  C or Java
380
      backends. *)
381
  | [x], Expr_ite   (c, t, e) 
382
    when (match !Options.output with | "horn" -> true | "C" | "java" | _ -> false)
383
      -> 
384
    let var_x = node_var x node in
385
    (m, 
386
     si, 
387
     j, 
388
     d, 
389
     (control_on_clock node args eq.eq_rhs.expr_clock 
390
	(MLocalAssign (var_x, translate_expr node args eq.eq_rhs))::s)
391
    )
392
      
393
  | [x], _                                       -> (
394
    let var_x = node_var x node in
395
    (m, si, j, d, 
396
     control_on_clock node args eq.eq_rhs.expr_clock (translate_act node args (var_x, eq.eq_rhs)) :: s)
397
  )
398
  | _                                            ->
399
    begin
400
      Format.eprintf "unsupported equation: %a@?" Printers.pp_node_eq eq;
401
      assert false
402
    end
403

    
404
let translate_eqs node args eqs =
405
  List.fold_right (fun eq args -> translate_eq node args eq) eqs args;;
406

    
407
let translate_decl nd =
408
  (*Log.report ~level:1 (fun fmt -> Printers.pp_node fmt nd);*)
409
  let nd, sch = Scheduling.schedule_node nd in
410
  let split_eqs = Splitting.tuple_split_eq_list nd.node_eqs in
411
  let eqs_rev, remainder = 
412
    List.fold_left 
413
      (fun (accu, node_eqs_remainder) v -> 
414
	  if List.exists (fun eq -> List.mem v eq.eq_lhs) accu
415
	  then
416
	    (accu, node_eqs_remainder)
417
	  else
418
	    (*if   List.exists (fun vdecl -> vdecl.var_id = v) nd.node_locals
419
	      || List.exists (fun vdecl -> vdecl.var_id = v) nd.node_outputs
420
	    then*)
421
	      let eq_v, remainder = find_eq v node_eqs_remainder in
422
	      eq_v::accu, remainder
423
	    (* else it is a constant value, checked during typing phase
424
	    else	 
425
	      accu, node_eqs_remainder *)
426
      ) 
427
      ([], split_eqs) 
428
      sch 
429
  in
430
  if List.length remainder > 0 then (
431
    Format.eprintf "Equations not used are@.%a@.Full equation set is:@.%a@.@?"
432
	    Printers.pp_node_eqs remainder
433
      	    Printers.pp_node_eqs nd.node_eqs;
434
    assert false )
435
  ;
436

    
437
  let init_args = ISet.empty, [], Utils.IMap.empty, List.fold_right (fun l -> ISet.add l) nd.node_locals ISet.empty, [] in
438
  let m, init, j, locals, s = translate_eqs nd init_args (List.rev eqs_rev) in
439
  let mmap = Utils.IMap.fold (fun i n res -> (i, n)::res) j [] in
440
  {
441
    mname = nd;
442
    mmemory = ISet.elements m;
443
    mcalls = mmap;
444
    minstances = List.filter (fun (_, (n,_)) -> not (Stateless.check_node n)) mmap;
445
    minit = init;
446
    mstatic = List.filter (fun v -> v.var_dec_const) nd.node_inputs;
447
    mstep = {
448
      step_inputs = nd.node_inputs;
449
      step_outputs = nd.node_outputs;
450
      step_locals = ISet.elements (ISet.diff locals m);
451
      step_checks = List.map (fun d -> d.Dimension.dim_loc, translate_expr nd init_args (expr_of_dimension d)) nd.node_checks;
452
      step_instrs = (
453
	(* special treatment depending on the active backend. For horn backend,
454
	   common branches are not merged while they are in C or Java
455
	   backends. *)
456
	match !Options.output with
457
	| "horn" -> s
458
	| "C" | "java" | _ -> join_guards_list s
459
      );
460
    };
461
    mspec = nd.node_spec;
462
    mannot = nd.node_annot;
463
  }
464

    
465

    
466
let translate_prog decls =
467
  let nodes = get_nodes decls in 
468
   (* What to do with Imported/Sensor/Actuators ? *)
469
   (*arrow_machine ::*)  List.map translate_decl nodes
470

    
471
let get_machine_opt name machines =  
472
  List.fold_left 
473
    (fun res m -> 
474
      match res with 
475
      | Some _ -> res 
476
      | None -> if m.mname.node_id = name then Some m else None)
477
    None machines
478
    
479

    
480
(* Local Variables: *)
481
(* compile-command:"make -C .." *)
482
(* End: *)