1
0
forked from me/IronOS

Deployed c1bec241 with MkDocs version: 1.3.1

This commit is contained in:
github-actions[bot]
2022-09-21 11:20:41 +00:00
parent 4ccd8d19c4
commit d36f563e27
25 changed files with 1284 additions and 197 deletions

View File

@@ -41,9 +41,18 @@
<li class="toctree-l1"><a class="reference internal" href="/IronOS/GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="/IronOS/Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="/IronOS/Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="/IronOS/Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="/IronOS/Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul class="current">

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

265
Flashing/MHP30/index.html Normal file
View File

@@ -0,0 +1,265 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/MHP30/" />
<link rel="shortcut icon" href="../../img/favicon.ico" />
<title>Flashing / Upgrading your iron - IronOS</title>
<link rel="stylesheet" href="../../css/theme.css" />
<link rel="stylesheet" href="../../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "Flashing / Upgrading your iron";
var mkdocs_page_input_path = "Flashing/MHP30.md";
var mkdocs_page_url = "/IronOS/Flashing/MHP30/";
</script>
<script src="../../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="../.." class="icon icon-home"> IronOS
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../..">Home</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Menu/">Main Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Settings/">Settings</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../DebugMenu/">Debug Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Power/">Power</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Temperature/">Temperature</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Logo/">Startup Logo</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Hardware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../HallSensor/">Hall Sensor (Pinecil)</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Hardware/">Hardware Notes</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="#">Troubleshooting</a>
<ul>
<li class="toctree-l2"><a class="reference internal" href="../../Troubleshooting/">Troubleshooting</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../HardwareIssues/">Known Hardware Issues</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Translation/">Translations</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Development/">Development</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../..">IronOS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../.." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing / Upgrading your iron</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing/MHP30.md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<h1 id="flashing-upgrading-your-iron">Flashing / Upgrading your iron</h1>
<h2 id="downloading-source-file">Downloading source file</h2>
<p>In the development of this firmware, there are three <em>types</em> of firmware released.
These are the "Main" stable releases, which generally have high confidence in being bug free.
Release candidates are released slightly more often, and these are generally perfectly fine for everyday use. These are released early to allow for translation checking and for wonderful people to help spot bugs and regressions.
Finally, there are the "mainline" builds, which are built from the main git branch.
These are built on every change and can be found on the Actions tab (see below).</p>
<h3 id="main-release">Main release</h3>
<p>Main releases are made to the <a href="https://github.com/Ralim/IronOS/releases">releases page</a>.
Download the zip file that matches your model of soldering iron and extract it.
Select the appropriate file type for your unit, in general Miniware devices need <code>.hex</code> and Pinecil needs <code>.dfu</code>.
Flash according to details below</p>
<h3 id="bleeding-edge-latest">Bleeding edge / latest</h3>
<p>For the <em>latest</em> code, you will need to download the zip file from the artifacts page on the build for what you want.
Head to the <a href="https://github.com/Ralim/IronOS/actions">Actions</a> page and then select the run for the appropriate branch you would like.
In general you probably want <code>master</code>.</p>
<p>Once you click on a run, scroll down to the "Artifacts" section and then click on your model to download a zip file.
Then this works the same as a production release (use the correct file).</p>
<h1 id="mhp30">MHP30</h1>
<p>This is completely safe, but if it goes wrong just put the <code>.hex</code> file from the official website (<a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=4385&amp;extra=page%3D1">MHP30</a> onto the unit and you're back to the old firmware. Downloads for the <code>.hex</code> files to flash are available on the <a href="https://github.com/Ralim/IronOS/releases">releases page.</a> The file you want is called MHP30.zip. Inside the zip file (make sure to extract the file before flashing with it) will be a file called <code>MHP30_{Language-Code}.hex</code>.</p>
<p>Officially the bootloader on the devices only works under Windows (use the built-in File Explorer, as alternative file managers or copy handlers like Teracopy will fail). However, users have reported that it does work under Mac, and can be made to work under Linux <em>sometimes</em>. Details over on the <a href="https://github.com/Ralim/IronOS/wiki/Upgrading-Firmware">wiki page</a>.</p>
<ol>
<li>Hold the button closest to the tip (MHP30 the left button on the back), and plug in the USB to the computer.</li>
<li>The unit will appear as a USB drive. (Screen will say <code>DFU</code> on it.)</li>
<li>Drag the <code>.hex</code> file onto the USB drive.</li>
<li>The unit will disconnect and reconnect.</li>
<li>The filename will have changed to end in <em>.RDY</em> or <em>.ERR</em></li>
<li>If it ends with <em>.RDY</em> you're done! Otherwise, something went wrong.</li>
<li>If it didn't work the first time, try copying the file again without disconnecting the device, often it will work on the second shot.</li>
<li>Disconnect the USB and power up the device. You're good to go.</li>
</ol>
<p>For the more adventurous out there, you can also load this firmware onto the device using an SWD programmer, for easier installation follow the guide at the end of this document.</p>
<p>On the USB-C port, <code>USB_D+</code> is shorted to <code>SWDIO</code> and <code>USB_D-</code> is shorted to <code>SWCLK</code> so debugging works without disassembly (attach while staying in the bootloader). Installing <a href="https://github.com/Ralim/IronOS-dfu">IronOS-dfu</a> is recommended as it allows reliable flashing of binary files with <a href="http://dfu-util.sourceforge.net/">dfu-util</a>.</p>
<p>Noting that for the MHP30 the stock firmware checks a checksum at the end of the first 8k that has to be valid or else it goes into "demo mode".</p>
<h2 id="mac">Mac</h2>
<p>sgr1ff1n (Shane) commented in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> that upgrading worked on their Mac as per normal:</p>
<blockquote>
<p>I just wanted to say that I was able to update the firmware on my ts100 from the stock version to 1.08 found in this repository using my Mac. I simply followed the same steps however through Finder. I have a MacBook Pro (13-inch, Mid 2012) running Sierra 10.12.4 (16E195).</p>
</blockquote>
<h2 id="linux">Linux</h2>
<p>While in the past there were reports of unreliable upgrades, the consensus in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> is that things work mostly as expected in Linux.</p>
<p>@awigen has contributed a script <a href="https://raw.githubusercontent.com/Ralim/IronOS/master/Flashing/flash_ts100_linux.sh">flash_ts100_linux.sh</a> that works on Ubuntu 16.04 as well as other distros.</p>
<p>If you want to do it manually (or if the script does not work for some reason) the general procedure is the same as for Windows, the differences are in the way to mount the unit and copy the firmware.
Remember that after flashing, the firmware filename will have changed to end in <code>.RDY</code> or <code>.ERR</code> or <code>.NOT</code> and only <code>.RDY</code> means the flashing was successful!</p>
<ul>
<li>The unit has to be mounted as <code>msdos</code> type (thanks @balrog-kun for having spotted it). You may disable automount, but unmounting the automounted drive and remounting as <code>msdos</code> works fine. You do not need to turn off automounting, but you do need to unmount the device with <code>umount</code>.</li>
<li>It is recommended to use an all-caps filename for the firmware, even if successful flashing were done with lower case names.</li>
<li>Avoid USB hubs, plug directly in your computer.</li>
<li>If it fails, try again several times without unplugging. Just let it remount.</li>
</ul>
<p>Example, to be run as root, once the unit has been plugged in DFU mode and auto-mounted:</p>
<pre><code class="language-bash">FW=ts100.hex
unset NAME
eval $(lsblk -P -p -d --output NAME,MODEL|grep &quot;DFU[ _]Disk&quot;)
[ -z ${NAME+x} ] &amp;&amp; exit 1 # Could not find DFU device
umount &quot;$NAME&quot;
mkdir /tmp/mntdfu
mount -t msdos &quot;$NAME&quot; /tmp/mntdfu
cp &quot;$FW&quot; &quot;/tmp/mntdfu/$(basename $FW|tr a-z A-Z)&quot;
sync
umount /tmp/mntdfu
rmdir /tmp/mntdfu
</code></pre>
<p>Device will reboot and automount will rerun if not disabled.
Check the extension of your firmware, it should be <code>.RDY</code> now.</p>
<h2 id="faq">FAQ</h2>
<h4 id="the-file-is-showing-up-with-the-extension-err">The file is showing up with the extension <code>.ERR</code></h4>
<p>This can occur during the programming process if any of the checks in the bootloader fail. This is often triggered by anti-virus software or using a non-Windows host OS.</p>
<p>First, try just copying the file a second time.</p>
<ol>
<li>Attach the iron in DFU mode.</li>
<li>Copy the <code>.hex</code> file to the device.</li>
<li>The device disconnects and connects with the <code>.ERR</code> file.</li>
<li>Copy the same <code>.hex</code> file again <strong>⛔ DO NOT TRY AND DELETE THE OLD ONE ⛔</strong>.</li>
<li>The device will disconnect and reconnect again.</li>
<li>The device <em>should</em> now have the <code>.RDY</code> file.</li>
<li>You're done.</li>
</ol>
<p>If this fails and you are on Mac or Linux reading the wiki page about programming can help. There is also a very long issue thread going through all of the different attempts around this too.</p>
<p>If you are on Windows, it's often best to try another computer (friends, work, partners etc.).</p>
<h4 id="device-randomly-disconnects-or-does-not-show-up-in-dfu-mode">Device randomly disconnects or does not show up in DFU mode</h4>
<ol>
<li>
<p>Check if the USB cable you are using has the data pins; test it on another device. There are a surprisingly large number of micro-USB cables that are power <em>only</em>.</p>
</li>
<li>
<p>Try other USB ports. Often different USB controllers will interact with the units differently due to design quirks in the Miniware design.</p>
</li>
</ol>
<h3 id="alternative-bootloader">Alternative bootloader</h3>
<p>If you are an advanced user, and you have used <code>usb-dfu</code> tools before, or you would like to learn; there is an alternative bootloader for these irons.
This will <strong>NOT</strong> show up as a USB storage drive, but instead show up using a standard DFU protocol device. You can then use dfu tools or GUIs to upgrade the iron using the <code>.bin</code> files that are posted to the releases page.</p>
<p>To install this alternative bootloader, follow the instructions <a href="https://github.com/Ralim/IronOS-dfu/blob/mainline/docs/Bootloader.md">here</a>.</p>
<p>Note that this is only recommended for users who know what they are doing. If you don't understand how this works, please don't flash this.</p>
</div>
</div><footer>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/ralim/IronOS/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
</span>
</div>
<script>var base_url = '../..';</script>
<script src="../../js/theme_extra.js" defer></script>
<script src="../../js/theme.js" defer></script>
<script src="../../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);
};
</script>
</body>
</html>

