Difference between revisions of "Errata and Improvements"

From RCS Wiki
Jump to navigation Jump to search
(add suggestion to mention ALERT LED connection →‎Miscellaneous Improvements)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
This is a place where mistakes in the user manuals as well as possible improvements (all kinds of things) can be collected, so that they don't get lost.
+
This is a place where mistakes in the user manuals (and other RaptorCS documents) as well as possible improvements (all kinds of things) can be collected, so that they don't get lost.
  
 
User Manual for:
 
User Manual for:
Line 14: Line 14:
  
 
====Blackbird specific====
 
====Blackbird specific====
 +
* p.14: Explicitly notes to install an indium pad, however no indium pads are provided nor required for the 4-/8-core CPUs which come with the Blackbird
 +
* p.15: There is only one CPU socket available on Blackbird but the user manual says: ''If you have a second CPU, repeat this process for the other socket.''
 
* p.22: Big Blue Arrow points to wrong header (USB3 instead of TPM)
 
* p.22: Big Blue Arrow points to wrong header (USB3 instead of TPM)
 
* p.37: "ON-BOARD VGA DISABLE JUMPER" -  but there is no VGA on the Blackbird
 
* p.37: "ON-BOARD VGA DISABLE JUMPER" -  but there is no VGA on the Blackbird
* p.14 explicitly notes to install an indium pad, however no indium pads are provided nor required for the 4-/8-core CPUs which come with the Blackbird
 
  
 
====Talos II & Blackbird====
 
====Talos II & Blackbird====
Line 31: Line 32:
  
 
====Talos II & Blackbird====
 
====Talos II & Blackbird====
* Installation description (Talos II: p.13, Blackbird: p.11) should mention especially to make sure '''no more''' mounting studs are installed in the case than required
+
* Installation description (Talos II: p.13, Blackbird: p.11) should mention especially that there must be '''no more''' mounting studs installed in the case than required.
 
* Include a front view of the I/O panel naming each port. Esp. indicate which of the RJ-45 ports is connected to the BMC.
 
* Include a front view of the I/O panel naming each port. Esp. indicate which of the RJ-45 ports is connected to the BMC.
 
* In the HSF INSTALLATION section, explicitly advise against thermal paste, since it's not required and complicates removal of the HSF (CPU may stick, then fall down angled and damage the socket).
 
* In the HSF INSTALLATION section, explicitly advise against thermal paste, since it's not required and complicates removal of the HSF (CPU may stick, then fall down angled and damage the socket).
 +
 +
==RCS Schematics==
 +
 +
===Errata===
 +
 +
====Talos II specific====
 +
