Module: Origen::Pins
- Defined in:
- lib/origen/pins.rb,
lib/origen/pins/pin.rb,
lib/origen/pins/pin_bank.rb,
lib/origen/pins/pin_clock.rb,
lib/origen/pins/power_pin.rb,
lib/origen/pins/ground_pin.rb,
lib/origen/pins/pin_common.rb,
lib/origen/pins/function_proxy.rb,
lib/origen/pins/pin_collection.rb
Overview
****** These notes refer to the pin model for the upcoming Origen V3 ******
Pin muxing and grouping on modern SoCs can be incredibly complex, Origen provides the following pin model architecture which should hopefully be sufficient to accurately model even the most complex of cases…
At the lowest layer are the pin objects, one per physical pin on a DUT. Each pin can store 1-bit of data with directional/state information for pattern generation, and additional metadata about the function of that pin in different modes of operation.
pin1 pin2 pin3 pin4
Package
Packages are the first layer of filtering that can be applied to pins, each pin has a package hash which contains information about which packages it is available in and any additional metadata associated with the pin when in that package - for example what package pin location it is.
pin1 pin2 pin3 pin4
packages: packages: packages: packages:
p1: p1: p1:
location: "A5" location: "B2" location: "B3"
p2: p2:
location: "A5" location: "B2"
Based on the above metadata these pins will work as follows within an SoC model:
$dut.package # => :none
$dut.pins.size # => 4
$dut.with_package :p1 do
$dut.pins.size # => 3 (No pin4)
$dut.pin(:pin1).location # => "A5"
$dut.has_pin?(:pin2) # => true
$dut.pin(:pin2).location # => "B2"
$dut.pin(:pin3).location # => "B3"
end
$dut.with_package :p2 do
$dut.pins.size # => 2 (No pin2 or pin4)
$dut.pin(:pin1).location # => "A5"
$dut.has_pin?(:pin2) # => false
$dut.pin(:pin2).location # => ERROR! The soc does not have pin 2 in the current configuration!
$dut.pin(:pin3).location # => "B2"
end
Aside from a physical package the packages attribute can also be used to model pseudo-packages like the subset of pins that are available in a probe or burn-in setup for example.
Pins availability can also be scoped by SoC mode and configuration…
Mode
The SoC mode attribute is inteded to be used to model top-level operating modes, such as functional test, RAMBIST, NVMBIST, etc. As such it is a top-level attribute similar to package attribute e.g. the SoC can be in RAMBIST mode within package P1, or it could be in User mode within package P2.
Configuration
The configuration scope should be used to model pin muxing that can occur independently of the SoC mode, for example in a functional test mode many different pin configurations may exist based on the IP modules that are enabled or disabled at runtime. Unlike the mode the configuration attribute can also be set at pin level as well. Any configuration attribute set on a pin will override the configuration attribute that is currently live on the SoC. This allows individual pins, or perhaps more commonly individual pin groups, to be set to a particular configuration independently of the other pins or the SoC.
The mode and configuration attributes at pin level are similar to those for the package, each pin also has a current_configuration attribute which will override the current_configuration attribute of the SoC when present. Each mode and configuration entry will be hash for storing meta data as required.
pin1 pin2 pin3 pin4
modes: modes: modes: modes:
user: user: user:
nvmbist: nvmbist:
configurations: configurations: configurations: configurations:
default: default: default: default:
alt0: alt1: alt0:
alt1:
Pin availability will be scoped accordingly when the mode and configuration of the SoC model is changed.
Although not shown in this example all of these filters are AND’d together, so a pin is only available if it is available in the current package, mode and configuration.
$dut.mode # => :none
$dut.configuration # => :none
$dut.pins.size # => 4
$dut.mode = :user
$dut.pins.size # => 3 (No pin4)
$dut.configuration = :alt0
$dut.pins.size # => 2 (No pin2 or pin4)
# Set the configuration of pin2 directly, the all_pins method will bypass the current scope
# when looking up a pin
$dut.all_pins(:pin2).configuration = :alt1
$dut.pins.size # => 3 (pin2 is now available to)
While not shown here an additional value of :all can be set when specifying the mode/configuration attributes of a given pin and which means that it will be available in all modes and/or configurations.
Functions
Each pin can have multiple functions associated with it which is intended to reflect the current signal that is mux’d onto it. Functions are scoped by mode and configuration (not package) and only one function can exist per mode/configuration combo.
Again the reserved mode/configuration name :all can be used here to reflect a function that will be common to all modes/configurations unless a more specific function has been declared. The top-level key of the functions hash is the mode, then the configuration and then the meta data associated with that selection:
pin1 pin2 pin3 pin4
functions: functions: functions: functions:
user: user: user:
all: default: default:
name: "TDI" name: "PORTA0" name: "PORTA1"
direction: :input direction: :io direction: :io
alt1: alt0:
name: "SPI0" name: "IIC0"
direction: :io direction: :output
alt1:
name: "SPI1"
direction: :io
nvmbist: nvmbist:
all: all:
name: "NVM_FAIL" name: "NVM_DONE"
direction: :output direction: :output
The function attributes returned will automatically scope to the current SoC state:
$dut.mode = :user
$dut.pin(:pin1).name # => "TDI"
$dut.pin(:pin1).direction # => :input
$dut.mode = :nvmbist
$dut.pin(:pin1).name # => "NVM_FAIL"
$dut.pin(:pin1).direction # => :output
Aliases
Aliases are alternative names/handles to give to pins when using them to create patterns and other IP in Origen. Aliases can be made universal in which case they will work regardless of scope, or they can be scoped to the current package, mode and configuration.
The Origen pin API will automatically create scoped aliases for functions and package locations as they are declared, so for example:
$dut.mode = :user
$dut.pin(:pin1).name # => "TDI"
$dut.pin(:tdi).name # => "TDI"
$dut.has_pin?(:nvm_fail) # => false
$dut.pin(:nvm_fail).name # => ERROR! No pin called NVM_FAIL in the current scope!
$dut.mode = :nvmbist
$dut.pin(:pin1).name # => "NVM_FAIL"
$dut.has_pin?(:nvm_fail) # => true
$dut.pin(:nvm_fail).name # => "NVM_FAIL"
*Pin Groups*
Pin groups will be similar to aliases in that they can be made universal or scoped to a specific package/mode/ configuration.
While aliases are simply pointers to pin objects pin groups will themselves be an Origen object which will be like a Ruby array with additional metadata attached (such as a name) and a dedicated API for working with the pins. Generally a pin and pingroup will respond to the same API so that calling code does not need to worry very much about dealing with a single pin vs. a collection.
Defined Under Namespace
Modules: PinCommon Classes: FunctionProxy, GroundPin, Pin, PinBank, PinClock, PinCollection, PowerPin
Class Method Summary collapse
-
.clear_pin_aliases ⇒ Object
private
API v2, deprecated.
-
.pin_aliases ⇒ Object
private
Aliases are stored in a global array that is cleared out everytime the target is loaded, while a bit hacky this is an easy way to allow sub modules to defined con.
Instance Method Summary collapse
- #add_ground_pin(id = nil, options = {}, &block) ⇒ Object (also: #add_ground_pins)
- #add_ground_pin_group(id, *pins, &block) ⇒ Object
-
#add_pin(id = nil, options = {}, &_block) ⇒ Object
(also: #add_pins)
Use this method to add any pins that are considered owned by the given object.
- #add_pin_alias(new_name, original_name, options = {}) ⇒ Object (also: #pin_alias, #alias_pin)
- #add_pin_group(id, *pins, &_block) ⇒ Object
- #add_pin_group_alias(new_name, original_name, options = {}) ⇒ Object
- #add_power_pin(id = nil, options = {}, &block) ⇒ Object (also: #add_power_pins)
- #add_power_pin_group(id, *pins, &block) ⇒ Object
-
#all_ground_pins(id = nil, _options = {}, &_block) ⇒ Object
Equivalent to the all_pins method but considers ground pins rather than regular pins.
-
#all_pins(id = nil, _options = {}, &_block) ⇒ Object
Similar to the pins method except that this method will bypass the package/mode/configuration scope.
-
#all_power_pins(id = nil, _options = {}, &_block) ⇒ Object
Equivalent to the all_pins method but considers power pins rather than regular pins.
- #delete_all_pins ⇒ Object
-
#delete_pin(id, options = {}) ⇒ Object
Delete any pin or pin group.
-
#ground_pin_groups(id = nil, options = {}, &_block) ⇒ Object
(also: #ground_pin_group)
Equivalent to the pin_groups method but considers ground pins rather than regular pins.
-
#ground_pins(id = nil, options = {}, &block) ⇒ Object
Equivalent to the pins method but considers ground pins rather than regular pins.
-
#has_ground_pin?(id) ⇒ Boolean
(also: #has_ground_pins?)
Equivalent to the has_pin? method but considers ground pins rather than regular pins.
-
#has_pin?(id) ⇒ Boolean
(also: #has_pins?)
Returns true if the module has access to a pin with the given name within the current context.
-
#has_power_pin?(id) ⇒ Boolean
(also: #has_power_pins?)
Equivalent to the has_pin? method but considers power pins rather than regular pins.
-
#pin_aliases ⇒ Object
private
API v2, deprecated.
- #pin_groups(id = nil, options = {}, &_block) ⇒ Object (also: #pin_group)
-
#pin_order ⇒ Object
API v2, deprecated.
-
#pin_order_block(order) ⇒ Object
API v2, deprecated.
-
#pin_pattern_exclude(*pin_ids) ⇒ Object
Specify the pins will not appear in the output pattern.
-
#pin_pattern_order(*pin_ids) ⇒ Object
Specify the order that pins will appear in the output pattern, unspecified pins will appear in an arbitrary order at the end.
-
#pins(id = nil, options = {}, &_block) ⇒ Object
(also: #pin)
Permits access via object.pin(x), returns a hash of all pins if no id is specified.
-
#power_pin_groups(id = nil, options = {}, &_block) ⇒ Object
(also: #power_pin_group)
Equivalent to the pin_groups method but considers power pins rather than regular pins.
-
#power_pins(id = nil, options = {}, &block) ⇒ Object
Equivalent to the pins method but considers power pins rather than regular pins.
Class Method Details
.clear_pin_aliases ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
API v2, deprecated
183 184 185 |
# File 'lib/origen/pins.rb', line 183 def self.clear_pin_aliases @@pin_aliases = {} end |
.pin_aliases ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Aliases are stored in a global array that is cleared out everytime the target is loaded, while a bit hacky this is an easy way to allow sub modules to defined con
API v2, deprecated
193 194 195 |
# File 'lib/origen/pins.rb', line 193 def self.pin_aliases @@pin_aliases ||= {} end |
Instance Method Details
#add_ground_pin(id = nil, options = {}, &block) ⇒ Object Also known as: add_ground_pins
269 270 271 272 273 274 275 |
# File 'lib/origen/pins.rb', line 269 def add_ground_pin(id = nil, = {}, &block) id, = nil, id if id.is_a?(Hash) = { ground_pin: true }.merge() add_pin(id, , &block) end |
#add_ground_pin_group(id, *pins, &block) ⇒ Object
448 449 450 451 452 453 454 455 456 457 458 |
# File 'lib/origen/pins.rb', line 448 def add_ground_pin_group(id, *pins, &block) if pins.last.is_a?(Hash) = pins.pop else = {} end = { ground_pin: true }.merge() add_pin_group(id, *pins, , &block) end |
#add_pin(id = nil, options = {}, &_block) ⇒ Object Also known as: add_pins
Use this method to add any pins that are considered owned by the given object. Pins declared via this method will be accessible within the object via pin(:pinname) or if you prefer self.pin(:pinname). Externally you would refer to it via $top.pin(:pinname) or $soc.pin(:pinname) or even $top.sub_module.pin(:pinname) depending on where you called this method. Pins are output in the pattern in the order that they are declared. A minimum declaration is this:
add_pin :d_out # A single pin that will be set to :dont_care by default
To set the initial state at the same time:
add_pin :d_in, :reset => :drive_hi
add_pin :invoke, :reset => :drive_lo
You can override the name that appears in the pattern by providing a string as the last argument
add_pin :done, :reset => :expect_hi, :name => "bist_done"
add_pin :fail, :name => "bist_fail"
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 |
# File 'lib/origen/pins.rb', line 212 def add_pin(id = nil, = {}, &_block) id, = nil, id if id.is_a?(Hash) power_pin = .delete(:power_pin) ground_pin = .delete(:ground_pin) if [:size] && [:size] > 1 group = PinCollection.new(self, .merge(placeholder: true)) group.id = id if id = { name: '' }.merge() .delete(:size).times do |i| [:name] = "#{id}#{i}".to_sym if power_pin group[i] = PowerPin.new(i, self, ) elsif ground_pin group[i] = GroundPin.new(i, self, ) else group[i] = Pin.new(i, self, ) end group[i].invalidate_group_cache end yield group if block_given? group.each do |pin| pin.id = "#{group.id}#{pin.id}".to_sym pin.finalize end if group.size == 1 Origen.pin_bank.add_pin(group.first, self, ) else Origen.pin_bank.add_pin_group(group, self, ) end else if power_pin pin = PowerPin.new(id || :temp, self, ) elsif ground_pin pin = GroundPin.new(id || :temp, self, ) else pin = Pin.new(id || :temp, self, ) end yield pin if block_given? pin.finalize Origen.pin_bank.add_pin(pin, self, ) end end |
#add_pin_alias(new_name, original_name, options = {}) ⇒ Object Also known as: pin_alias, alias_pin
315 316 317 318 319 320 321 322 323 324 325 |
# File 'lib/origen/pins.rb', line 315 def add_pin_alias(new_name, original_name, = {}) if pin_groups.include?(original_name) # this is a pin group if [:pin] # alias single pin from a pin group pin(original_name)[[:pin]].add_alias(new_name, ) else # alias subset of pins from a pin group add_pin_group_alias(new_name, original_name, ) end else # this is a pin pin(original_name).add_alias(new_name, ) end end |
#add_pin_group(id, *pins, &_block) ⇒ Object
387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 |
# File 'lib/origen/pins.rb', line 387 def add_pin_group(id, *pins, &_block) if pins.last.is_a?(Hash) = pins.pop else = {} end # check if this is a pin group alias found = false group = nil unless [:pins_only] == true pins.each do |i| if pin_groups.include?(i) group = add_pin_group_alias(id, i, ) found = true end end end unless found # not a pin group alias group = Origen.pin_bank.find_or_create_pin_group(id, self, ) if block_given? yield group else # SMcG: # # Not 100% sure that this is right, but the idea here is that when manually defining a pin # group the user will naturally think in endian order. e.g. when defining a big endian group # they would do: # # add_pin_group :pa, :pa7, :pa5, :pa1, :pa0 # # But if it was little endian they would probably do: # # add_pin_group :pa, :pa0, :pa1, :pa5, :pa7, :endian => :little # # However I never work on little endian ports so I don't know for sure! # # In both cases though we always want pins(:pa)[0] to return :pa0. if [:endian] == :little pins.each { |pin| group.add_pin(pin, ) } else pins.reverse_each { |pin| group.add_pin(pin, ) } end end end group # Origen.pin_bank.add_pin_group(group, self, {:pins_exist => true}.merge(options)) end |
#add_pin_group_alias(new_name, original_name, options = {}) ⇒ Object
329 330 331 332 333 334 335 336 337 338 339 |
# File 'lib/origen/pins.rb', line 329 def add_pin_group_alias(new_name, original_name, = {}) group = Origen.pin_bank.find_or_create_pin_group(new_name, self, ) if [:pins] # alias to range of pins from a pin group [:pins].each do |mypin| pin(new_name).add_pin(pin(original_name)[mypin]) end else pin(original_name).each_with_index { |_pin, i| pin(new_name).add_pin(pin(original_name)[i]) } end group end |
#add_power_pin(id = nil, options = {}, &block) ⇒ Object Also known as: add_power_pins
260 261 262 263 264 265 266 |
# File 'lib/origen/pins.rb', line 260 def add_power_pin(id = nil, = {}, &block) id, = nil, id if id.is_a?(Hash) = { power_pin: true }.merge() add_pin(id, , &block) end |
#add_power_pin_group(id, *pins, &block) ⇒ Object
436 437 438 439 440 441 442 443 444 445 446 |
# File 'lib/origen/pins.rb', line 436 def add_power_pin_group(id, *pins, &block) if pins.last.is_a?(Hash) = pins.pop else = {} end = { power_pin: true }.merge() add_pin_group(id, *pins, , &block) end |
#all_ground_pins(id = nil, _options = {}, &_block) ⇒ Object
Equivalent to the all_pins method but considers ground pins rather than regular pins
483 484 485 486 487 488 489 |
# File 'lib/origen/pins.rb', line 483 def all_ground_pins(id = nil, = {}, &_block) if id pin = Origen.pin_bank.find(id, ignore_context: true, ground_pin: true) else Origen.pin_bank.all_ground_pins end end |
#all_pins(id = nil, _options = {}, &_block) ⇒ Object
Similar to the pins method except that this method will bypass the package/mode/configuration scope.
Therefore with no id supplied it will return all known pins and with an id it will return the given pin object regardless of where or not it is enabled by the current context
465 466 467 468 469 470 471 |
# File 'lib/origen/pins.rb', line 465 def all_pins(id = nil, = {}, &_block) if id pin = Origen.pin_bank.find(id, ignore_context: true) else Origen.pin_bank.all_pins end end |
#all_power_pins(id = nil, _options = {}, &_block) ⇒ Object
Equivalent to the all_pins method but considers power pins rather than regular pins
474 475 476 477 478 479 480 |
# File 'lib/origen/pins.rb', line 474 def all_power_pins(id = nil, = {}, &_block) if id pin = Origen.pin_bank.find(id, ignore_context: true, power_pin: true) else Origen.pin_bank.all_power_pins end end |
#delete_all_pins ⇒ Object
607 608 609 |
# File 'lib/origen/pins.rb', line 607 def delete_all_pins Origen.pin_bank.send :empty! end |
#delete_pin(id, options = {}) ⇒ Object
Delete any pin or pin group. If arg is a pin then delete the pin and any instances of it in any pin groups
613 614 615 616 617 618 619 620 621 622 623 |
# File 'lib/origen/pins.rb', line 613 def delete_pin(id, = {}) id = id.to_sym # Check if this is a Pin or a PinGroup if pin_groups.key? id Origen.pin_bank.delete_pingroup(Origen.pin_bank.find_pin_group(id, )) elsif pins(id).class.to_s.match(/Pin/) Origen.pin_bank.delete_pin(Origen.pin_bank.find(id, )) else fail "Error: the object #{id} you tried to delete is not a pin or pingroup" end end |
#ground_pin_groups(id = nil, options = {}, &_block) ⇒ Object Also known as: ground_pin_group
Equivalent to the pin_groups method but considers ground pins rather than regular pins
535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 |
# File 'lib/origen/pins.rb', line 535 def ground_pin_groups(id = nil, = {}, &_block) id, = nil, id if id.is_a?(Hash) if id pin = Origen.pin_bank.find(id, .merge(ground_pin: true)) unless pin puts "You have tried to reference ground_pin_group :\#{id} within \#{self.class} but it does not exist, this could be\nbecause the pin group has not been defined yet or it is an alias that is not available in the current context.\n\nIf you meant to define the ground_pin_group then use the add_ground_pin_group method instead.\n\n END\n fail 'Power pin group not found'\n end\n pin\n else\n Origen.pin_bank.ground_pin_groups(options)\n end\nend\n" |
#ground_pins(id = nil, options = {}, &block) ⇒ Object
Equivalent to the pins method but considers ground pins rather than regular pins
599 600 601 602 603 604 605 |
# File 'lib/origen/pins.rb', line 599 def ground_pins(id = nil, = {}, &block) id, = nil, id if id.is_a?(Hash) = { ground_pin: true }.merge() pins(id, , &block) end |
#has_ground_pin?(id) ⇒ Boolean Also known as: has_ground_pins?
Equivalent to the has_pin? method but considers ground pins rather than regular pins
382 383 384 |
# File 'lib/origen/pins.rb', line 382 def has_ground_pin?(id) !!Origen.pin_bank.find(id, ground_pin: true) end |
#has_pin?(id) ⇒ Boolean Also known as: has_pins?
Returns true if the module has access to a pin with the given name within the current context
370 371 372 |
# File 'lib/origen/pins.rb', line 370 def has_pin?(id) !!Origen.pin_bank.find(id) end |
#has_power_pin?(id) ⇒ Boolean Also known as: has_power_pins?
Equivalent to the has_pin? method but considers power pins rather than regular pins
376 377 378 |
# File 'lib/origen/pins.rb', line 376 def has_power_pin?(id) !!Origen.pin_bank.find(id, power_pin: true) end |
#pin_aliases ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
API v2, deprecated
344 345 346 347 348 349 350 351 352 |
# File 'lib/origen/pins.rb', line 344 def pin_aliases # Clear this out every time the target changes if !(defined? @@pin_aliases_target) || (@@pin_aliases_target != Origen.target.signature) Origen::Pins.clear_pin_aliases @@pin_aliases_target = Origen.target.signature end Origen::Pins.pin_aliases end |
#pin_groups(id = nil, options = {}, &_block) ⇒ Object Also known as: pin_group
491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 |
# File 'lib/origen/pins.rb', line 491 def pin_groups(id = nil, = {}, &_block) id, = nil, id if id.is_a?(Hash) if id pin = Origen.pin_bank.find(id, ) unless pin puts "You have tried to reference pin_group :\#{id} within \#{self.class} but it does not exist, this could be\nbecause the pin has not been defined yet or it is an alias that is not available in the current context.\n\nIf you meant to define the pin_group then use the add_pin_group method instead.\n\n END\n fail 'Pin not found'\n end\n pin\n else\n Origen.pin_bank.pin_groups(options)\n end\nend\n" |
#pin_order ⇒ Object
API v2, deprecated
355 356 357 358 |
# File 'lib/origen/pins.rb', line 355 def pin_order @pin_order ||= 10_000_000 @pin_order += 1 end |
#pin_order_block(order) ⇒ Object
API v2, deprecated
361 362 363 364 365 366 |
# File 'lib/origen/pins.rb', line 361 def pin_order_block(order) pin_order_orig = @pin_order @pin_order = order * 1000 yield @pin_order = pin_order_orig end |
#pin_pattern_exclude(*pin_ids) ⇒ Object
Specify the pins will not appear in the output pattern
299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 |
# File 'lib/origen/pins.rb', line 299 def pin_pattern_exclude(*pin_ids) if pin_ids.last.is_a?(Hash) = pin_ids.pop else = {} end pin_ids.each do |id| if pin_aliases[id] Origen.app.pin_names[pin_aliases[id].first] = id id = pin_aliases[id].first end Origen.app.pin_pattern_exclude << id end Origen.app.pin_pattern_exclude << unless .empty? end |
#pin_pattern_order(*pin_ids) ⇒ Object
Specify the order that pins will appear in the output pattern, unspecified pins will appear in an arbitrary order at the end
API v2, deprecated
282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 |
# File 'lib/origen/pins.rb', line 282 def pin_pattern_order(*pin_ids) if pin_ids.last.is_a?(Hash) = pin_ids.pop else = {} end pin_ids.each do |id| if pin_aliases[id] Origen.app.pin_names[pin_aliases[id].first] = id id = pin_aliases[id].first end Origen.app.pin_pattern_order << id end Origen.app.pin_pattern_order << unless .empty? end |
#pins(id = nil, options = {}, &_block) ⇒ Object Also known as: pin
Permits access via object.pin(x), returns a hash of all pins if no id is specified.
Examples
$top.pin(:done)
$soc.pin(:port_a1)
pin(:fail) # Access directly from within the module
562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 |
# File 'lib/origen/pins.rb', line 562 def pins(id = nil, = {}, &_block) id, = nil, id if id.is_a?(Hash) if id pin = Origen.pin_bank.find(id, ) unless pin puts "You have tried to reference pin :\#{id} within \#{self.class} but it does not exist, this could be\nbecause the pin has not been defined yet or it is an alias that is not available in the current context.\n\nIf you meant to define the pin then use the add_pin method instead.\n\n END\n fail 'Pin not found'\n end\n pin\n else\n if options[:power_pin]\n Origen.pin_bank.power_pins\n elsif options[:ground_pin]\n Origen.pin_bank.ground_pins\n else\n Origen.pin_bank.pins\n end\n end\nend\n" |
#power_pin_groups(id = nil, options = {}, &_block) ⇒ Object Also known as: power_pin_group
Equivalent to the pin_groups method but considers power pins rather than regular pins
513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 |
# File 'lib/origen/pins.rb', line 513 def power_pin_groups(id = nil, = {}, &_block) id, = nil, id if id.is_a?(Hash) if id pin = Origen.pin_bank.find(id, .merge(power_pin: true)) unless pin puts "You have tried to reference power_pin_group :\#{id} within \#{self.class} but it does not exist, this could be\nbecause the pin group has not been defined yet or it is an alias that is not available in the current context.\n\nIf you meant to define the power_pin_group then use the add_power_pin_group method instead.\n\n END\n fail 'Power pin group not found'\n end\n pin\n else\n Origen.pin_bank.power_pin_groups(options)\n end\nend\n" |
#power_pins(id = nil, options = {}, &block) ⇒ Object
Equivalent to the pins method but considers power pins rather than regular pins
590 591 592 593 594 595 596 |
# File 'lib/origen/pins.rb', line 590 def power_pins(id = nil, = {}, &block) id, = nil, id if id.is_a?(Hash) = { power_pin: true }.merge() pins(id, , &block) end |