1
0
forked from me/IronOS

Deployed a1d84fff with MkDocs version: 1.3.1

This commit is contained in:
github-actions[bot]
2022-09-21 09:33:57 +00:00
parent 4e0b2a82a7
commit f367e75a42
9 changed files with 14 additions and 14 deletions

View File

@@ -200,7 +200,7 @@ This can be used with RTip for assessing temperature processing performance.</p>
<p>This is the handle temperature or more accurately the reading of the Cold Junction Compensation (CJC) temperature sensor. This is expressed in °C. Range of 20-40 °C is normal depending on how hot/cold the room is and how long power has been plugged in which warms the PCB further.
This is used for CJC of the tip temperature.</p>
<blockquote>
<p>If CHan is extremely high, this indicates the temperature sensor isn't reading correctly (<a href="/Documentation/Troubleshooting.md">see Troubleshooting</a>)</p>
<p>If CHan is extremely high, this indicates the temperature sensor isn't reading correctly (<a href="https://ralim.github.io/IronOS/Troubleshooting/">see Troubleshooting</a>)</p>
</blockquote>
<h3 id="max-c">Max C</h3>
<p>This indicates the max temperature in °C that the system estimates it can measure the tip reliably to.
@@ -225,7 +225,7 @@ As this is a high-water mater, you should only trust this once you have walked t
<p>This indicates the high-water mark for the stack for the PID thread. The smaller this number is, the less headroom we have in the stack.</p>
<h3 id="hall">Hall</h3>
<p>This appears if your device is capable of having a hall effect sensor installed (Pinecil).
This shows the current magnetic field strength reading from the sensor. It is used to check if the sensor is operational, and for diagnostics and optimal placement of magnets on a stand (higher number is better/stronger). <a href="/Documentation/HallSensor.md">See Hall Sensor for details</a>. </p>
This shows the current magnetic field strength reading from the sensor. It is used to check if the sensor is operational, and for diagnostics and optimal placement of magnets on a stand (higher number is better/stronger). <a href="https://ralim.github.io/IronOS/HallSensor/">See Hall Sensor for details</a>. </p>
<h1 id="pd-debug-menu">PD Debug menu</h1>
<p>On the Pinecil; if the iron is booted up while long holding the front button (<code>+</code>); it will show an extra hidden menu for inspecting USB-PD power adapters. We can also connect to any PD USB power to check Vbus status, even some cell phones with a USB-C port will work if it is PD. It will not show PD messages when Pinecil is powered by DC port, QC, or USB 5V (non-PD). For example, if you connect to a QC charger, you may simply see "PD State 6" which indicates "waiting for source" as no PD messages will be ever be sent and you will not be able to use (<code>+</code>) to scroll through PD negotiated messages.</p>
<p>Pressing (<code>+</code>) cycles through elements, and (<code>-</code>) or unplugging will exit the menu.</p>

View File