*CPUFAN0 and CPUFAN1 labels are swapped (according to awordnot in #talos-workstation)
  
 
==Miscellaneous Improvements==
 
==Miscellaneous Improvements==
 
* Use a different font on the BMC default password snippets that will make distinguishing the letters 1/l/I and O/0 ''possible at all'' (users regularly have trouble with reading them)
 
* Use a different font on the BMC default password snippets that will make distinguishing the letters 1/l/I and O/0 ''possible at all'' (users regularly have trouble with reading them)
 +
* Explain how to change the BMC password and add a link to printed default password delivered together with the Blackbird. For Talos II there already exists a [[Talos_II_Beginner's_Quick_Start_Guide#Changing_The_Password|how to change the OpenBMC passsword wiki entry]] which should work for Blackbird too.
 
* Indicate in the BMC hostname whether it's the host or the BMC, e.g. "blackbird-bmc" instead of "blackbird"
 
* Indicate in the BMC hostname whether it's the host or the BMC, e.g. "blackbird-bmc" instead of "blackbird"
 
* RCS could include 2 plastic mainboard standoffs [https://www.pccables.com/images/STANDOFFS-MOTHERBOARD-STANDARD-MB-PLASTIC-100-PACK.jpg like these] with the mainboard, since missing standoffs are ''very common'', as can be seen here: [[Talos II/Hardware Compatibility List#Problematic Cases]]. They are very cheap in bulk and should not add up much to the cost.
 
* RCS could include 2 plastic mainboard standoffs [https://www.pccables.com/images/STANDOFFS-MOTHERBOARD-STANDARD-MB-PLASTIC-100-PACK.jpg like these] with the mainboard, since missing standoffs are ''very common'', as can be seen here: [[Talos II/Hardware Compatibility List#Problematic Cases]]. They are very cheap in bulk and should not add up much to the cost.
Line 42: Line 51:
 
* RCS should notify customers if the purchased products are not expected to be getting shipped (start of shipping) in a certain timeframe, e.g. 2 weeks.
 
* RCS should notify customers if the purchased products are not expected to be getting shipped (start of shipping) in a certain timeframe, e.g. 2 weeks.
 
* RCS could provide customers with a regular (e.g. monthly) update on their order. (Due to long shipping delays and sometimes unresponsive support, some people were worried if their order will ship at all, and asked about it in the [[IRC| IRC channel]].
 
* RCS could provide customers with a regular (e.g. monthly) update on their order. (Due to long shipping delays and sometimes unresponsive support, some people were worried if their order will ship at all, and asked about it in the [[IRC| IRC channel]].
 +
* The default PWM duty cycle on the Blackbird is 25/255, which is roughly 10%. For many common consumer fans, this is not enough, many expect the duty cycle to be in the range 20% - 100%. See also [https://noctua.at/media/wysiwyg/Noctua_PWM_specifications_white_paper.pdf this Noctua whitepaper] and [https://www.glkinst.com/cables/cable_pics/4_Wire_PWM_Spec.pdf this 4 wire PWM Spec]. This might (?) also apply to the Talos 2. Tested on Blackbird System Package v1.00.
 +
* Explain (for the layman) how to connect the HDD activity LED. Pages 19/20 show the Front Panel PIN for the *HDD activity LED cathode* but no obvious neighbored PIN for the anode (HDD activity LEDs are often having both PINs in one plug so they should be paired on the motherboard). See the [[Blackbird/Building FAQ|Blackbird Building FAQ]] and also the [[Talos_II/Building_FAQ|Talos Building FAQ]] for more details
 +
* Explain how to connect the ALERT/UID LED - the Initial Power-On section of the manual refers to an "ALERT" LED which is not mentioned in the description of the Front Panel header nor anywhere else.  Pin 7, which contains this signal, is erroneously referred to as +3.3V.  System builders not using a Supermicro chassis may not have access to this LED signal.
 +
 +
=See also=
 +
* [[Desktop Roadmap]]

Latest revision as of 08:08, 3 May 2022

Purpose

This is a place where mistakes in the user manuals (and other RaptorCS documents) as well as possible improvements (all kinds of things) can be collected, so that they don't get lost.

User Manual for:

RCS User Manual

Errata

Talos II specific

  • p.16: Add note that indium pads are not required for 4-/8-core CPUs. Currently, the manual explicitly tells you to install indium pads.

Blackbird specific

  • p.14: Explicitly notes to install an indium pad, however no indium pads are provided nor required for the 4-/8-core CPUs which come with the Blackbird
  • p.15: There is only one CPU socket available on Blackbird but the user manual says: If you have a second CPU, repeat this process for the other socket.
  • p.22: Big Blue Arrow points to wrong header (USB3 instead of TPM)
  • p.37: "ON-BOARD VGA DISABLE JUMPER" - but there is no VGA on the Blackbird

Talos II & Blackbird

  • Internal USB2.0 Type-A port is not mentioned in the manual
  • Internal USB2.0 Type-A port is falsely shown to be connected to the BMC in the block diagrams

Possible Improvements

Talos II specific

  • p.17: HSF REMOVAL: Add note that during removal the CPU might stick to the HSF via a potentially installed indium pad. If it then falls down in an angle on the socket, the board is most likely damaged.

Blackbird specific

  • p.39: Mark internal audio header as "HDA compatible" more visibly?

Talos II & Blackbird

  • Installation description (Talos II: p.13, Blackbird: p.11) should mention especially that there must be no more mounting studs installed in the case than required.
  • Include a front view of the I/O panel naming each port. Esp. indicate which of the RJ-45 ports is connected to the BMC.
  • In the HSF INSTALLATION section, explicitly advise against thermal paste, since it's not required and complicates removal of the HSF (CPU may stick, then fall down angled and damage the socket).

RCS Schematics

Errata

Talos II specific

  • CPUFAN0 and CPUFAN1 labels are swapped (according to awordnot in #talos-workstation)

Miscellaneous Improvements

  • Use a different font on the BMC default password snippets that will make distinguishing the letters 1/l/I and O/0 possible at all (users regularly have trouble with reading them)
  • Explain how to change the BMC password and add a link to printed default password delivered together with the Blackbird. For Talos II there already exists a how to change the OpenBMC passsword wiki entry which should work for Blackbird too.
  • Indicate in the BMC hostname whether it's the host or the BMC, e.g. "blackbird-bmc" instead of "blackbird"
  • RCS could include 2 plastic mainboard standoffs like these with the mainboard, since missing standoffs are very common, as can be seen here: Talos II/Hardware Compatibility List#Problematic Cases. They are very cheap in bulk and should not add up much to the cost.
  • Provide high-res pictures of the Blackbird board, like for the Talos II: Top and Bottom
  • RCS should notify customers if the purchased products are not expected to be getting shipped (start of shipping) in a certain timeframe, e.g. 2 weeks.
  • RCS could provide customers with a regular (e.g. monthly) update on their order. (Due to long shipping delays and sometimes unresponsive support, some people were worried if their order will ship at all, and asked about it in the IRC channel.
  • The default PWM duty cycle on the Blackbird is 25/255, which is roughly 10%. For many common consumer fans, this is not enough, many expect the duty cycle to be in the range 20% - 100%. See also this Noctua whitepaper and this 4 wire PWM Spec. This might (?) also apply to the Talos 2. Tested on Blackbird System Package v1.00.
  • Explain (for the layman) how to connect the HDD activity LED. Pages 19/20 show the Front Panel PIN for the *HDD activity LED cathode* but no obvious neighbored PIN for the anode (HDD activity LEDs are often having both PINs in one plug so they should be paired on the motherboard). See the Blackbird Building FAQ and also the Talos Building FAQ for more details
  • Explain how to connect the ALERT/UID LED - the Initial Power-On section of the manual refers to an "ALERT" LED which is not mentioned in the description of the Front Panel header nor anywhere else. Pin 7, which contains this signal, is erroneously referred to as +3.3V. System builders not using a Supermicro chassis may not have access to this LED signal.

See also