View File

@@ -3,23 +3,23 @@
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/" />
<link rel="shortcut icon" href="../img/favicon.ico" />
<title>Flashing the firmware - IronOS</title>
<link rel="stylesheet" href="../css/theme.css" />
<link rel="stylesheet" href="../css/theme_extra.css" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/" />
<link rel="shortcut icon" href="../../img/favicon.ico" />
<title>Flashing / Upgrading your iron - IronOS</title>
<link rel="stylesheet" href="../../css/theme.css" />
<link rel="stylesheet" href="../../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "Flashing the firmware";
var mkdocs_page_input_path = "Flashing.md";
var mkdocs_page_url = "/IronOS/Flashing/";
var mkdocs_page_name = "Flashing / Upgrading your iron";
var mkdocs_page_input_path = "Flashing/Pinecil V1.md";
var mkdocs_page_url = "/IronOS/Flashing/Pinecil%20V1/";
</script>
<script src="../js/jquery-3.6.0.min.js" defer></script>
<script src="../../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../js/html5shiv.min.js"></script>
<script src="../../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
@@ -31,9 +31,9 @@
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href=".." class="icon icon-home"> IronOS
<a href="../.." class="icon icon-home"> IronOS
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
@@ -41,65 +41,64 @@
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="..">Home</a>
<li class="toctree-l1"><a class="reference internal" href="../..">Home</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
<li class="toctree-l1"><a class="reference internal" href="../../GettingStarted/">Getting Started</a>
</li>
</ul>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal current" href="./">Flashing the firmware</a>
<ul class="current">
<li class="toctree-l2"><a class="reference internal" href="#downloading-source-file">Downloading source file</a>
<ul>
<li class="toctree-l3"><a class="reference internal" href="#main-release">Main release</a>
</li>
<li class="toctree-l3"><a class="reference internal" href="#bleeding-edge-latest">Bleeding edge / latest</a>
</li>
</ul>
</li>
</ul>
</li>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Menu/">Main Menu</a>
<li class="toctree-l1"><a class="reference internal" href="../../Menu/">Main Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Settings/">Settings</a>
<li class="toctree-l1"><a class="reference internal" href="../../Settings/">Settings</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../DebugMenu/">Debug Menu</a>
<li class="toctree-l1"><a class="reference internal" href="../../DebugMenu/">Debug Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Power/">Power</a>
<li class="toctree-l1"><a class="reference internal" href="../../Power/">Power</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Temperature/">Temperature</a>
<li class="toctree-l1"><a class="reference internal" href="../../Temperature/">Temperature</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Logo/">Startup Logo</a>
<li class="toctree-l1"><a class="reference internal" href="../../Logo/">Startup Logo</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Hardware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../HallSensor/">Hall Sensor (Pinecil)</a>
<li class="toctree-l1"><a class="reference internal" href="../../HallSensor/">Hall Sensor (Pinecil)</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Hardware/">Hardware Notes</a>
<li class="toctree-l1"><a class="reference internal" href="../../Hardware/">Hardware Notes</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="#">Troubleshooting</a>
<ul>
<li class="toctree-l2"><a class="reference internal" href="../Troubleshooting/">Troubleshooting</a>
<li class="toctree-l2"><a class="reference internal" href="../../Troubleshooting/">Troubleshooting</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="../HardwareIssues/">Known Hardware Issues</a>
<li class="toctree-l2"><a class="reference internal" href="../../HardwareIssues/">Known Hardware Issues</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Translation/">Translations</a>
<li class="toctree-l1"><a class="reference internal" href="../../Translation/">Translations</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Development/">Development</a>
<li class="toctree-l1"><a class="reference internal" href="../../Development/">Development</a>
</li>
</ul>
</div>
@@ -109,16 +108,16 @@
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="..">IronOS</a>
<a href="../..">IronOS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href=".." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing the firmware</li>
<li><a href="../.." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing / Upgrading your iron</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing.md"
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing/Pinecil V1.md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
@@ -145,62 +144,7 @@ Head to the <a href="https://github.com/Ralim/IronOS/actions">Actions</a> page a
In general you probably want <code>master</code>.</p>
<p>Once you click on a run, scroll down to the "Artifacts" section and then click on your model to download a zip file.
Then this works the same as a production release (use the correct file).</p>
<h1 id="miniware-devices-ts100-ts80-ts80p-mhp30">Miniware devices (TS100, TS80, TS80P &amp; MHP30)</h1>
<p>This is completely safe, but if it goes wrong just put the <code>.hex</code> file from the official website (<a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=868&amp;extra=page%3D1">TS100</a>, <a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=3202&amp;extra=page%3D1">TS80</a>, <a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=4070&amp;extra=page%3D1">TS80P</a> &amp; <a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=4385&amp;extra=page%3D1">MHP30</a>) onto the unit and you're back to the old firmware. Downloads for the <code>.hex</code> files to flash are available on the <a href="https://github.com/Ralim/IronOS/releases">releases page.</a> The file you want is called <em>(MODEL)_EN.hex</em> unless you want the translations, they are (MODEL)_<em>language short name</em>.hex. Where (MODEL) is either TS100 or TS80.</p>
<p>Officially the bootloader on the devices only works under Windows (use the built-in File Explorer, as alternative file managers or copy handlers like Teracopy will fail). However, users have reported that it does work under Mac, and can be made to work under Linux <em>sometimes</em>. Details over on the <a href="https://github.com/Ralim/ts100/wiki/Upgrading-Firmware">wiki page</a>.</p>
<ol>
<li>Hold the button closest to the tip (MHP30 the left button on the back), and plug in the USB to the computer.</li>
<li>The unit will appear as a USB drive. (Screen will say <code>DFU</code> on it.)</li>
<li>Drag the <code>.hex</code> file onto the USB drive.</li>
<li>The unit will disconnect and reconnect.</li>
<li>The filename will have changed to end in <em>.RDY</em> or <em>.ERR</em></li>
<li>If it ends with <em>.RDY</em> you're done! Otherwise, something went wrong.</li>
<li>If it didn't work the first time, try copying the file again without disconnecting the device, often it will work on the second shot.</li>
<li>Disconnect the USB and power up the device. You're good to go.</li>
</ol>
<p>For the more adventurous out there, you can also load this firmware onto the device using an SWD programmer, for easier installation follow the guide at the end of this document.</p>
<p>On the bottom of the MCU riser PCB, there are 4 pads for programming. On v2.51A PCB revision <code>USB_D+</code> is shorted to <code>SWDIO</code> and <code>USB_D-</code> is shorted to <code>SWCLK</code> so debugging works without disassembly (attach while staying in the bootloader). Installing <a href="https://github.com/Ralim/IronOS-dfu">IronOS-dfu</a> is recommended as it allows reliable flashing of binary files with <a href="http://dfu-util.sourceforge.net/">dfu-util</a>.</p>
<p>There is a complete device flash backup included in this repository. (Note this includes the bootloader, so will need an SWD programmer to load onto the unit).</p>
<p>For the TS80 the SWD pins are used for the QC negotiation, so you can actually connect to the SWD power via the USB connector.</p>
<h2 id="mac">Mac</h2>
<p>sgr1ff1n (Shane) commented in <a href="https://github.com/Ralim/ts100/issues/11">issue 11</a> that upgrading worked on their Mac as per normal:</p>
<blockquote>
<p>I just wanted to say that I was able to update the firmware on my ts100 from the stock version to 1.08 found in this repository using my Mac. I simply followed the same steps however through Finder. I have a MacBook Pro (13-inch, Mid 2012) running Sierra 10.12.4 (16E195).</p>
</blockquote>
<h2 id="linux">Linux</h2>
<p>While in the past there were reports of unreliable upgrades, the consensus in <a href="https://github.com/Ralim/ts100/issues/11">issue 11</a> is that things work mostly as expected in Linux.</p>
<p>@awigen has contributed a script <a href="https://raw.githubusercontent.com/Ralim/ts100/master/Flashing/flash_ts100_linux.sh">flash_ts100_linux.sh</a> that works on Ubuntu 16.04 as well as other distros.</p>
<p>If you want to do it manually (or if the script does not work for some reason) the general procedure is the same as for Windows, the differences are in the way to mount the unit and copy the firmware.
Remember that after flashing, the firmware filename will have changed to end in <code>.RDY</code> or <code>.ERR</code> or <code>.NOT</code> and only <code>.RDY</code> means the flashing was successful!</p>
<ul>
<li>The unit has to be mounted as <code>msdos</code> type (thanks @balrog-kun for having spotted it). You may disable automount, but unmounting the automounted drive and remounting as <code>msdos</code> works fine. You do not need to turn off automounting, but you do need to unmount the device with <code>umount</code>.</li>
<li>It is recommended to use an all-caps filename for the firmware, even if successful flashing were done with lower case names.</li>
<li>Avoid USB hubs, plug directly in your computer.</li>
<li>If it fails, try again several times without unplugging. Just let it remount.</li>
</ul>
<p>Example, to be run as root, once the unit has been plugged in DFU mode and auto-mounted:</p>
<pre><code class="language-bash">FW=ts100.hex
unset NAME
eval $(lsblk -P -p -d --output NAME,MODEL|grep &quot;DFU[ _]Disk&quot;)
[ -z ${NAME+x} ] &amp;&amp; exit 1 # Could not find DFU device
umount &quot;$NAME&quot;
mkdir /tmp/mntdfu
mount -t msdos &quot;$NAME&quot; /tmp/mntdfu
cp &quot;$FW&quot; &quot;/tmp/mntdfu/$(basename $FW|tr a-z A-Z)&quot;
sync
umount /tmp/mntdfu
rmdir /tmp/mntdfu
</code></pre>
<p>Device will reboot and automount will rerun if not disabled.
Check the extension of your firmware, it should be <code>.RDY</code> now.</p>
<h1 id="pinecil-v2-pine64">Pinecil V2 (Pine64)</h1>
<ul>
<li>The MCU in V2 is Bouffalo BL706 and does <em>not</em> use usb-dfu for flashing as the previous MCU did.</li>
<li>The current firmware (2.18) is very fresh and no upgrade is available/needed.</li>
<li>When an update is released for V2, then IronOS will also include an update method to follow.</li>
<li>Background on the <a href="https://lupyuen.github.io/articles/bl706">BL706 chipset</a></li>
</ul>
<h1 id="pinecil-v1-pine64">Pinecil V1 (Pine64)</h1>
<h1 id="pinecil-v1">Pinecil V1</h1>
<ul>
<li>The MCU used in Pinecil supports usb-dfu. Reference <a href="https://wiki.pine64.org/wiki/Pinecil">Pinecil Wiki</a>.</li>
<li>Recommended Updater: the <a href="https://github.com/pine64/pinecil-firmware-updater/releases">Pine64 Updater</a>, is an easy-to-use GUI app. It is fast and works in several types of OS, i.e. Windows/Mac. It will automatically fetch the newest stable version of IronOS from GitHub.</li>
@@ -208,11 +152,11 @@ Check the extension of your firmware, it should be <code>.RDY</code> now.</p>
<li>Community chat: if troubleshooting doesn't work, then join the Pine64 &gt; Pinecil channel. There are knowledgeable members in Discord/Telegram/Matrix. Discord has a bridge bot connection to Telegram and Matrix so that all pine volunteers/members can see advice for Pinecil and related items or just get tips on which Power supply to purchase.</li>
<li>One advantage of Pinecil is that you cannot permanently damage it doing a firmware update (because DFU is in ROM); an update could render Pinecil temporarily inoperable if you flash an invalid firmware. But no worries, simply re-flashing with a working firmware copy will fix everything.</li>
<li>USB-C cable is required to do an update. Generally, all USB controllers work, but some hubs have issues, so it is preferred to avoid USB hubs for updates.</li>
<li>Alternate Update Methods: if your OS is not currently supported by the <a href="https://github.com/pine64/pinecil-firmware-updater/releases">Updater</a> or it does not meet your needs, i.e., you want to install a beta version, the below manual methods may be used. </li>
<li>Alternate Update Methods: if your OS is not currently supported by the <a href="https://github.com/pine64/pinecil-firmware-updater/releases">Updater</a> or it does not meet your needs, i.e., you want to install a beta version, the below manual methods may be used.</li>
</ul>
<h2 id="linux-and-mac">Linux and Mac</h2>
<h3 id="steps">Steps</h3>
<p> Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<p>⛔ Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<ol>
<li>Highly recommend updating <code>dfu-util</code> to the newest version before starting.</li>
<li>Download and extract the firmware package from GitHub <a href="https://github.com/Ralim/IronOS/releases">IronOS Releases</a>.</li>
@@ -236,13 +180,11 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
<pre><code>dfu-util -D Pinecil_EN.dfu -a 0
</code></pre>
<ul>
<li>Note: if you use an older release of <code>dfu-util</code> and do not see <code>alt=0, name="@Internal Flash /0x08000000/128*001Kg"</code> when running <code>dfu-util -l</code> you likely will not be able to update without first updating 'dfu-util'.</li>
<li>If your update is crashing part-way into the update, there is sometimes an issue with older/fussy USB controllers (they can show up/disappear/then show up again)<ul>
<li>Note: if you use an older release of <code>dfu-util</code> and do not see <code>alt=0, name="@Internal Flash /0x08000000/128*001Kg"</code> when running <code>dfu-util -l</code> you likely will not be able to update without first updating 'dfu-util'.</li>
<li>If your update is crashing part-way into the update, there is sometimes an issue with older/fussy USB controllers (they can show up/disappear/then show up again)</li>
<li>Try a direct connection to the USB port, do not use a USB hub, and use shorter cable. If possible, pick a port connected to the main board.</li>
<li>Switch to a different PC/Laptop and use different ports. USB-C ports are recommended but some have also reported having a fussy C port.</li>
<li>Hold down the (-) button for the entire firmware update, do not release until near the end.</li>
</ul>
</li>
<li><code>DC Low</code> message: a pc/laptop cannot fully power Pinecil, it generally can only get 5 V (non-PD) to communicate for firmware updates and Pinecil will report 'DC Low'. This is normal.</li>
<li>If <code>dfu-util</code> aborts with an error like
<code>dfu-util: Cannot open DFU device 28e9:0189 found on devnum 42 (LIBUSB_ERROR_IO)</code>
@@ -268,7 +210,7 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
<p>Two Options for Windows</p>
<h3 id="option-1-use-command-line">Option 1: use command line</h3>
<h3 id="steps_1">Steps</h3>
<p> Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<p>⛔ Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<ol>
<li>Using command line <code>dfu-util</code> is similar to above for Linux / Mac.</li>
<li>Highly recommend updating <code>dfu-util</code> to the newest version.</li>
@@ -279,7 +221,7 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
<li>After the USB cable is connected at both ends, wait ~10 seconds more, then release the (-) button.</li>
<li>Open PowerShell or Command window.</li>
<li>Change to the directory of the unzipped firmware files</li>
<li>Using <code>dfu-util,</code> flash the firmware using a command like this:</li>
<li>Using <code>dfu-util,</code> flash the firmware using a command like this:</li>
</ol>
<pre><code>dfu-util -D Pinecil_EN.dfu
</code></pre>
@@ -288,7 +230,7 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
</ul>
<h3 id="option-2-use-the-gui-tool-from-chip-vendor">Option 2: use the GUI tool from chip vendor</h3>
<h3 id="steps_2">Steps</h3>
<p> Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<p>⛔ Do not use the DC barrel jack while updating firmware or you may destroy your PC. ⛔</p>
<ol>
<li>If you are uncomfortable with the command line, then this chip vendor supplied GUI tool/drivers is an option.</li>
<li>Download and extract the firmware package from GitHub <a href="https://github.com/Ralim/IronOS/releases">IronOS Releases</a>.</li>
@@ -306,9 +248,9 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
<li>At the top of the DFU tool, you should see <code>GD DFU DEVICE 1</code> appear if you successfully connected Pinecil.</li>
<li>If DFU Device box at top is blank, then Pinecil is not connected in DFU mode, repeat steps 3-11.</li>
<li>If it has been more than 10 seconds since you connected the USB cable, Release the (<code>-</code>) button. (don't use Upload from Device section)</li>
<li>Select <code>Download to device</code> &gt; Open &gt; Browse to folder you unzipped in step 2. </li>
<li>Select <code>Download to device</code> &gt; Open &gt; Browse to folder you unzipped in step 2.</li>
<li>Select the <code>hex</code> file for language. English is Pinecil_EN.hex , tick <code>Verify after download</code>.</li>
<li>Click <code>OK</code> at bottom. After a few minutes you will see 0-100%, Download successfully! Click <code>Leave DFU</code> at the top. </li>
<li>Click <code>OK</code> at bottom. After a few minutes you will see 0-100%, Download successfully! Click <code>Leave DFU</code> at the top.</li>
<li>Disconnect Pinecil cable from PC, plug it into a power supply.</li>
<li>Do not need to press any buttons, a new screen should appear.</li>
<li>
@@ -318,42 +260,9 @@ Found DFU: [28e9:0189] ver=0100, devnum=48, cfg=1, intf=0, path=&quot;1-1&quot;,
<p>If you have errors, see Troubleshooting <a href="https://ralim.github.io/IronOS/Flashing/#troubleshooting">above</a>.</p>
</li>
</ol>
<h2 id="faq">FAQ</h2>
<h4 id="miniware-the-file-is-showing-up-with-the-extension-err">[Miniware] The file is showing up with the extension <code>.ERR</code></h4>
<p>This can occur during the programming process if any of the checks in the bootloader fail. This is often triggered by anti-virus software or using a non-Windows host OS.</p>
<p>First, try just copying the file a second time.</p>
<ol>
<li>Attach the iron in DFU mode.</li>
<li>Copy the <code>.hex</code> file to the device.</li>
<li>The device disconnects and connects with the <code>.ERR</code> file.</li>
<li>Copy the same <code>.hex</code> file again <strong>⛔ DO NOT TRY AND DELETE THE OLD ONE ⛔</strong>.</li>
<li>The device will disconnect and reconnect again.</li>
<li>The device <em>should</em> now have the <code>.RDY</code> file.</li>
<li>You're done.</li>
</ol>
<p>If this fails and you are on Mac or Linux reading the wiki page about programming can help. There is also a very long issue thread going through all of the different attempts around this too.</p>
<p>If you are on Windows, it's often best to try another computer (friends, work, partners etc.).</p>
<h4 id="miniware-device-randomly-disconnects-or-does-not-show-up-in-dfu-mode">[Miniware] Device randomly disconnects or does not show up in DFU mode</h4>
<ol>
<li>
<p>Check if the USB cable you are using has the data pins; test it on another device. There are a surprisingly large number of micro-USB cables that are power <em>only</em>.</p>
</li>
<li>
<p>Try other USB ports. Often different USB controllers will interact with the units differently due to design quirks in the Miniware design.</p>
</li>
</ol>
<h3 id="miniware-alternative-bootloader">[Miniware] Alternative bootloader</h3>
<p>If you are an advanced user, and you have used <code>usb-dfu</code> tools before, or you would like to learn; there is an alternative bootloader for these irons.
This will <strong>NOT</strong> show up as a USB storage drive, but instead show up using a standard DFU protocol device. You can then use dfu tools or GUIs to upgrade the iron using the <code>.bin</code> files that are posted to the releases page.</p>
<p>To install this alternative bootloader, follow the instructions <a href="https://github.com/Ralim/IronOS-dfu/blob/mainline/docs/Bootloader.md">here</a>.</p>
<p>Note that this is only recommended for users who know what they are doing. If you don't understand how this works, please don't flash this.</p>
</div>
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href="../GettingStarted/" class="btn btn-neutral float-left" title="Getting Started"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../Menu/" class="btn btn-neutral float-right" title="Main Menu">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
<hr/>
@@ -379,17 +288,13 @@ This will <strong>NOT</strong> show up as a USB storage drive, but instead show
</span>
<span><a href="../GettingStarted/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../Menu/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
<script>var base_url = '..';</script>
<script src="../js/theme_extra.js" defer></script>
<script src="../js/theme.js" defer></script>
<script src="../search/main.js" defer></script>
<script>var base_url = '../..';</script>
<script src="../../js/theme_extra.js" defer></script>
<script src="../../js/theme.js" defer></script>
<script src="../../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);

View File

@@ -0,0 +1,196 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/Pinecil%20V2/" />
<link rel="shortcut icon" href="../../img/favicon.ico" />
<title>Flashing / Upgrading your iron - IronOS</title>
<link rel="stylesheet" href="../../css/theme.css" />
<link rel="stylesheet" href="../../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "Flashing / Upgrading your iron";
var mkdocs_page_input_path = "Flashing/Pinecil V2.md";
var mkdocs_page_url = "/IronOS/Flashing/Pinecil%20V2/";
</script>
<script src="../../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="../.." class="icon icon-home"> IronOS
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../..">Home</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Menu/">Main Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Settings/">Settings</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../DebugMenu/">Debug Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Power/">Power</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Temperature/">Temperature</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Logo/">Startup Logo</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Hardware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../HallSensor/">Hall Sensor (Pinecil)</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Hardware/">Hardware Notes</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="#">Troubleshooting</a>
<ul>
<li class="toctree-l2"><a class="reference internal" href="../../Troubleshooting/">Troubleshooting</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../HardwareIssues/">Known Hardware Issues</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Translation/">Translations</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Development/">Development</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../..">IronOS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../.." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing / Upgrading your iron</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing/Pinecil V2.md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<h1 id="flashing-upgrading-your-iron">Flashing / Upgrading your iron</h1>
<h2 id="downloading-source-file">Downloading source file</h2>
<p>In the development of this firmware, there are three <em>types</em> of firmware released.
These are the "Main" stable releases, which generally have high confidence in being bug free.
Release candidates are released slightly more often, and these are generally perfectly fine for everyday use. These are released early to allow for translation checking and for wonderful people to help spot bugs and regressions.
Finally, there are the "mainline" builds, which are built from the main git branch.
These are built on every change and can be found on the Actions tab (see below).</p>
<h3 id="main-release">Main release</h3>
<p>Main releases are made to the <a href="https://github.com/Ralim/IronOS/releases">releases page</a>.
Download the zip file that matches your model of soldering iron and extract it.
Select the appropriate file type for your unit, in general Miniware devices need <code>.hex</code> and Pinecil needs <code>.dfu</code>.
Flash according to details below</p>
<h3 id="bleeding-edge-latest">Bleeding edge / latest</h3>
<p>For the <em>latest</em> code, you will need to download the zip file from the artifacts page on the build for what you want.
Head to the <a href="https://github.com/Ralim/IronOS/actions">Actions</a> page and then select the run for the appropriate branch you would like.
In general you probably want <code>master</code>.</p>
<p>Once you click on a run, scroll down to the "Artifacts" section and then click on your model to download a zip file.
Then this works the same as a production release (use the correct file).</p>
<h1 id="pinecil-v2">Pinecil V2</h1>
<ul>
<li>The MCU in V2 is Bouffalo BL706 and does <em>not</em> use usb-dfu for flashing as the previous MCU did.</li>
<li>The current firmware (2.18) is very fresh and no upgrade is available/needed.</li>
<li>When an update is released for V2, then IronOS will also include an update method to follow.</li>
<li>Background on the <a href="https://lupyuen.github.io/articles/bl706">BL706 chipset</a></li>
</ul>
</div>
</div><footer>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/ralim/IronOS/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
</span>
</div>
<script>var base_url = '../..';</script>
<script src="../../js/theme_extra.js" defer></script>
<script src="../../js/theme.js" defer></script>
<script src="../../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);
};
</script>
</body>
</html>