@@ -141,10 +141,10 @@
<h1 id="getting-started">Getting Started</h1>
<p>Getting started with IronOS on your Pinecil/TS80/TS80P/TS100.
If your device did not come with IronOS already installed, or if you need to update to the latest version; please see the <a href="/Documentation/Flashing.md">Flashing Guide</a>. It is recommended to update to the newest stable release.</p>
If your device did not come with IronOS already installed, or if you need to update to the latest version; please see the <a href="https://ralim.github.io/IronOS/Flashing/">Flashing Guide</a>. It is recommended to update to the newest stable release.</p>
<p>Once your Iron has been flashed, on first power on it <em>may</em> warn you about the system settings being reset.
<em>Do not panic</em>; this is 100% completely normal. This is here to note to you that they have been reset to handle the internal structure changing.</p>
<p>If you receive a warning about the accelerometer or USB-PD not being detected, please see <a href="/Documentation/HardwareIssues.md">here</a>.</p>
<p>If you receive a warning about the accelerometer or USB-PD not being detected, please see <a href="https://ralim.github.io/IronOS/HardwareIssues/">here</a>.</p>
<h2 id="the-home-screen-or-idle-screen">The Home screen (or idle screen)</h2>
<p>This is the landing page of the firmware, from here you can choose to either go into the <a href="#Settings-Menu">settings menu</a> or go into <a href="#Soldering-Mode">soldering mode</a>.</p>
<p>By default this will show a screen similar to the one below:</p>
@@ -154,12 +154,12 @@ If your device did not come with IronOS already installed, or if you need to upd
<p>And naturally, the spanner like icon represents that pressing the button near the rear of the soldering iron will enter the settings menu.</p>
<p>In the settings, you can turn on a detailed idle screen instead. The buttons still function the same, however, the image will be swapped for a text telling you the current status of the iron with extra details.</p>
<p>Depending on how your device is being powered, at right side of the screen, the firmware will either show the voltage your unit is being provided with, a battery icon (if battery mode is enabled) or a power plug icon.</p>
<p>If you see an (<strong>X</strong>) where the soldering iron should be, this indicates that the firmware can't see the tip connected. This could indicate a problem with the iron or tip. First, try removing the tip screw and tip and gently reinstalling both; ensure that the tip is seated all the way back. If the issue persists please see the <a href="/Documentation/HardwareIssues.md">hardware issues section</a>.</p>
<p>If you see an (<strong>X</strong>) where the soldering iron should be, this indicates that the firmware can't see the tip connected. This could indicate a problem with the iron or tip. First, try removing the tip screw and tip and gently reinstalling both; ensure that the tip is seated all the way back. If the issue persists please see the <a href="https://ralim.github.io/IronOS/HardwareIssues/">hardware issues section</a>.</p>
<p>This OLED screen features burn-in protection; if no buttons or movement have been detected for a while it will automatically blank the screen to reduce burn-in when the iron is left unattended. Any movement or button press will wake the screen.</p>
<h3 id="hidden-extras">Hidden Extras</h3>
<p>Additionally to the two icons shown, there are two "hidden" actions that can be performed on this menu.</p>
<p>If you press and hold the button near the tip (<code>+/A</code>), this enters the temperature adjustment screen. Normally this is not required; but if you would like to adjust the set temperature <em>before</em> the tip starts to heat, this can be useful.</p>
<p>If you press and hold the button near the rear of the iron (<code>-/B</code>), it will take you into the <a href="/Documentation/DebugMenu.md">debug menu</a>.</p>
<p>If you press and hold the button near the rear of the iron (<code>-/B</code>), it will take you into the <a href="https://ralim.github.io/IronOS/DebugMenu/">debug menu</a>.</p>
<h2 id="soldering-mode">Soldering Mode</h2>
<p>When you press the button to enter the soldering mode, the iron will instantly start to heat up the tip.</p>
<p>The firmware defaults to 320 °C as the set point for the soldering mode, however on this screen you can enter into the adjustment screen by pressing either button.</p>
@@ -171,7 +171,7 @@ If your device did not come with IronOS already installed, or if you need to upd
<p>In Sleep mode, the temperature of the iron automatically lowers to 150 °C (default), which is just below the melting point of the solder. This helps reduce rate of oxidation and damage to the iron tip. In general, when not using the iron, unplug it or let it sleep to increase the longevity of replaceable tips. The default sleep temperature can be customized.</p>
<p>Simply picking up or moving the iron will wake it back up into soldering mode. You can also press any button and this will also wake the iron up.</p>
<h4 id="optional-hall-effect-feature-pinecil-only">Optional Hall Effect Feature (Pinecil only):</h4>
<p>Pinecil has an unpopulated footprint (U14) for a hall effect sensor (Si7210-B-00-IV). Adding the sensor and placing a neodymium magnet on the holder stand will trigger Pinecil to sleep after it enters the stand, and Zzzz will appear on-screen. The magnet is positioned on the stand in proximity to the sensor/handle which then activates one of 10 user defined settings (0=off, 1=lowest sensitivity, 9=highest sensitivity). Read the Hall Sensor document for <a href="/Documentation/HallSensor.md">details on installation</a>.</p>
<p>Pinecil has an unpopulated footprint (U14) for a hall effect sensor (Si7210-B-00-IV). Adding the sensor and placing a neodymium magnet on the holder stand will trigger Pinecil to sleep after it enters the stand, and Zzzz will appear on-screen. The magnet is positioned on the stand in proximity to the sensor/handle which then activates one of 10 user defined settings (0=off, 1=lowest sensitivity, 9=highest sensitivity). Read the Hall Sensor document for <a href="https://ralim.github.io/IronOS/HallSensor/">details on installation</a>.</p>
<h3 id="idle-shutdown">Idle Shutdown</h3>
<p>If, after entering sleep mode, the iron still does not see movement for a much longer time (default=10 minutes); it will shut down and return to the home screen.</p>
<h2 id="settings-menu">Settings Menu</h2>

