origen_doc_helpers 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/config/boot.rb +19 -0
- data/config/version.rb +1 -1
- data/lib/origen_doc_helpers.rb +21 -1
- data/lib/origen_doc_helpers/flow_page_generator.rb +110 -0
- data/lib/{helpers.rb → origen_doc_helpers/helpers.rb} +0 -0
- data/lib/origen_doc_helpers/model_page_generator.rb +151 -0
- data/templates/flow_index.md.erb +19 -0
- data/templates/flow_page.md.erb +4 -0
- data/templates/model_index.md.erb +24 -0
- data/templates/model_page.md.erb +125 -0
- data/templates/shared/_register.html.erb +51 -7
- data/templates/shared/_searchable.html.erb +1 -1
- data/templates/shared/test/_flow.md.erb +3 -230
- data/templates/web/helpers.md.erb +25 -0
- data/templates/web/{examples → helpers}/disqus.md.erb +3 -3
- data/templates/web/helpers/flow.md.erb +113 -0
- data/templates/web/helpers/model.md.erb +81 -0
- data/templates/web/{examples → helpers}/register.md.erb +5 -5
- data/templates/web/{examples → helpers}/searchable/intro.md.erb +4 -4
- data/templates/web/{examples → helpers}/searchable/page2.md.erb +0 -0
- data/templates/web/{examples → helpers}/searchable/topic1/item1.md.erb +0 -0
- data/templates/web/{examples → helpers}/searchable/topic1/item2.html.erb +0 -0
- data/templates/web/{examples → helpers}/spec.md.erb_NOT_WORKING +2 -2
- data/templates/web/{examples → helpers}/yammer.md.erb +1 -1
- data/templates/web/index.md.erb +1 -1
- data/templates/web/layouts/_doc.html.erb +2 -2
- data/templates/web/layouts/{_examples.html.erb → _helpers.html.erb} +1 -1
- data/templates/web/partials/_navbar.html.erb +1 -1
- metadata +27 -26
- data/config/development.rb +0 -16
- data/config/environment.rb +0 -32
- data/lib/origen_doc_helpers/doc_interface.rb +0 -74
- data/program/_func.rb +0 -12
- data/program/_hvst.rb +0 -12
- data/program/_para.rb +0 -26
- data/program/probe_1.rb +0 -7
- data/templates/web/examples.md.erb +0 -20
- data/templates/web/examples/test/flow.md.erb +0 -35
data/program/_func.rb
DELETED
@@ -1,12 +0,0 @@
|
|
1
|
-
# Functional test of the Vreg
|
2
|
-
Flow.create do
|
3
|
-
# This test verifies that the following things work:
|
4
|
-
#
|
5
|
-
# * The vreg can be disabled
|
6
|
-
# * The trim register can be written to and read from
|
7
|
-
func :vreg_functional, vdd: :min, bin: 101
|
8
|
-
|
9
|
-
func :vreg_functional, vdd: :max, bin: 101, continue: true
|
10
|
-
|
11
|
-
import "hvst"
|
12
|
-
end
|
data/program/_hvst.rb
DELETED
@@ -1,12 +0,0 @@
|
|
1
|
-
# HVST
|
2
|
-
Flow.create do
|
3
|
-
# Check if this device has already had the Vreg HVST
|
4
|
-
func :rd_vreg_hvst_passcode, bin: 50, vdd: :nom, id: :vreg_hvst_done
|
5
|
-
|
6
|
-
# Apply HVST to the vreg module
|
7
|
-
func :vreg_hvst, bin: 101, hv: 10.V, vdd: :max, unless_passed: :vreg_hvst_done
|
8
|
-
|
9
|
-
# Program a passcode to the device to record that the HVST
|
10
|
-
# has been applied
|
11
|
-
func :pgm_vreg_hvst_passcode, bin: 51, vdd: :nom, unless_passed: :vreg_hvst_done
|
12
|
-
end
|
data/program/_para.rb
DELETED
@@ -1,26 +0,0 @@
|
|
1
|
-
# Parametric flow
|
2
|
-
#
|
3
|
-
# Blah blah, this is marked down:
|
4
|
-
#
|
5
|
-
# * blah
|
6
|
-
# * blah
|
7
|
-
Flow.create do
|
8
|
-
# Measure the output of the vreg under no load, this is a simple
|
9
|
-
# test to catch any gross defects that prevent the vreg from working
|
10
|
-
#
|
11
|
-
# Blah blah, this is marked down:
|
12
|
-
#
|
13
|
-
# * blah
|
14
|
-
# * blah
|
15
|
-
pp "No load tests" do
|
16
|
-
para :vreg_meas, bin: 105, lo: 1.12, hi: 1.34
|
17
|
-
|
18
|
-
para :vreg_meas, bin: 105, cz: true, if_enable: "vreg_cz"
|
19
|
-
end
|
20
|
-
|
21
|
-
# Measure the output of the vreg under the given load, this is approximately
|
22
|
-
# equivalent to 1.5x the maximum load anticipated in a customer application.
|
23
|
-
para :vreg_meas, vdd: :min, bin: 105, load: 5.mA, lo: 1.10, hi: 1.34
|
24
|
-
|
25
|
-
para :vreg_meas, vdd: :max, bin: 105, load: 5.mA, lo: 1.12, hi: 1.34
|
26
|
-
end
|
data/program/probe_1.rb
DELETED
@@ -1,20 +0,0 @@
|
|
1
|
-
% render "layouts/basic.html", :tab => :examples do
|
2
|
-
|
3
|
-
# Examples
|
4
|
-
|
5
|
-
The available helpers are split by engineering function below, click the
|
6
|
-
helper of interest to see a live example of it and the application code
|
7
|
-
that should be used to generate it.
|
8
|
-
|
9
|
-
### General
|
10
|
-
|
11
|
-
* [Searchable Documents](<%= path "/examples/searchable/intro" %>)
|
12
|
-
* [Register Descriptions](<%= path "/examples/register" %>)
|
13
|
-
* [Yammer Comments](<%= path "/examples/yammer" %>)
|
14
|
-
* [Disqus Comments](<%= path "/examples/disqus" %>)
|
15
|
-
|
16
|
-
### Test Engineering
|
17
|
-
|
18
|
-
* [Test Flow](<%= path "/examples/test/flow" %>)
|
19
|
-
|
20
|
-
% end
|
@@ -1,35 +0,0 @@
|
|
1
|
-
% render "../../layouts/examples.html" do
|
2
|
-
|
3
|
-
# Test Flow
|
4
|
-
|
5
|
-
Documentation of an Origen-generated test program can be created as follows (requires a
|
6
|
-
documentation interface to be setup):
|
7
|
-
|
8
|
-
~~~eruby
|
9
|
-
<%= "%" %> prog = OrigenTesters::Doc.generate_program_model("program/probe_1.rb", :target => "default")
|
10
|
-
|
11
|
-
<%= "<" + "%= render \"doc_helpers/test/flow.md\", :heading => \"Probe 1\", :program => prog, :flow => :probe_1_flow %" + ">" %>
|
12
|
-
~~~
|
13
|
-
|
14
|
-
The test flow helper takes the following required options:
|
15
|
-
|
16
|
-
* **heading** - The page heading, generally the name of the flow
|
17
|
-
* **program** - Supply a pre-generated program model
|
18
|
-
* **flow(s)** - The name of the flow(s) to document, supply multiple in an array
|
19
|
-
|
20
|
-
Additionally these options are available to customize the output:
|
21
|
-
|
22
|
-
* **link_to_pattern_docs** - Set this to <code>true</code> to generate links to documentation of the patterns
|
23
|
-
in place of the pattern name. Pattern docs should be placed in <code>templates/web/patterns</code> and the
|
24
|
-
files should be called \<pattern_name\>.md
|
25
|
-
* **context** - Supply an execution context to document only the test where the context is true. For example to
|
26
|
-
document the tests that will run when job is "P1"is set
|
27
|
-
supply <code>{ :job => "P1" }</code>
|
28
|
-
|
29
|
-
Here is a live example:
|
30
|
-
|
31
|
-
% prog = OrigenTesters::Doc.generate_program_model("program/probe_1.rb", :target => "debug")
|
32
|
-
|
33
|
-
<%= render "templates/shared/test/flow.md", :heading => "Probe 1", :program => prog, :flow => :probe_1_flow %>
|
34
|
-
|
35
|
-
% end
|