265
Flashing/TS100/index.html Normal file
View File

@@ -0,0 +1,265 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/TS100/" />
<link rel="shortcut icon" href="../../img/favicon.ico" />
<title>Flashing / Upgrading your iron - IronOS</title>
<link rel="stylesheet" href="../../css/theme.css" />
<link rel="stylesheet" href="../../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "Flashing / Upgrading your iron";
var mkdocs_page_input_path = "Flashing/TS100.md";
var mkdocs_page_url = "/IronOS/Flashing/TS100/";
</script>
<script src="../../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="../.." class="icon icon-home"> IronOS
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../..">Home</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Menu/">Main Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Settings/">Settings</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../DebugMenu/">Debug Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Power/">Power</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Temperature/">Temperature</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Logo/">Startup Logo</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Hardware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../HallSensor/">Hall Sensor (Pinecil)</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Hardware/">Hardware Notes</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="#">Troubleshooting</a>
<ul>
<li class="toctree-l2"><a class="reference internal" href="../../Troubleshooting/">Troubleshooting</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../HardwareIssues/">Known Hardware Issues</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Translation/">Translations</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Development/">Development</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../..">IronOS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../.." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing / Upgrading your iron</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing/TS100.md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<h1 id="flashing-upgrading-your-iron">Flashing / Upgrading your iron</h1>
<h2 id="downloading-source-file">Downloading source file</h2>
<p>In the development of this firmware, there are three <em>types</em> of firmware released.
These are the "Main" stable releases, which generally have high confidence in being bug free.
Release candidates are released slightly more often, and these are generally perfectly fine for everyday use. These are released early to allow for translation checking and for wonderful people to help spot bugs and regressions.
Finally, there are the "mainline" builds, which are built from the main git branch.
These are built on every change and can be found on the Actions tab (see below).</p>
<h3 id="main-release">Main release</h3>
<p>Main releases are made to the <a href="https://github.com/Ralim/IronOS/releases">releases page</a>.
Download the zip file that matches your model of soldering iron and extract it.
Select the appropriate file type for your unit, in general Miniware devices need <code>.hex</code> and Pinecil needs <code>.dfu</code>.
Flash according to details below</p>
<h3 id="bleeding-edge-latest">Bleeding edge / latest</h3>
<p>For the <em>latest</em> code, you will need to download the zip file from the artifacts page on the build for what you want.
Head to the <a href="https://github.com/Ralim/IronOS/actions">Actions</a> page and then select the run for the appropriate branch you would like.
In general you probably want <code>master</code>.</p>
<p>Once you click on a run, scroll down to the "Artifacts" section and then click on your model to download a zip file.
Then this works the same as a production release (use the correct file).</p>
<h1 id="ts100">TS100</h1>
<p>This is completely safe, but if it goes wrong just put the <code>.hex</code> file from the official website (<a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=868&amp;extra=page%3D1">TS100</a> onto the unit and you're back to the old firmware. Downloads for the <code>.hex</code> files to flash are available on the <a href="https://github.com/Ralim/IronOS/releases">releases page.</a> The file you want is called TS100.zip. Inside the zip file (make sure to extract the file before flashing with it) will be a file called <code>TS100_{Language-Code}.hex</code>.</p>
<p>Officially the bootloader on the devices only works under Windows (use the built-in File Explorer, as alternative file managers or copy handlers like Teracopy will fail). However, users have reported that it does work under Mac, and can be made to work under Linux <em>sometimes</em>. Details over on the <a href="https://github.com/Ralim/IronOS/wiki/Upgrading-Firmware">wiki page</a>.</p>
<ol>
<li>Hold the button closest to the tip (MHP30 the left button on the back), and plug in the USB to the computer.</li>
<li>The unit will appear as a USB drive. (Screen will say <code>DFU</code> on it.)</li>
<li>Drag the <code>.hex</code> file onto the USB drive.</li>
<li>The unit will disconnect and reconnect.</li>
<li>The filename will have changed to end in <em>.RDY</em> or <em>.ERR</em></li>
<li>If it ends with <em>.RDY</em> you're done! Otherwise, something went wrong.</li>
<li>If it didn't work the first time, try copying the file again without disconnecting the device, often it will work on the second shot.</li>
<li>Disconnect the USB and power up the device. You're good to go.</li>
</ol>
<p>For the more adventurous out there, you can also load this firmware onto the device using an SWD programmer, for easier installation follow the guide at the end of this document.</p>
<p>On the bottom of the MCU riser PCB, there are 4 pads for programming. On v2.51A PCB revision <code>USB_D+</code> is shorted to <code>SWDIO</code> and <code>USB_D-</code> is shorted to <code>SWCLK</code> so debugging works without disassembly (attach while staying in the bootloader). Installing <a href="https://github.com/Ralim/IronOS-dfu">IronOS-dfu</a> is recommended as it allows reliable flashing of binary files with <a href="http://dfu-util.sourceforge.net/">dfu-util</a>.</p>
<p>On some newer TS100 units, the SWD pins are wired up to the USB pins, on older ones they are not sadly.</p>
<h2 id="mac">Mac</h2>
<p>sgr1ff1n (Shane) commented in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> that upgrading worked on their Mac as per normal:</p>
<blockquote>
<p>I just wanted to say that I was able to update the firmware on my ts100 from the stock version to 1.08 found in this repository using my Mac. I simply followed the same steps however through Finder. I have a MacBook Pro (13-inch, Mid 2012) running Sierra 10.12.4 (16E195).</p>
</blockquote>
<h2 id="linux">Linux</h2>
<p>While in the past there were reports of unreliable upgrades, the consensus in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> is that things work mostly as expected in Linux.</p>
<p>@awigen has contributed a script <a href="https://raw.githubusercontent.com/Ralim/IronOS/master/Flashing/flash_ts100_linux.sh">flash_ts100_linux.sh</a> that works on Ubuntu 16.04 as well as other distros.</p>
<p>If you want to do it manually (or if the script does not work for some reason) the general procedure is the same as for Windows, the differences are in the way to mount the unit and copy the firmware.
Remember that after flashing, the firmware filename will have changed to end in <code>.RDY</code> or <code>.ERR</code> or <code>.NOT</code> and only <code>.RDY</code> means the flashing was successful!</p>
<ul>
<li>The unit has to be mounted as <code>msdos</code> type (thanks @balrog-kun for having spotted it). You may disable automount, but unmounting the automounted drive and remounting as <code>msdos</code> works fine. You do not need to turn off automounting, but you do need to unmount the device with <code>umount</code>.</li>
<li>It is recommended to use an all-caps filename for the firmware, even if successful flashing were done with lower case names.</li>
<li>Avoid USB hubs, plug directly in your computer.</li>
<li>If it fails, try again several times without unplugging. Just let it remount.</li>
</ul>
<p>Example, to be run as root, once the unit has been plugged in DFU mode and auto-mounted:</p>
<pre><code class="language-bash">FW=ts100.hex
unset NAME
eval $(lsblk -P -p -d --output NAME,MODEL|grep &quot;DFU[ _]Disk&quot;)
[ -z ${NAME+x} ] &amp;&amp; exit 1 # Could not find DFU device
umount &quot;$NAME&quot;
mkdir /tmp/mntdfu
mount -t msdos &quot;$NAME&quot; /tmp/mntdfu
cp &quot;$FW&quot; &quot;/tmp/mntdfu/$(basename $FW|tr a-z A-Z)&quot;
sync
umount /tmp/mntdfu
rmdir /tmp/mntdfu
</code></pre>
<p>Device will reboot and automount will rerun if not disabled.
Check the extension of your firmware, it should be <code>.RDY</code> now.</p>
<h2 id="faq">FAQ</h2>
<h4 id="the-file-is-showing-up-with-the-extension-err">The file is showing up with the extension <code>.ERR</code></h4>
<p>This can occur during the programming process if any of the checks in the bootloader fail. This is often triggered by anti-virus software or using a non-Windows host OS.</p>
<p>First, try just copying the file a second time.</p>
<ol>
<li>Attach the iron in DFU mode.</li>
<li>Copy the <code>.hex</code> file to the device.</li>
<li>The device disconnects and connects with the <code>.ERR</code> file.</li>
<li>Copy the same <code>.hex</code> file again <strong>⛔ DO NOT TRY AND DELETE THE OLD ONE ⛔</strong>.</li>
<li>The device will disconnect and reconnect again.</li>
<li>The device <em>should</em> now have the <code>.RDY</code> file.</li>
<li>You're done.</li>
</ol>
<p>If this fails and you are on Mac or Linux reading the wiki page about programming can help. There is also a very long issue thread going through all of the different attempts around this too.</p>
<p>If you are on Windows, it's often best to try another computer (friends, work, partners etc.).</p>
<h4 id="device-randomly-disconnects-or-does-not-show-up-in-dfu-mode">Device randomly disconnects or does not show up in DFU mode</h4>
<ol>
<li>
<p>Check if the USB cable you are using has the data pins; test it on another device. There are a surprisingly large number of micro-USB cables that are power <em>only</em>.</p>
</li>
<li>
<p>Try other USB ports. Often different USB controllers will interact with the units differently due to design quirks in the Miniware design.</p>
</li>
</ol>
<h3 id="alternative-bootloader">Alternative bootloader</h3>
<p>If you are an advanced user, and you have used <code>usb-dfu</code> tools before, or you would like to learn; there is an alternative bootloader for these irons.
This will <strong>NOT</strong> show up as a USB storage drive, but instead show up using a standard DFU protocol device. You can then use dfu tools or GUIs to upgrade the iron using the <code>.bin</code> files that are posted to the releases page.</p>
<p>To install this alternative bootloader, follow the instructions <a href="https://github.com/Ralim/IronOS-dfu/blob/mainline/docs/Bootloader.md">here</a>.</p>
<p>Note that this is only recommended for users who know what they are doing. If you don't understand how this works, please don't flash this.</p>
</div>
</div><footer>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/ralim/IronOS/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
</span>
</div>
<script>var base_url = '../..';</script>
<script src="../../js/theme_extra.js" defer></script>
<script src="../../js/theme.js" defer></script>
<script src="../../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);
};
</script>
</body>
</html>