View File

@@ -137,7 +137,7 @@
- Setting of 1 might be used if you solder on PCBs with magnets and do not wish Pinecil to auto-sleep constantly. A very strong/large magnet would be required on the stand to activate the sleep mode if you use setting 1.
- Setting of 9 would be useful if you only had a small magnet and are not concerned about Pinecil falsely triggering sleep mode near magnetized items/tools.
- Actively watch the <em>hall</em> number change while you slowly move the magnet around to seek the best locations &amp; whether you have too many or too few magnets. Position the magnet(s) where you have the highest hall number will ensure consistent sleep mode when you place the iron in the stand. This requires some experimenting.
- <a href="/Documentation/DebugMenu.md">See debug menu for how to display the <em>Hall</em> number</a>
- <a href="https://ralim.github.io/IronOS/DebugMenu/">See debug menu for how to display the <em>Hall</em> number</a>
- Note that the sensor is physically located near the copper contacts for the tip at the front of the handle. <a href="https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v1.0a_20201120.pdf">Reference Schematics U14</a>.
- Neodymium magnets are recommended. If using small magnets, 2-3 may be required, but too many could also be detrimental.
- Positioning/type/quantity of magnets is important for best results. Sometimes too many magnets breaks the effect by distorting the magnetic field <strong><a href="https://www.youtube.com/shorts/afkqKwCX00I">as seen in this demo video</a></strong>. The video shows magnets at the top of the stand, and the pinecil goes correctly into Zzzz with <em>only</em> those magnets. When more magnets are added at the side, the Pinecil did not go to sleep, which is contrary to the goal. See the PDF below for details on magnetic fields with SI7210-B.

View File

@@ -146,7 +146,7 @@ Keep issue discussions to GitHub issues or the discussions page so that the whol
<p>The best way to see if this is the case is to measure the resistance across the contacts to the tip using a multimeter.
you are expecting to see measurements in the range of 4-10 ohms. Anything higher than 10 ohms is <em>generally</em> an issue.</p>
<h2 id="iron-will-not-heat-up-and-displays-a-high-temperature">Iron will not heat up and displays a high temperature</h2>
<p>Check the Rtip and CHan numbers (<a href="/Documentation/DebugMenu.md">see debug menu</a>). Extremly high CHan is suspect to a problem with the cold junction compensation temperature sensor.</p>
<p>Check the Rtip and CHan numbers (<a href="https://ralim.github.io/IronOS/DebugMenu/">see debug menu</a>). Extremly high CHan is suspect to a problem with the cold junction compensation temperature sensor.</p>
<p>For Pinecil V1, inspect near U10 which is the TMP36 sensor (<a href="https://github.com/Ralim/IronOS/issues/1234">see issue here</a>). You may be able to reflow/resolder the TMP36 chip at U10 to correct a weak solder joint.</p>
<p>If it worked on older firmware, but not on 2.16+, weak solder joints are suspect. The newer firmware runs the ADC a bit faster to keep tighter control of the tip temperature. Normally this wont cause an issue as the output from the TMP36 is powerful enough to keep up without any issue. But if you have a weak or cold solder joint this could cause issues.</p>
<p>If the CHan is extremely high, and reflowing the temperature sensor does not resolve the issue; inspect the pins in the main MCU, possibly try giving them a light squeeze to the board while watching CHan.</p>

View File

