netbox icon indicating copy to clipboard operation
netbox copied to clipboard

Add "IEC 60130-10" (DC) to power port types

Open ZPrimed opened this issue 1 year ago • 10 comments

NetBox version

v3.6.3

Feature type

Data model extension

Proposed functionality

The existing model for "power ports" includes a very large amount of AC-type ports, but not much in the way of DC power. It would be nice to have better documentation about what specific type of connector(s) a device has.

I would like to propose these additions:

  • Barrel connector (ideally, a list of various ID & ODs for the barrel would be nice, but this gets to be a mess very quickly - there is currently not even a generic "barrel plug" option and I'd be happy with that)
  • Bolt-through terminal (is this what "hardwired" under "Other" is meant to be? or is hardwired actually intended for a "permanent, requires electrician" connection?)
  • Screw-down wire-clamp terminal
  • Removable Terminal Block connector (there are a slew of these as well, I guess technically "DC Terminal" would cover this as a generic, but documenting at least some of the more common connector types would be "better")

Use case

Attempting to correctly model real-world equipment requires the port types to be defined. 😉

Database changes

(no db changes expected?)

External dependencies

No response

ZPrimed avatar Oct 09 '23 21:10 ZPrimed

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. NetBox is governed by a small group of core maintainers which means not all opened issues may receive direct feedback. Do not attempt to circumvent this process by "bumping" the issue; doing so will result in its immediate closure and you may be barred from participating in any future discussions. Please see our contributing guide.

github-actions[bot] avatar Jan 23 '24 04:01 github-actions[bot]

@ZPrimed this issue is at risk of being auto-closed, and I think it would be a shame if that happened, so I'm using my privilege to give it a bump and asking for a little more detail in the form of a list of specific connector type enum IDs, descriptive names, and slug names that you propose to add. You might refer to PR #8415 to get an idea of what we're looking for.

jeffgdotorg avatar Jan 24 '24 22:01 jeffgdotorg

Well, at a bare minimum, the IEC 60130-10 standard coaxial/barrel connectors should probably be included as sub-types of "DC":

Coaxial Barrel - IEC 60130-10

  • Type A1: 5.5 mm OD, 2.1 mm ID (with optional screw lock)
  • Type A2: 5.5 mm OD, 2.5 mm ID (with optional screw lock) [yes, there are two different "Type A" standards 🙄 ]
  • Type B1: 6.0 mm OD, 2.1 mm ID
  • Type B2: 6.0 mm OD, 2.5 mm ID [and also two different "Type B" standards 🙄 ]
  • Type C: 3.8 mm OD, 1.1 mm ID
  • Type D: 6.3 mm OD, 3.1 mm ID
  • Type E: 3.4 mm OD, 1.3 mm ID

A generic "Other Barrel Plug" would probably be a useful catch-all as well...

A design question: The current power connector list never seems to go below one "level". Would there be any objection to having a "sub-heading" below "DC" of "Coaxial Barrel - IEC 60130-10" and then listing out the individual "types" below that sub-heading?

Additionally, is it "redundant" to include "DC" as part of the description for the connector, since that is already included in the heading above it?

ZPrimed avatar Jan 25 '24 00:01 ZPrimed

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. NetBox is governed by a small group of core maintainers which means not all opened issues may receive direct feedback. Do not attempt to circumvent this process by "bumping" the issue; doing so will result in its immediate closure and you may be barred from participating in any future discussions. Please see our contributing guide.

github-actions[bot] avatar May 15 '24 12:05 github-actions[bot]

Note: This would be an addition to dcim.choices.PowerPortTypeChoices

arthanson avatar May 15 '24 20:05 arthanson

@ZPrimed can you please look at PR #16206 see if that would address your request?

arthanson avatar May 20 '24 19:05 arthanson

Looks great to me. A couple of those do have a positive-retention (screw-down) variant, wasn't sure if those should be included as well? IMO it's always useful to know if a connector is capable of "locking"...

ZPrimed avatar May 20 '24 21:05 ZPrimed

@ZPrimed do you know the other side (female) of these connectors? We need both sides to be added for these, taking a Quick Look at the specs I didn't see these defined.

arthanson avatar Jun 20 '24 15:06 arthanson

This is a reminder that additional information is needed in order to further triage this issue. If the requested details are not provided, the issue will soon be closed automatically.

github-actions[bot] avatar Jun 28 '24 04:06 github-actions[bot]

@ZPrimed do you know the other side (female) of these connectors? We need both sides to be added for these, taking a Quick Look at the specs I didn't see these defined.

@arthanson I've never heard of anything beyond simply "male" and "female" for these plugs & jacks. They get described by the ID/OD and inner pin size.

ZPrimed avatar Jun 28 '24 04:06 ZPrimed

I don't have the specs handy, but this article seems to reference quite a few based on the IEC 60130-10:1971, EIAJ (Japan), and DIN (Germany). The Wikipedia article seems to be more detailed, as well.

eronlloyd avatar Jul 07 '24 01:07 eronlloyd