Source file hierarchy.ml

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
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
open Base

include struct
  open Hardcaml_waveterm_kernel
  module Style = Style
  module Waves = Waves
end

module M = Hierarchy_intf.M

module Make (Data : Hardcaml_waveterm_kernel.Data.S) = struct
  module Wave = Hardcaml_waveterm_kernel.Wave

  type node =
    { mutable visible : bool
    ; signals : Data.t Wave.t list
    ; children : node Base.Map.M(String).t
    }
  [@@deriving sexp_of]

  type currently_rendered =
    { actual_wave : Data.t Wave.t array
    ; for_rendering : Data.t Wave.t array
    }
  [@@deriving sexp_of]

  type t =
    { mutable cfg : Waves.Config.t
    ; mutable cursors : Cursors.t
    ; root : node
    ; mutable currently_rendered : currently_rendered
    }
  [@@deriving sexp_of]

  let empty_node = { visible = false; signals = []; children = Map.empty (module String) }

  let rec update ~path ~wave t =
    match path with
    | [] -> assert false
    | [ _ ] -> { t with signals = (* The list is built backwards *) wave :: t.signals }
    | hd :: tl ->
      let children =
        Map.update t.children hd ~f:(function
          | None -> update ~path:tl ~wave empty_node
          | Some x -> update ~path:tl ~wave x)
      in
      { t with children }
  ;;

  (* Restore order of signals relative to the input order. *)
  let rec put_back_into_display_order (node : node) =
    { node with
      signals = List.rev node.signals
    ; children = Base.Map.map node.children ~f:put_back_into_display_order
    }
  ;;

  let move_to_delta_on_active_node ~start_cycle ~search_forwards_or_backwards (t : t) =
    let selected_wave_index = t.cfg.selected_signal in
    match t.currently_rendered.actual_wave.(selected_wave_index) with
    | Clock _ | Empty _ | Divider _ -> None
    | Binary { data; _ } | Data { data; _ } ->
      let len = Data.length data in
      let start_cycle =
        match search_forwards_or_backwards with
        | `Forwards -> start_cycle
        | `Backwards -> start_cycle - 1
      in
      let%bind.Option initial =
        if 0 <= start_cycle && start_cycle < len
        then Some (Data.get data start_cycle)
        else None
      in
      let inc_or_dec i =
        match search_forwards_or_backwards with
        | `Forwards -> i + 1
        | `Backwards -> i - 1
      in
      let rec loop i =
        let[@inline always] mismatch_with_original () =
          Hardcaml.Bits.(not (to_bool (Data.get data i ==: initial)))
        in
        if i < 0 || i >= len
        then None
        else if mismatch_with_original ()
        then
          Some
            (match search_forwards_or_backwards with
             | `Forwards -> i
             | `Backwards -> i + 1)
        else loop (inc_or_dec i)
      in
      loop (inc_or_dec start_cycle)
  ;;

  let cycle_wave_format (t : t) =
    let selected_wave_index = t.cfg.selected_signal in
    match t.currently_rendered.actual_wave.(selected_wave_index) with
    | Clock _ | Empty _ | Divider _ | Binary _ -> ()
    | Data { wave_format; _ } ->
      wave_format.current
      <- (match wave_format.current with
          (* Cycle through these basic numeric formats *)
          | Binary -> Hex
          | Hex -> Unsigned_int
          | Unsigned_int -> Int
          | Int -> Binary
          (* Default to Binary *)
          | Bit -> Binary
          | Bit_or _ -> Binary
          | Index _ -> Binary
          | Custom _ -> Binary
          | Map _ -> Binary)
  ;;

  let reset_wave_format (t : t) =
    let selected_wave_index = t.cfg.selected_signal in
    match t.currently_rendered.actual_wave.(selected_wave_index) with
    | Clock _ | Empty _ | Divider _ | Binary _ -> ()
    | Data { wave_format; _ } -> wave_format.current <- wave_format.default
  ;;

  let cycle_colour (t : t) =
    let selected_wave_index = t.cfg.selected_signal in
    let next_colour (colour : Style.colour) : Style.colour =
      match colour with
      | Black -> Red
      | Red -> Green
      | Green -> Yellow
      | Yellow -> Blue
      | Blue -> Magenta
      | Magenta -> Cyan
      | Cyan -> White
      | White -> Black
    in
    let cycle_fg_colour { Style.bold; fg; bg } =
      let fg = next_colour fg in
      let fg = if Style.equal_colour fg bg then next_colour fg else fg in
      { Style.bold; fg; bg }
    in
    match t.currently_rendered.actual_wave.(selected_wave_index) with
    | Empty _ -> ()
    | Divider { style; _ } -> style.style <- cycle_fg_colour style.style
    | Clock { style; _ } -> style.style <- cycle_fg_colour style.style
    | Binary { style; _ } -> style.style <- cycle_fg_colour style.style
    | Data { style; _ } -> style.style <- cycle_fg_colour style.style
  ;;

  let toggle_bold (t : t) =
    let selected_wave_index = t.cfg.selected_signal in
    let toggle_bold { Style.bold; fg; bg } = { Style.bold = not bold; fg; bg } in
    match t.currently_rendered.actual_wave.(selected_wave_index) with
    | Empty _ -> ()
    | Divider { style; _ } -> style.style <- toggle_bold style.style
    | Clock { style; _ } -> style.style <- toggle_bold style.style
    | Binary { style; _ } -> style.style <- toggle_bold style.style
    | Data { style; _ } -> style.style <- toggle_bold style.style
  ;;

  let iter_nodes ~f t =
    let rec loop ~depth ~rev_path node =
      Map.iteri node.children ~f:(fun ~key ~data:node ->
        let module_name = String.concat ~sep:"$" (List.rev (key :: rev_path)) in
        f ~depth ~module_name node;
        loop ~rev_path:(key :: rev_path) ~depth:(depth + 1) node)
    in
    loop ~depth:0 ~rev_path:[] t.root
  ;;

  let iter_waves ~f t =
    let rec loop ~depth ~rev_path node =
      if node.visible
      then (
        Map.iteri node.children ~f:(fun ~key ~data:node ->
          let module_name = String.concat ~sep:"$" (List.rev (key :: rev_path)) in
          f ~depth (Wave.Empty { name = module_name });
          loop ~rev_path:(key :: rev_path) ~depth:(depth + 1) node);
        List.iter ~f:(fun node -> f ~depth node) node.signals)
    in
    loop ~depth:0 ~rev_path:[] t.root
  ;;

  let set_currently_rendered t =
    let actual_wave = ref [] in
    let for_rendering = ref [] in
    let () =
      iter_waves t ~f:(fun ~depth w ->
        actual_wave := w :: !actual_wave;
        let padding = String.init (depth * 2) ~f:(fun _ -> ' ') in
        let name = String.split ~on:'$' (Wave.get_name w) |> List.last_exn in
        let name =
          match w with
          | Empty _ -> "<" ^ name ^ ">"
          | _ -> name
        in
        for_rendering := Wave.set_name w (padding ^ name) :: !for_rendering)
    in
    let for_rendering = Array.of_list_rev !for_rendering in
    let actual_wave = Array.of_list_rev !actual_wave in
    t.currently_rendered <- { for_rendering; actual_wave }
  ;;

  let of_waves (waves : Data.t Waves.t) =
    let init = empty_node in
    let ret =
      Array.fold waves.waves ~init ~f:(fun acc wave ->
        let path = String.split ~on:'$' (Wave.get_name wave) in
        update ~path ~wave acc)
    in
    ret.visible <- true;
    let t =
      { cfg = waves.cfg
      ; cursors = Cursors.create ()
      ; root = put_back_into_display_order ret
      ; currently_rendered = { actual_wave = [||]; for_rendering = [||] }
      }
    in
    set_currently_rendered t;
    t
  ;;

  let toggle_module t name =
    let rec loop path (node : node) =
      match path with
      | [] -> node.visible <- not node.visible
      | hd :: tl -> loop tl (Map.find_exn node.children hd)
    in
    (try loop (String.split name ~on:'$') t.root with
     | Not_found_s _ -> raise_s [%message "Cannot resolve key in module" name]);
    set_currently_rendered t
  ;;

  let find_actual_wave t i = t.currently_rendered.actual_wave.(i)

  let get_currently_rendered_waves t =
    let currently_rendered = t.currently_rendered.for_rendering in
    { Waves.cfg = t.cfg; waves = currently_rendered }
  ;;

  let change_selected_signal_index ~delta t =
    let c = t.currently_rendered in
    let next =
      t.cfg.selected_signal + delta
      |> Int.min (Array.length c.for_rendering - 1)
      |> Int.max 0
    in
    t.cfg.selected_signal <- next;
    next
  ;;

  let toggle_selected_module_if_present t =
    match t.currently_rendered.actual_wave.(t.cfg.selected_signal) with
    | Empty { name } ->
      toggle_module t name;
      true
    | Clock _ | Divider _ | Data _ | Binary _ -> false
  ;;
end