@@ -165,7 +165,7 @@ Note that cutoff messages can also be triggered by using a power supply that is
<li>Press both buttons at the same time to Save and Exit to the menu</li>
</ol>
<h3 id="calibrate-tip-cjc">Calibrate Tip CJC</h3>
<p>This performs a Tip Cold Junction Calibration (CJC) (<a href="/Documentation/Temperature.md">see Temperature for details</a>). This is normally not needed unless you have an issue with tip temperature or your tips are wearing out prematurely. Changing tip lengths does not necessarily mean a calibration is needed. Check first that your tips are not defective, and measured resistance is close to specifications (Pinecil/TS100 short tips 6.2 Ω, long tips 8 Ω, TS80(P) ~4.5 Ω).</p>
<p>This performs a Tip Cold Junction Calibration (CJC) (<a href="https://ralim.github.io/IronOS/Temperature/">see Temperature for details</a>). This is normally not needed unless you have an issue with tip temperature or your tips are wearing out prematurely. Changing tip lengths does not necessarily mean a calibration is needed. Check first that your tips are not defective, and measured resistance is close to specifications (Pinecil/TS100 short tips 6.2 Ω, long tips 8 Ω, TS80(P) ~4.5 Ω).</p>
<p>What this is for: some tips have an offset on their readings which causes issues, i.e., the actual temperature of the tip is much higher than displayed. To calibrate this out, perform the following steps. </p>
<p>Caution: if the method below is not followed, the iron could be worse than before calibration. If you need to repeat the method, first unplug and let the handle/PCB cool down to room temperature.</p>
<ol>

View File

@@ -258,9 +258,9 @@ Therefore the Pinecil and TS100 perform poorly when run off 12V power supplies a
</table>
<h2 id="output-control-regulation">Output Control &amp; Regulation</h2>
<p>These soldering irons use a FET to switch the power to the soldering iron tip. This is a P-MOSFET and its controlled via a small transistor circuit, which in turn is controlled via the MCU (i.e., STM32). The MCU controls this PWM output proportional to the output from the PID control loop running in the software.</p>
<p>To measure the tip temperature in the iron, the iron has a small op-amp connected across the terminals at the cold end of the tip. This is setup to measure the voltage across the same terminals that are used to power the tip. In order to read the very small voltage generated by the <a href="/Documentation/Temperature.md">thermocouple cold junction</a>, the iron's output must be turned off for a moment.</p>
<p>To measure the tip temperature in the iron, the iron has a small op-amp connected across the terminals at the cold end of the tip. This is setup to measure the voltage across the same terminals that are used to power the tip. In order to read the very small voltage generated by the <a href="https://ralim.github.io/IronOS/Temperature/">thermocouple cold junction</a>, the iron's output must be turned off for a moment.</p>
<p>Once the output is turned off (via the FET), the system has a recovery time as the tip capacitance discharges and the op-amp exits saturation. After this delay period, the MCU's ADC (analog-to-digital converter) samples the output of the op-amp 8 times quickly and then sets a flag to turn the PWM output back on.
This enforces a small dead time in the output signal while this occurs, so there is a balance between sampling the temperature often to maintain a stable tip temperature control and sampling less often to increase the maximum power deliverable to the tip (<a href="/Documentation/Temperature.md#complexity-of-measurement">see Complexity of measurement</a>).</p>
This enforces a small dead time in the output signal while this occurs, so there is a balance between sampling the temperature often to maintain a stable tip temperature control and sampling less often to increase the maximum power deliverable to the tip (<a href="https://ralim.github.io/IronOS/Temperature/#complexity-of-measurement">see Complexity of measurement</a>).</p>
</div>
</div><footer>

View File

@@ -137,7 +137,7 @@
<h1 id="troubleshooting">Troubleshooting</h1>
<p>If your device is not operating as expected; and you are within the manufacturer support window, please first contact your manufacturer and RMA / warranty your device.</p>
<p>If your iron is not working as expected, <a href="../DebugMenu/">the Debug menu</a> exposes internal measurements to help you narrow down the root cause of the issue.</p>
<p>If your iron is not working as expected, <a href="https://ralim.github.io/IronOS/DebugMenu/">the Debug menu</a> exposes internal measurements to help you narrow down the root cause of the issue.</p>
<p>Alongside all of these, issues with the soldering of the main MCU could cause all of these as well; and should always be checked.</p>
<p>The tip is important for the operation of your iron. T100 and Pinecil tips are around 8 ohms, and TS80(P) tips are around 4.5 ohms.</p>
<p>You are welcome to open discussions about issues as well, or if you bought your Pinecil from an official store; use the <a href="https://wiki.pine64.org/wiki/Pinecil#Community_links">Pinecil community chat</a> for support.

View File

@@ -299,5 +299,5 @@ When on the main screen and having the tip plugged in, the unit shows a pair of
<!--
MkDocs version : 1.3.1
Build Date UTC : 2022-09-21 09:23:47.108670+00:00
Build Date UTC : 2022-09-21 09:33:57.226592+00:00
-->

Binary file not shown.