;----------------------------------------------------------------------
;--------------------
-power_polarising_init
+power_polarising_init @
clr_f settling
pin_h p0_booster_pwm
return
;--------------------
-power_polarising_begin
+power_polarising_begin @
pin_vl p0_booster_pwm
bc_f INTCON, TMR0IE ; disables NMRA interrupt
bs_f flags, flags_polarising
return
;--------------------
-power_polarising_settling
+power_polarising_nonetodo @
; idempotent
+ bt_f_if0 flags, flags_polarising
+ return
tst_f_ifnz settling
return
mov_lw settling_timeout / tick_us
return
;--------------------
-power_polarising_tick
+power_polarising_tick @
tst_f_ifnz settling
dec_f_ifnz settling ; decrement if not zero
return ; return if not dec'd, or if decrement didn't make zero
; settle timeout complete:
bc_f flags, flags_polarising
+ pin_vh p0_booster_pwm
call nmra_restartmessage
bs_f INTCON, TMR0IE ; reenables NMRA interrupt
goto i2c_consider_restartread
;
; FAULTS AND POWER:
;
-; Shutdown CDU Timeout User Fault Next states
+; Shutdown CDU Time User Fault Next states and action when
+; fault timeout ON OFF
+;
+; Off shutdown off none off On
+; On power-up on none off Stopping,FAULT Off
+; Stopping shutdown on 500ms 50% 1/100ms Retry
+; Retry power-up off 50ms off Persists Off,FIXED Off
+; Persists shutdown off 90ms on Retry Off
;
-; Off shutdown off none off *On (or +Fault)
-; On power-up on none off Fault, or *Off
-; Stopping shutdown off 500ms 50% 1/100ms ->Retry
-; Retry power-up off 50ms off ->Off, or Persists
-; Persists shutdown off 90ms on ->Retry
-; * = when host instructs
-; + = lost race, only
-; -> = after timeout
+; (no notation: event ignored)
;
; shutdown LAT stop_wait retry_wait
;
-; Off H (shutdown) stopped stopped
-; On L (power-up) stopped stopped
+; Off H (shutdown) 0 0
+; On L (power-up) 0 0
; Stopping H (shutdown) before Retry for LED flash
-; Retry L (power-up) stopped before Off
-; Persists H (shutdown) stopped before retry
+; Retry L (power-up) 0 before Off
+; Persists H (shutdown) 0 before retry
;
; (uses tickdiv) (uses tick)
;--------------------
-power_fault_init
+power_fault_init @
bs_f INTCON2, INTEDG1 ; rising edge
bc_f INTCON3, INT1IP
bc_f INTCON3, INT1IF
; now we are Off
return
+command_power_section code 0x2080
;--------------------
-command_power
- bra_nc command_power_off
- ; command is ON:
-
+command_power_on @
; Off -> On; noop in other states
pinlat_ifl p0_booster_shutdown
return ; On or Retry
; must be Off:
pin_vl p0_booster_shutdown
+ Dl 0x81
goto cdu_on
;----------
-command_power_off
-; On -> Off; noop in other states
- pinlat_ifh p0_booster_shutdown
- return ; Off, Stopping or Persists
- ; might be On or Retry:
-
- tst_f_ifnz retry_wait
- return ; that deals with Retry
- ; must be On:
+command_power_off @
+; On, Retry, Persists -> Off; noop in Off or Stopping
+ tst_f_ifnz stop_wait
+ return ; that deals with Stopping
+ ; must be On, Off, Retry or Persists:
+ ; (it's harmless to do this if we were already Off)
power_off_now
+ clr_f retry_wait
+ pin_vh p0_booster_userfault
pin_vh p0_booster_shutdown
goto cdu_off
+code2 code
;--------------------
-power_fault_intrl
+power_fault_intrl @
bt_f_if0 INTCON3, INT1IF
return
; we have a fault:
bc_f INTCON3, INT1IF
- rcall power_off_now
- mov_fw retry_wait
- bra_z power_fault_stop ; we were Off or On, goto Stopping
- ; must be Stopping, Retry or Persists:
+ pinlat_ifh p0_booster_shutdown
+ bra faultintrl_noop
+ ; Off, Stopping or Persists - must have lost the race
+ ; or flapped while we faffed. Well, never mind, it's
+ ; off now and we're taking care of it. (If the host
+ ; caused Off by OFF they can at worst send an OFF and
+ ; immediate ON in about 2ms, so worst-case duty cycle
+ ; for a short (if the host is perversely timed) is
+ ; (our interrupt latency) / 2ms
+ ; and if they ever don't manage to get the OFF through
+ ; in time then we go into Stopping.)
+ ; must be On or Retry:
- tst_f_ifnz stop_wait
- bra power_fault_stop ; we were already Stopping; restart timer
- ; might be Retry or Persists, goto Persists (restarting any timer):
+ pin_vh p0_booster_shutdown
+ tst_f_ifnz retry_wait
+ bra fault_persists ; that deals with Retry
+ ; must be On:
- mov_lw persist_timeout / tick_us
- mov_wf retry_wait
- pin_vl p0_booster_userfault
- return
+ mov_lw b'00000111'
+ call serial_addbyte
-;-----
-power_fault_stop
mov_lw stop_timeout / tickdiv_us
mov_wf stop_wait
pin_vl p0_booster_userfault
- mov_lw b'00000111'
- call serial_addbyte
rcall power_stop_doflash
intrl_handled_nostack
+;-----
+fault_persists ; Retry -> Persists (booster was shut down just a moment ago)
+ mov_lw persist_timeout / tick_us
+ mov_wf retry_wait
+ pin_vl p0_booster_userfault
+faultintrl_noop
+ intrl_handled_nostack
+
;--------------------
-power_fault_tick
+power_fault_tick @
tst_f_ifnz retry_wait
dec_f_ifnz retry_wait
return
; we were in Stopping, Retry or Persists:
tst_f_ifnz stop_wait
- bra power_stop_doflash ; that was Stopping, just flash the LED
+ bra power_stop_doflash ; that deals with Stopping (just flash)
; must be Retry or Persists:
pinlat_ifh p0_booster_shutdown
return
;--------------------
-power_fault_tickdiv
+power_fault_tickdiv @
tst_f_ifnz stop_wait
dec_f_ifnz stop_wait
return
; stop_wait was running but has just reached zero;
; we were in Stopping, now we can Retry:
+ call cdu_off
power_retry
mov_lw retry_timeout / tickdiv_us
mov_wf retry_wait
return
;--------------------
-power_panichook
+power_panichook @
pin_vh p0_booster_shutdown
pin_vl p0_booster_pwm
pin_vh p0_booster_userfault