283
Flashing/TS80(P)/index.html Normal file
View File

@@ -0,0 +1,283 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><link rel="canonical" href="https://ralim.github.io/IronOS/Flashing/TS80%28P%29/" />
<link rel="shortcut icon" href="../../img/favicon.ico" />
<title>TS80(P) - IronOS</title>
<link rel="stylesheet" href="../../css/theme.css" />
<link rel="stylesheet" href="../../css/theme_extra.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
<script>
// Current page data
var mkdocs_page_name = "TS80(P)";
var mkdocs_page_input_path = "Flashing/TS80(P).md";
var mkdocs_page_url = "/IronOS/Flashing/TS80%28P%29/";
</script>
<script src="../../js/jquery-3.6.0.min.js" defer></script>
<!--[if lt IE 9]>
<script src="../../js/html5shiv.min.js"></script>
<![endif]-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-scroll">
<div class="wy-side-nav-search">
<a href="../.." class="icon icon-home"> IronOS
</a><div role="search">
<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" title="Type search term here" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../..">Home</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul class="current">
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1 current"><a class="reference internal current" href="./">TS80(P)</a>
<ul class="current">
<li class="toctree-l2"><a class="reference internal" href="#downloading-source-file">Downloading source file</a>
<ul>
<li class="toctree-l3"><a class="reference internal" href="#main-release">Main release</a>
</li>
<li class="toctree-l3"><a class="reference internal" href="#bleeding-edge-latest">Bleeding edge / latest</a>
</li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Menu/">Main Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Settings/">Settings</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../DebugMenu/">Debug Menu</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Power/">Power</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Temperature/">Temperature</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Logo/">Startup Logo</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Hardware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../HallSensor/">Hall Sensor (Pinecil)</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../Hardware/">Hardware Notes</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="#">Troubleshooting</a>
<ul>
<li class="toctree-l2"><a class="reference internal" href="../../Troubleshooting/">Troubleshooting</a>
</li>
<li class="toctree-l2"><a class="reference internal" href="../../HardwareIssues/">Known Hardware Issues</a>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Translation/">Translations</a>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../Development/">Development</a>
</li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../..">IronOS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../.." class="icon icon-home" alt="Docs"></a> &raquo;</li>
<li>Flashing the firmware &raquo;</li>
<li>TS80(P)</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/ralim/IronOS/edit/master/docs/Flashing/TS80(P).md"
class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div class="section" itemprop="articleBody">
<h1 id="flashing-upgrading-your-iron">Flashing / Upgrading your iron</h1>
<h2 id="downloading-source-file">Downloading source file</h2>
<p>In the development of this firmware, there are three <em>types</em> of firmware released.
These are the "Main" stable releases, which generally have high confidence in being bug free.
Release candidates are released slightly more often, and these are generally perfectly fine for everyday use. These are released early to allow for translation checking and for wonderful people to help spot bugs and regressions.
Finally, there are the "mainline" builds, which are built from the main git branch.
These are built on every change and can be found on the Actions tab (see below).</p>
<h3 id="main-release">Main release</h3>
<p>Main releases are made to the <a href="https://github.com/Ralim/IronOS/releases">releases page</a>.
Download the zip file that matches your model of soldering iron and extract it.
Select the appropriate file type for your unit, in general Miniware devices need <code>.hex</code> and Pinecil needs <code>.dfu</code>.
Flash according to details below</p>
<h3 id="bleeding-edge-latest">Bleeding edge / latest</h3>
<p>For the <em>latest</em> code, you will need to download the zip file from the artifacts page on the build for what you want.
Head to the <a href="https://github.com/Ralim/IronOS/actions">Actions</a> page and then select the run for the appropriate branch you would like.
In general you probably want <code>master</code>.</p>
<p>Once you click on a run, scroll down to the "Artifacts" section and then click on your model to download a zip file.
Then this works the same as a production release (use the correct file).</p>
<h1 id="ts80-ts80p">TS80 / TS80P</h1>
<p>This is completely safe, but if it goes wrong just put the <code>.hex</code> file from the official website (<a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=868&amp;extra=page%3D1">TS80</a>/<a href="https://www.minidso.com/forum.php?mod=viewthread&amp;tid=4070&amp;extra=page%3D1">TS80P</a> onto the unit and you're back to the old firmware. Downloads for the <code>.hex</code> files to flash are available on the <a href="https://github.com/Ralim/IronOS/releases">releases page.</a> The file you want is called TS80.zip or TS80P.zip. Inside the zip file (make sure to extract the file before flashing with it) will be a file called <code>TS80_{Language-Code}.hex</code>/<code>TS80P_{Language-Code}.hex</code>.</p>
<p>Officially the bootloader on the devices only works under Windows (use the built-in File Explorer, as alternative file managers or copy handlers like Teracopy will fail). However, users have reported that it does work under Mac, and can be made to work under Linux <em>sometimes</em>. Details over on the <a href="https://github.com/Ralim/TS80/wiki/Upgrading-Firmware">wiki page</a>.</p>
<ol>
<li>Hold the button closest to the tip (MHP30 the left button on the back), and plug in the USB to the computer.</li>
<li>The unit will appear as a USB drive. (Screen will say <code>DFU</code> on it.)</li>
<li>Drag the <code>.hex</code> file onto the USB drive.</li>
<li>The unit will disconnect and reconnect.</li>
<li>The filename will have changed to end in <em>.RDY</em> or <em>.ERR</em></li>
<li>If it ends with <em>.RDY</em> you're done! Otherwise, something went wrong.</li>
<li>If it didn't work the first time, try copying the file again without disconnecting the device, often it will work on the second shot.</li>
<li>Disconnect the USB and power up the device. You're good to go.</li>
</ol>
<p>For the more adventurous out there, you can also load this firmware onto the device using an SWD programmer, for easier installation follow the guide at the end of this document.</p>
<p>On the USB port, <code>USB_D+</code> is shorted to <code>SWDIO</code> and <code>USB_D-</code> is shorted to <code>SWCLK</code> so debugging works without disassembly (attach while staying in the bootloader). Installing <a href="https://github.com/Ralim/IronOS-dfu">IronOS-dfu</a> is recommended as it allows reliable flashing of binary files with <a href="http://dfu-util.sourceforge.net/">dfu-util</a>.</p>
<h2 id="mac">Mac</h2>
<p>sgr1ff1n (Shane) commented in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> that upgrading worked on their Mac as per normal:</p>
<blockquote>
<p>I just wanted to say that I was able to update the firmware on my TS100 from the stock version to 1.08 found in this repository using my Mac. I simply followed the same steps however through Finder. I have a MacBook Pro (13-inch, Mid 2012) running Sierra 10.12.4 (16E195).</p>
</blockquote>
<h2 id="linux">Linux</h2>
<p>While in the past there were reports of unreliable upgrades, the consensus in <a href="https://github.com/Ralim/IronOS/issues/11">issue 11</a> is that things work mostly as expected in Linux.</p>
<p>@awigen has contributed a script <a href="https://raw.githubusercontent.com/Ralim/IronOS/master/Flashing/flash_TS100_linux.sh">flash_TS100_linux.sh</a> that works on Ubuntu 16.04 as well as other distros.</p>
<p>If you want to do it manually (or if the script does not work for some reason) the general procedure is the same as for Windows, the differences are in the way to mount the unit and copy the firmware.
Remember that after flashing, the firmware filename will have changed to end in <code>.RDY</code> or <code>.ERR</code> or <code>.NOT</code> and only <code>.RDY</code> means the flashing was successful!</p>
<ul>
<li>The unit has to be mounted as <code>msdos</code> type (thanks @balrog-kun for having spotted it). You may disable automount, but unmounting the automounted drive and remounting as <code>msdos</code> works fine. You do not need to turn off automounting, but you do need to unmount the device with <code>umount</code>.</li>
<li>It is recommended to use an all-caps filename for the firmware, even if successful flashing were done with lower case names.</li>
<li>Avoid USB hubs, plug directly in your computer.</li>
<li>If it fails, try again several times without unplugging. Just let it remount.</li>
</ul>
<p>Example, to be run as root, once the unit has been plugged in DFU mode and auto-mounted:</p>
<pre><code class="language-bash">FW=TS80.hex
unset NAME
eval $(lsblk -P -p -d --output NAME,MODEL|grep &quot;DFU[ _]Disk&quot;)
[ -z ${NAME+x} ] &amp;&amp; exit 1 # Could not find DFU device
umount &quot;$NAME&quot;
mkdir /tmp/mntdfu
mount -t msdos &quot;$NAME&quot; /tmp/mntdfu
cp &quot;$FW&quot; &quot;/tmp/mntdfu/$(basename $FW|tr a-z A-Z)&quot;
sync
umount /tmp/mntdfu
rmdir /tmp/mntdfu
</code></pre>
<p>Device will reboot and automount will rerun if not disabled.
Check the extension of your firmware, it should be <code>.RDY</code> now.</p>
<h2 id="faq">FAQ</h2>
<h4 id="the-file-is-showing-up-with-the-extension-err">The file is showing up with the extension <code>.ERR</code></h4>
<p>This can occur during the programming process if any of the checks in the bootloader fail. This is often triggered by anti-virus software or using a non-Windows host OS.</p>
<p>First, try just copying the file a second time.</p>
<ol>
<li>Attach the iron in DFU mode.</li>
<li>Copy the <code>.hex</code> file to the device.</li>
<li>The device disconnects and connects with the <code>.ERR</code> file.</li>
<li>Copy the same <code>.hex</code> file again <strong>⛔ DO NOT TRY AND DELETE THE OLD ONE ⛔</strong>.</li>
<li>The device will disconnect and reconnect again.</li>
<li>The device <em>should</em> now have the <code>.RDY</code> file.</li>
<li>You're done.</li>
</ol>
<p>If this fails and you are on Mac or Linux reading the wiki page about programming can help. There is also a very long issue thread going through all of the different attempts around this too.</p>
<p>If you are on Windows, it's often best to try another computer (friends, work, partners etc.).</p>
<h4 id="device-randomly-disconnects-or-does-not-show-up-in-dfu-mode">Device randomly disconnects or does not show up in DFU mode</h4>
<ol>
<li>
<p>Check if the USB cable you are using has the data pins; test it on another device. There are a surprisingly large number of micro-USB cables that are power <em>only</em>.</p>
</li>
<li>
<p>Try other USB ports. Often different USB controllers will interact with the units differently due to design quirks in the Miniware design.</p>
</li>
</ol>
<h3 id="alternative-bootloader">Alternative bootloader</h3>
<p>If you are an advanced user, and you have used <code>usb-dfu</code> tools before, or you would like to learn; there is an alternative bootloader for these irons.
This will <strong>NOT</strong> show up as a USB storage drive, but instead show up using a standard DFU protocol device. You can then use dfu tools or GUIs to upgrade the iron using the <code>.bin</code> files that are posted to the releases page.</p>
<p>To install this alternative bootloader, follow the instructions <a href="https://github.com/Ralim/IronOS-dfu/blob/mainline/docs/Bootloader.md">here</a>.</p>
<p>Note that this is only recommended for users who know what they are doing. If you don't understand how this works, please don't flash this.</p>
</div>
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href="../../GettingStarted/" class="btn btn-neutral float-left" title="Getting Started"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../../Menu/" class="btn btn-neutral float-right" title="Main Menu">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
<hr/>
<div role="contentinfo">
<!-- Copyright etc -->
</div>
Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span>
<a href="https://github.com/ralim/IronOS/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
</span>
<span><a href="../../GettingStarted/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../../Menu/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
<script>var base_url = '../..';</script>
<script src="../../js/theme_extra.js" defer></script>
<script src="../../js/theme.js" defer></script>
<script src="../../search/main.js" defer></script>
<script defer>
window.onload = function () {
SphinxRtdTheme.Navigation.enable(true);
};
</script>
</body>
</html>

View File

@@ -70,9 +70,18 @@
</ul>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
@@ -190,7 +199,7 @@ The rear button (<code>-/B</code>) is pressed to enter the menu and scrolls down
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href=".." class="btn btn-neutral float-left" title="Home"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../Flashing/" class="btn btn-neutral float-right" title="Flashing the firmware">Next <span class="icon icon-circle-arrow-right"></span></a>
<a href="../Flashing/TS80%28P%29/" class="btn btn-neutral float-right" title="TS80(P)">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
<hr/>
@@ -220,7 +229,7 @@ The rear button (<code>-/B</code>) is pressed to enter the menu and scrolls down
<span><a href=".." style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../Flashing/" style="color: #fcfcfc">Next &raquo;</a></span>
<span><a href="../Flashing/TS80%28P%29/" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
@@ -134,7 +143,7 @@
<p>Inside the <a href="https://ralim.github.io/IronOS/Settings/#setting-sleep-temp">Sleep Menu</a> is an additional type of sleep setting. Pinecil has an unpopulated footprint (<strong>U14</strong>) for a hall effect sensor, Silicon Labs <strong>Si7210-B-00-IV</strong>. After installing the hall effect sensor (HES), it is possible to auto-trigger Pinecil to enter sleep mode when it enters the stand, and <em>Zzzz</em> will appear (or text in detailed mode). This could be a fun enhancement for any Pinecil and adds a feature typically only found in more expensive high-end irons. The HES is available at many electronic stores for ~$2-$6.</p>
<p>After installing the HES on the PCB, place a magnet on the stand close enough to the sensor to activate one of ten user selectable settings.</p>
<ul>
<li>0=off, 1=1000, 2=750, 3=500, 4=250, 5=150, 6=100, 7=75, 8=50, 9=25 (9 has the highest sensitivity to magnets)</li>
<li>0=off, 1=1000, 2=750, 3=500, 4=250, 5=150, 6=100, 7=75, 8=50, 9=25 (9 has the highest sensitivity to magnets)</li>
<li>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.</li>
<li>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.</li>
<li>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.</li>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul class="current">
@@ -188,7 +197,7 @@ Note that cutoff messages can also be triggered by using a power supply that is
</div>
</div><footer>
<div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
<a href="../Flashing/" class="btn btn-neutral float-left" title="Flashing the firmware"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../Flashing/TS80%28P%29/" class="btn btn-neutral float-left" title="TS80(P)"><span class="icon icon-circle-arrow-left"></span> Previous</a>
<a href="../Settings/" class="btn btn-neutral float-right" title="Settings">Next <span class="icon icon-circle-arrow-right"></span></a>
</div>
@@ -216,7 +225,7 @@ Note that cutoff messages can also be triggered by using a power supply that is
</span>
<span><a href="../Flashing/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../Flashing/TS80%28P%29/" style="color: #fcfcfc">&laquo; Previous</a></span>
<span><a href="../Settings/" style="color: #fcfcfc">Next &raquo;</a></span>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul class="current">

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul class="current">

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul class="current">

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -48,9 +48,18 @@
<li class="toctree-l1"><a class="reference internal" href="../GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="../Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="../Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

View File

@@ -58,9 +58,18 @@
<li class="toctree-l1"><a class="reference internal" href="GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>
@@ -299,5 +308,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 10:52:11.245201+00:00
Build Date UTC : 2022-09-21 11:20:41.328867+00:00
-->

View File

@@ -41,9 +41,18 @@
<li class="toctree-l1"><a class="reference internal" href="./GettingStarted/">Getting Started</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Flashing the firmware</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="./Flashing/">Flashing the firmware</a>
</li>
<li class="toctree-l1"><a class="" href="MHP30:Flashing/MP30.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="./Pinecil V1:Flashing/Pinecil V1.md">None</a>
</li>
<li class="toctree-l1"><a class="" href="./Pinecil V2:Flashing/Pinecil V2.md">None</a>
</li>
<li class="toctree-l1"><a class="reference internal" href="./Flashing/TS80%28P%29/">TS80(P)</a>
</li>
<li class="toctree-l1"><a class="" href="TS100:Flashing/TS100.md">None</a>
</li>
</ul>
<p class="caption"><span class="caption-text">Operation</span></p>
<ul>

File diff suppressed because one or more lines are too long

View File

@@ -15,11 +15,6 @@
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/GettingStarted/</loc>
<lastmod>2022-09-21</lastmod>
@@ -80,4 +75,29 @@
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/MHP30/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/Pinecil%20V2/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/TS100/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://ralim.github.io/IronOS/Flashing/TS80%28P%29/</loc>
<lastmod>2022-09-21</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>

Binary file not shown.