Skip to content

Commit 799dfb0

Browse files
committed
Document all components
1 parent 5e03c1f commit 799dfb0

File tree

2 files changed

+32
-5
lines changed

2 files changed

+32
-5
lines changed

docs/src/types.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,11 @@ CurrentModule = WinchControllers
66

77
## Control components
88
```@docs
9+
Integrator
10+
UnitDelay
11+
RateLimiter
912
Mixer_2CH
13+
Mixer_3CH
1014
```
1115

1216
## Controller and settings

src/components.jl

Lines changed: 28 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,15 @@ Components:
1010
- Mixer_3CH three channel mixer
1111
"""
1212

13-
# Discrete integrator with external reset
13+
"""
14+
mutable struct Integrator
15+
16+
Discrete integrator with external reset.
17+
18+
# Fields
19+
20+
$(TYPEDFIELDS)
21+
"""
1422
@with_kw mutable struct Integrator @deftype Float64
1523
dt # timestep [s]
1624
i = 1.0 # integration constant
@@ -37,7 +45,15 @@ function on_timer(int::Integrator)
3745
nothing
3846
end
3947

40-
# UnitDelay, delay the input signal by one time step.
48+
"""
49+
mutable struct UnitDelay
50+
51+
UnitDelay, delay the input signal by one time step.
52+
53+
# Fields
54+
55+
$(TYPEDFIELDS)
56+
"""
4157
@with_kw mutable struct UnitDelay @deftype Float64
4258
last_output = 0
4359
last_input = 0
@@ -57,9 +73,16 @@ function reset(ud::UnitDelay)
5773
ud.last_output = 0.0
5874
end
5975

60-
# RateLimiter
61-
# Limit the rate of change of the output signal (return value of calc_output) to ± limit.
62-
# Unit of limit: 1/s
76+
"""
77+
mutable struct RateLimiter
78+
79+
Limit the rate of change of the output signal (return value of calc_output) to ± limit.
80+
Unit of limit: 1/s
81+
82+
# Fields
83+
84+
$(TYPEDFIELDS)
85+
"""
6386
@with_kw mutable struct RateLimiter @deftype Float64
6487
dt = 0.05
6588
limit = 1

0 commit comments

Comments
 (0)