SCCD_execute.alc 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671
  1. include "primitives.alh"
  2. include "modelling.alh"
  3. include "object_operations.alh"
  4. include "utils.alh"
  5. include "random.alh"
  6. include "library.alh"
  7. Void function print_states(model : Element, data : Element):
  8. Element classes
  9. Element states
  10. Element class
  11. String state
  12. log("Current states:")
  13. classes = set_copy(data["classes"])
  14. while (read_nr_out(classes) > 0):
  15. class = set_pop(classes)
  16. log(string_join(string_join(string_join(" ", class["ID"]), " : "), read_attribute(model, class["type"], "name")))
  17. log(" Attributes: " + dict_to_string(class["attributes"]))
  18. states = set_copy(class["states"])
  19. log(" States:")
  20. while (read_nr_out(states) > 0):
  21. state = set_pop(states)
  22. log(string_join(" ", read_attribute(model, state, "name")))
  23. return!
  24. Element function filter(model : Element, set : Element, attribute_name : String, attribute_value : Element):
  25. Element keys
  26. String key
  27. Element result
  28. result = create_node()
  29. while (read_nr_out(set) > 0):
  30. key = set_pop(set)
  31. if (value_eq(read_attribute(model, key, attribute_name), attribute_value)):
  32. set_add(result, key)
  33. return result!
  34. Element function filter_exists(model : Element, set : Element, attribute_name : String):
  35. Element keys
  36. String key
  37. Element result
  38. result = create_node()
  39. while (read_nr_out(set) > 0):
  40. key = set_pop(set)
  41. if (element_neq(read_attribute(model, key, attribute_name), read_root())):
  42. set_add(result, key)
  43. return result!
  44. Element function expand_current_state(model : Element, state : String, class_data : Element):
  45. // Find the hierarchy of all current states, and select those that contain the currently selected state
  46. Element result
  47. Element current_states
  48. result = create_node()
  49. current_states = set_copy(class_data["states"])
  50. Element hierarchy
  51. String deep_state
  52. while (read_nr_out(current_states) > 0):
  53. deep_state = set_pop(current_states)
  54. hierarchy = find_hierarchy(model, deep_state)
  55. // Got the hierarchy of one of the states
  56. if (set_in(hierarchy, state)):
  57. // This hierarchy contains the root state we are checking for, so add to set
  58. set_add(result, deep_state)
  59. return result!
  60. Element function expand_initial_state(model : Element, state : String, class_data : Element):
  61. String t
  62. t = read_type(model, state)
  63. if (t == "SCCD/CompositeState"):
  64. // Recurse further in the composite
  65. return expand_composite_state(model, state, class_data)!
  66. elif (t == "SCCD/ParallelState"):
  67. // Split up all components
  68. return expand_parallel_state(model, state, class_data)!
  69. elif (t == "SCCD/HistoryState"):
  70. // Reset the history
  71. // This is not really an initial state, but it is called in exactly the same places
  72. return class_data["history"][state]!
  73. else:
  74. // Probably just an atomic, so return this one only
  75. Element result
  76. result = create_node()
  77. set_add(result, state)
  78. return result!
  79. Element function expand_composite_state(model : Element, composite_state : String, class_data : Element):
  80. // Resolve all initial states from a single composite state
  81. String initial
  82. // Fetch the initial state
  83. initial = set_pop(filter(model, allAssociationDestinations(model, composite_state, "SCCD/composite_children"), "isInitial", True))
  84. // Expand the initial state, depending on what it is
  85. return expand_initial_state(model, initial, class_data)!
  86. Element function expand_parallel_state(model : Element, parallel_state : String, class_data : Element):
  87. // Resolve all initial states from a single parallel state
  88. Element children
  89. Element result
  90. Element expanded_children
  91. children = allAssociationDestinations(model, parallel_state, "SCCD/parallel_children")
  92. result = create_node()
  93. while (read_nr_out(children) > 0):
  94. set_merge(result, expand_initial_state(model, set_pop(children), class_data))
  95. return result!
  96. Void function delete_class(model : Element, data : Element, identifier : String):
  97. // Stop a specific class instance, with attached statechart, from executing
  98. dict_delete(data["classes"], identifier)
  99. Void function start_class(model : Element, data : Element, class : String, identifier : String, parameters : Element):
  100. // Start up the class and assign its initial state to it
  101. // Create the data structure for a running class
  102. Element class_handle
  103. class_handle = create_node()
  104. dict_add(class_handle, "type", class)
  105. dict_add(class_handle, "ID", identifier)
  106. dict_add(class_handle, "timers", create_node())
  107. // Add the current state of the class
  108. String initial_state
  109. // Should only be one behaviour linked to it!
  110. initial_state = set_pop(allAssociationDestinations(model, class, "SCCD/behaviour"))
  111. dict_add(class_handle, "states", expand_initial_state(model, initial_state, class_handle))
  112. // Initialize history for all composite states
  113. Element history
  114. Element cstates
  115. String cstate
  116. history = create_node()
  117. dict_add(class_handle, "history", history)
  118. cstates = allInstances(model, "SCCD/CompositeState")
  119. while (read_nr_out(cstates) > 0):
  120. cstate = set_pop(cstates)
  121. dict_add(history, cstate, expand_initial_state(model, cstate, class_handle))
  122. // Add all attributes
  123. Element attributes
  124. attributes = create_node()
  125. Element attrs
  126. attrs = allAssociationDestinations(model, class, "SCCD/class_attributes")
  127. while (read_nr_out(attrs) > 0):
  128. dict_add(attributes, read_attribute(model, set_pop(attrs), "name"), read_root())
  129. dict_add(class_handle, "attributes", attributes)
  130. // Invoke constructor
  131. Element constructor
  132. constructor = read_attribute(model, class, "constructor_body")
  133. if (element_neq(constructor, read_root())):
  134. // Constructor, so execute
  135. constructor = get_func_AL_model(import_node(constructor))
  136. constructor(attributes, parameters)
  137. // Execute all entry actions
  138. Element init
  139. init = create_node()
  140. set_add(init, "")
  141. // Initial state before initialization is the set with an empty hierarchy
  142. // Empty set would not find any difference between the source and target
  143. execute_actions(model, init, set_copy(class_handle["states"]), attributes)
  144. dict_add(data["classes"], class_handle["ID"], class_handle)
  145. return!
  146. Element function get_enabled_transitions(model : Element, state : String, data : Element, class : String):
  147. // Returns all enabled transitions
  148. Element result
  149. Element to_filter
  150. String attr
  151. String transition
  152. Element cond
  153. String evt_name
  154. Element evt
  155. Element events
  156. Element event_names
  157. Element event_parameters
  158. result = create_node()
  159. to_filter = allOutgoingAssociationInstances(model, state, "SCCD/transition")
  160. event_names = create_node()
  161. event_parameters = create_node()
  162. events = set_copy(data["events"])
  163. while (read_nr_out(events) > 0):
  164. evt = set_pop(events)
  165. evt_name = list_read(evt, 0)
  166. if (bool_not(set_in(event_names, evt_name))):
  167. // Not yet registered the event
  168. set_add(event_names, evt_name)
  169. dict_add(event_parameters, evt_name, create_node())
  170. // Add event parameters
  171. set_add(event_parameters[evt_name], list_read(evt, 1))
  172. while (read_nr_out(to_filter) > 0):
  173. transition = set_pop(to_filter)
  174. // Check event
  175. attr = read_attribute(model, transition, "event")
  176. if (bool_not(bool_or(element_eq(attr, read_root()), set_in(event_names, attr)))):
  177. // At least one enabled event is found
  178. continue!
  179. // Check after
  180. // Only an after if there was no event!
  181. if (bool_and(element_eq(attr, read_root()), read_attribute(model, transition, "after"))):
  182. if (dict_in(data["classes"][class]["timers"], transition)):
  183. // Registered timer already, let's check if it has expired
  184. if (float_gt(data["classes"][class]["timers"][transition], time())):
  185. // Not enabled yet
  186. continue!
  187. else:
  188. // Not registered even, so not enabled either
  189. continue!
  190. // Check condition, but depends on whether there was an event or not
  191. cond = read_attribute(model, transition, "cond")
  192. if (element_neq(cond, read_root())):
  193. // Got a condition, so resolve
  194. cond = get_func_AL_model(import_node(cond))
  195. if (element_neq(attr, read_root())):
  196. // We have an event to take into account!
  197. Element params
  198. Element param
  199. params = set_copy(event_parameters[attr])
  200. while (read_nr_out(params) > 0):
  201. param = set_pop(params)
  202. if (element_neq(cond, read_root())):
  203. // Got a condition to check first
  204. if (bool_not(cond(data["classes"][class]["attributes"], param))):
  205. // Condition failed, so skip
  206. continue!
  207. // Fine to add this one with the specified parameters
  208. set_add(result, create_tuple(transition, param))
  209. else:
  210. // No event to think about, just add the transition
  211. if (element_neq(cond, read_root())):
  212. // Check the condition first
  213. if (bool_not(cond(data["classes"][class]["attributes"], read_root()))):
  214. // Condition false, so skip
  215. continue!
  216. // Fine to add this one without event parameters (no event)
  217. set_add(result, create_tuple(transition, read_root()))
  218. return result!
  219. Void function execute_actions(model : Element, source_states : Element, target_states : Element, class_data : Element):
  220. Element actions
  221. actions = get_actions_to_execute(model, source_states, target_states, class_data)
  222. while (read_nr_out(actions) > 0):
  223. Element action
  224. action = list_pop(actions, 0)
  225. action(class_data["attributes"])
  226. return!
  227. Void function process_raised_event(model : Element, event : Element, parameter_action : Element, data : Element):
  228. String scope
  229. scope = read_attribute(model, event, "scope")
  230. if (scope == "cd"):
  231. // Is an event for us internally, so don't append
  232. // Instead, we process it directly
  233. String operation
  234. operation = read_attribute(model, event, "event")
  235. if (operation == "create_instance"):
  236. // Start up a new class of the desired type
  237. // Parameters of this call:
  238. // class -- type of the class to instantiate
  239. // identifier -- name of this instance, for future reference
  240. // parameters -- parameters for constructor
  241. String class
  242. String identifier
  243. Element parameters
  244. class = set_pop(filter(model, allInstances(model, "SCCD/Class"), "name", list_read(parameter_action, 0)))
  245. identifier = list_read(parameter_action, 1)
  246. parameters = list_read(parameter_action, 2)
  247. start_class(model, data, class, identifier, parameters)
  248. elif (operation == "delete_instance"):
  249. // Delete the requested class
  250. String identifier
  251. identifier = list_read(parameter_action, 0)
  252. delete_class(model, data, identifier)
  253. else:
  254. set_add(data["events"], create_tuple(read_attribute(model, event, "event"), parameter_action))
  255. return !
  256. Element function execute_transition(model : Element, data : Element, class : String, transition_tuple : Element):
  257. // Execute the script (if any)
  258. Element script
  259. String transition
  260. Element event_parameter
  261. transition = list_read(transition_tuple, 0)
  262. event_parameter = list_read(transition_tuple, 1)
  263. script = read_attribute(model, transition, "script")
  264. if (element_neq(script, read_root())):
  265. script = get_func_AL_model(import_node(script))
  266. script(data["classes"][class]["attributes"], event_parameter)
  267. // Raise events (if any)
  268. Element events
  269. String event
  270. events = allAssociationDestinations(model, transition, "SCCD/transition_raises")
  271. while (read_nr_out(events) > 0):
  272. event = set_pop(events)
  273. Element parameter_action
  274. parameter_action = read_attribute(model, event, "parameter")
  275. if (element_neq(parameter_action, read_root())):
  276. // Got a parameter to evaluate
  277. parameter_action = get_func_AL_model(import_node(parameter_action))
  278. parameter_action = parameter_action(data["classes"][class]["attributes"], event_parameter)
  279. process_raised_event(model, event, parameter_action, data)
  280. // Find new set of states
  281. Element target_states
  282. Element source_states
  283. source_states = expand_current_state(model, readAssociationSource(model, transition), data["classes"][class])
  284. target_states = expand_initial_state(model, readAssociationDestination(model, transition), data["classes"][class])
  285. execute_actions(model, source_states, target_states, data["classes"][class])
  286. return target_states!
  287. Boolean function step_class(model : Element, data : Element, class : String):
  288. // Find enabled transitions in a class and execute it, updating the state
  289. // Iterate over all current states, searching for enabled transitions
  290. // Search for enabled transitions in higher levels as well!
  291. Element states
  292. Element new_states
  293. String state
  294. Element transitions
  295. String transition
  296. Boolean transitioned
  297. Element hierarchy
  298. String current_state
  299. Boolean found
  300. states = set_copy(data["classes"][class]["states"])
  301. new_states = create_node()
  302. transitioned = False
  303. while (read_nr_out(states) > 0):
  304. state = set_pop(states)
  305. found = False
  306. // Loop over the hierarchy of this state and try to apply transitions
  307. hierarchy = find_hierarchy(model, state)
  308. while (read_nr_out(hierarchy) > 0):
  309. current_state = list_pop(hierarchy, 0)
  310. transitions = get_enabled_transitions(model, current_state, data, class)
  311. if (read_nr_out(transitions) > 0):
  312. // Found an enabled transition, so store that one
  313. transition = random_choice(transitions)
  314. // Execute transition
  315. set_merge(new_states, execute_transition(model, data, class, transition))
  316. // When leaving an orthogonal component, we must also pop all related states that might be processed in the future!
  317. Element leaving
  318. leaving = expand_current_state(model, current_state, data["classes"][class])
  319. set_difference(states, leaving)
  320. transitioned = True
  321. found = True
  322. break!
  323. if (bool_not(found)):
  324. // Nothing found, so stay in the current state
  325. set_add(new_states, state)
  326. // Update states
  327. dict_overwrite(data["classes"][class], "states", new_states)
  328. reschedule_timeouts(model, data, class)
  329. return transitioned!
  330. Void function reschedule_timeouts(model : Element, data : Element, class : String):
  331. Element timed_transitions
  332. Element old_timed_transitions
  333. String transition
  334. Element states
  335. String state
  336. timed_transitions = create_node()
  337. states = set_copy(data["classes"][class]["states"])
  338. // Collect all timed transitions that are currently active
  339. while (read_nr_out(states) > 0):
  340. state = set_pop(states)
  341. // NOTE this set_merge does not eliminate duplicates, though this should happen later on when adding the timer (see other NOTE)
  342. set_merge(timed_transitions, filter_exists(model, allOutgoingAssociationInstances(model, state, "SCCD/transition"), "after"))
  343. // Remove timers that no longer exist
  344. old_timed_transitions = dict_keys(data["classes"][class]["timers"])
  345. while (read_nr_out(old_timed_transitions) > 0):
  346. transition = set_pop(old_timed_transitions)
  347. if (bool_not(set_in(timed_transitions, transition))):
  348. // Transition is no longer scheduled for any state, so remove
  349. dict_delete(data["classes"][class]["timers"], transition)
  350. // Schedule timers that are not already scheduled
  351. while (read_nr_out(timed_transitions) > 0):
  352. transition = set_pop(timed_transitions)
  353. // NOTE Normally, a timer will not be added twice here, as the previous occurence will already find it
  354. if (bool_not(dict_in(data["classes"][class]["timers"], transition))):
  355. // Not yet scheduled this transition: do so now
  356. Element after
  357. Float after_duration
  358. after = read_attribute(model, transition, "after")
  359. after = get_func_AL_model(import_node(after))
  360. after_duration = after(data["classes"][class]["attributes"])
  361. dict_add(data["classes"][class]["timers"], transition, float_addition(data["start_time"], after_duration))
  362. return !
  363. String function get_parent(model : Element, state : String):
  364. Element tmp_set
  365. tmp_set = allAssociationOrigins(model, state, "SCCD/composite_children")
  366. set_merge(tmp_set, allAssociationOrigins(model, state, "SCCD/parallel_children"))
  367. if (read_nr_out(tmp_set) > 0):
  368. return set_pop(tmp_set)!
  369. else:
  370. return ""!
  371. Element function find_hierarchy(model : Element, state : String):
  372. if (state == ""):
  373. return create_node()!
  374. else:
  375. Element result
  376. String parent
  377. parent = get_parent(model, state)
  378. // We have a parent, so take the parent list first
  379. result = find_hierarchy(model, parent)
  380. list_append(result, state)
  381. return result!
  382. Element function get_actions_to_execute(model : Element, source_states : Element, target_states : Element, class_data : Element):
  383. Element result
  384. result = create_node()
  385. source_states = set_copy(source_states)
  386. target_states = set_copy(target_states)
  387. // Add all exit and entry actions to the list of actions to execute
  388. // Do this by finding the common parent, and then doing all exit actions up to that node, and all entry actions up to the target_state
  389. // First, find the hierarchy!
  390. Element hierarchy_sources
  391. Element hierarchy_targets
  392. Element all_hierarchies
  393. hierarchy_sources = create_node()
  394. while (read_nr_out(source_states) > 0):
  395. set_add(hierarchy_sources, find_hierarchy(model, set_pop(source_states)))
  396. hierarchy_targets = create_node()
  397. while (read_nr_out(target_states) > 0):
  398. set_add(hierarchy_targets, find_hierarchy(model, set_pop(target_states)))
  399. all_hierarchies = set_copy(hierarchy_sources)
  400. set_merge(all_hierarchies, hierarchy_targets)
  401. // Difference these all lists, finding the first common entry
  402. Element iter_hierarchies
  403. Integer i
  404. String current
  405. Element hierarchy
  406. Boolean finished
  407. i = 0
  408. finished = False
  409. while (bool_not(finished)):
  410. // Check the i-th element in both and see if they are equal
  411. current = ""
  412. iter_hierarchies = set_copy(all_hierarchies)
  413. while (read_nr_out(iter_hierarchies) > 0):
  414. hierarchy = set_pop(iter_hierarchies)
  415. // Exhausted one of the lists
  416. if (i >= list_len(hierarchy)):
  417. finished = True
  418. break!
  419. // First entry, so read out value as reference
  420. if (current == ""):
  421. current = list_read(hierarchy, i)
  422. // Check with reference element
  423. if (bool_not(value_eq(list_read(hierarchy, i), current))):
  424. finished = True
  425. break!
  426. // i-th element equal for all hierarchies, so go to next element
  427. if (bool_not(finished)):
  428. i = i + 1
  429. // Found the first differing element at position i
  430. // All elements remaining in hierarchy_source are to be traversed in REVERSE order for the exit actions
  431. // All elements remaining in hierarchy_target are to be traversed in NORMAL order for the entry actions
  432. // This is not that simple either, as we need to consider that some actions might already have been added to the list...
  433. // Add hierarchy_sources actions
  434. String state
  435. Element visited
  436. Element action
  437. Element spliced_hierarchy
  438. Element hierarchy_source
  439. Element hierarchy_target
  440. visited = create_node()
  441. while (read_nr_out(hierarchy_sources) > 0):
  442. // Get one of these hierarchies
  443. hierarchy_source = set_pop(hierarchy_sources)
  444. spliced_hierarchy = list_splice(hierarchy_source, i, list_len(hierarchy_source))
  445. while (list_len(spliced_hierarchy) > 0):
  446. state = list_pop(spliced_hierarchy, list_len(spliced_hierarchy) - 1)
  447. if (set_in(visited, state)):
  448. // Already added this state, so don't bother
  449. continue!
  450. else:
  451. // New state, so prepend it to the list
  452. // Prepend, instead of append, as we want to do these operations in reverse order!
  453. // First check if there is any exit action at all
  454. action = read_attribute(model, state, "onExitScript")
  455. if (element_neq(action, read_root())):
  456. // An exit action is found!
  457. list_insert(result, get_func_AL_model(import_node(action)), 0)
  458. // Add this state as visited, even though there might not have been an associated action
  459. set_add(visited, state)
  460. // Also update the history of this state, which will be important if we have a history state later on
  461. if (read_type(model, state) == "SCCD/CompositeState"):
  462. dict_overwrite(class_data["history"], state, expand_current_state(model, state, class_data))
  463. // Add hierarchy_targets actions
  464. // Clear visited, just to be safe, though it should not matter
  465. visited = create_node()
  466. while (read_nr_out(hierarchy_targets) > 0):
  467. // Get one of these hierarchies
  468. hierarchy_target = set_pop(hierarchy_targets)
  469. spliced_hierarchy = list_splice(hierarchy_target, i, list_len(hierarchy_target))
  470. while (list_len(spliced_hierarchy) > 0):
  471. state = list_pop(spliced_hierarchy, list_len(spliced_hierarchy) - 1)
  472. if (set_in(visited, state)):
  473. // Already added this state, so don't bother
  474. continue!
  475. else:
  476. // New state, so append it to the list
  477. // Append, instead of prepend, as we want to do these operations in normal order!
  478. // First check if there is any entry action at all
  479. action = read_attribute(model, state, "onEntryScript")
  480. if (element_neq(action, read_root())):
  481. // An entry action is found!
  482. list_append(result, get_func_AL_model(import_node(action)))
  483. // Add this state as visited, even though there might not have been an associated action
  484. set_add(visited, state)
  485. return result!
  486. Float function step(model : Element, data : Element):
  487. // Step through all classes
  488. Element classes
  489. Element class
  490. Float t_min
  491. Float t_current
  492. Boolean transitioned
  493. Element keys
  494. String key
  495. t_min = time() + 99999.0
  496. classes = dict_keys(data["classes"])
  497. // TODO this should use simulated time or something
  498. dict_overwrite(data, "start_time", time())
  499. transitioned = False
  500. while (read_nr_out(classes) > 0):
  501. class = set_pop(classes)
  502. if (step_class(model, data, class)):
  503. transitioned = True
  504. if (bool_not(transitioned)):
  505. // Find minimum timer for this class, and store that
  506. keys = dict_keys(data["classes"][class]["timers"])
  507. while (read_nr_out(keys) > 0):
  508. key = set_pop(keys)
  509. t_current = data["classes"][class]["timers"][key]
  510. if (t_current < t_min):
  511. t_min = t_current
  512. if (transitioned):
  513. // Do another step, as we can transition
  514. return 0.0!
  515. else:
  516. return float_subtraction(t_min, data["start_time"])!
  517. Boolean function main(model : Element):
  518. // Executes the provided SCCD model
  519. Element data
  520. data = create_node()
  521. dict_add(data, "classes", create_node())
  522. // Prepare for input
  523. output("Ready for input!")
  524. // Find initial
  525. String default_class
  526. default_class = set_pop(filter(model, allInstances(model, "SCCD/Class"), "default", True))
  527. // Start up the default class
  528. start_class(model, data, default_class, "main", read_root())
  529. Float timeout
  530. Element interrupt
  531. timeout = 0.0
  532. while (True):
  533. print_states(model, data)
  534. interrupt = input_timeout(timeout)
  535. if (value_eq(interrupt, "#EXIT#")):
  536. // Stop execution
  537. return True!
  538. dict_overwrite(data, "events", create_node())
  539. if (element_neq(interrupt, read_root())):
  540. // Got interrupt
  541. log("Got event: " + cast_v2s(interrupt))
  542. set_add(data["events"], create_tuple(interrupt, read_root()))
  543. output("Processed event, ready for more!")
  544. timeout = step(model, data)
  545. if (read_nr_out(data["classes"]) == 0):
  546. // No more active classes left: terminate!
  547. log("Finished SCCD execution")
  548. break!
  549. log("Pausing for " + cast_v2s(timeout))
  550. // We should never get here!
  551. return False!