PINE64 - User contributions [en]

Pinecil Power Supplies

2022-12-15T13:56:18Z

Ondronr: Add Notebook AC Adapter Lenovo ADLX95YCC3A (PD@20V)

== Power Options for Pinecil ==
==== Overview ====
# Using a power supply that is at the higher end of the Voltage/Amps requirements will give faster heating and performance.

'''Pinecil can use:'''
# Any Usb-C power supply that supports PD (Power Delivery) and has at least the minimum Volt/amps listed. The Usb-C PD65W, 3.25A, 20V is recommended, but a lower PD45W will also work on V1).
# Any quality "center positive" DC barrel 12-21V battery or power supply using a DC 5525 (5.5mm outer diameter, 2.5mm post) [https://www.youtube.com/watch?v=5DBTNplNTfA see Video on '''center-positive polarity''']. It is sometimes better to get a used name brand laptop brick Dell/Lenovo/HP etc., over a cheap brick which could have voltage spikes that damage the pinecil or other electronics.
# V2 can handle a DC barrel supply up to 24V without modyfying the PCB (always check polarity, must be a center-positive jack).
# Any typical tool battery 18V-21V, see tool battery section for details.
# QC3.0: not recommended, it is weaker and does not auto-negotiate like Usb-C PD. Minimum of 3 amps is needed and many QC phone chargers are only able to provide a low 12V 1.5amp, limiting Pinecil to about 17W of thermal capability which is weak and slow. It may not even start to heat, but if it does, it may get repeated "Thermal Runaway" message (this means the weak power causes Pinecil to auto-shutdown).
# QC is more problematic for V2 which comes with the special shorter 6.2 ohm resistance tip. This means the V2 needs more power than the V1. Switching to a longer tip in V2 would reduce the power requirement a little, but then you lose a small amount of heat speed/performance.
# Magnetic tip USB-C cables are not recommended, and not USB compliant

==== Troubleshooting QC chargers ====
# older QC 2.0 chargers are not supported, check if your charger is at least QC3.0.
# Some QC power adapters only allow a limited time for QC negotiation, otherwise voltage will fall back to 5V. 
# To address this, starting from firmware v2.16+, there is a PD timeout setting (in 100ms steps) which allows QC negotiation to start earlier. Change this only if you are having issues with your QC charger. (Power Settings > PD timeout) 
# This enables some QC adapters to work (i.e., some Baseus QC chargers). Alternately, lowering the number may result in problems with PD negotiation on some PD type adapters that are slower to negotiate. If you switch between QC & PD adaptors, you may have to change this setting.
# For certain QC adapters, lowering the PD timeout value to 15 could help, and most PD adapters will also still work using 15. If a PD charger does not work at 15, then increase the timeout (PD defaut is 20 = 20x 100ms = 2 seconds). Note that some QC chargers simply will not work, are too weak, or cheaply made.

=== How to Test if my charger will work? ===
As long as you do the following you should be fine:
# Don't plug in something that is higher voltage than the official ratings for V1 (21v limit) or V2 (24V limit).
# if using a DC barrel charger, '''check the Polarity first''', must be center positive ([https://www.youtube.com/watch?v=5DBTNplNTfA see Video])
# use a known good quality cable that will not short.
# if the Pinecil heats up very slowly or gets "Thermal Runaway" message, then the charger is too weak, get something else.
# Phone chargers are too weak, most are only 12V 1.5 amps which is too low.
# QC 2.0 not supported at all by IronOS firmware (only QC 3.0).
# most PC & laptop ports don't work as they are only 5V. 5V is good enough for simple Firmware update but not to provide the constant higher power an "resistance" type of soldering Iron needs to run and maintain heat.
# Check the specs on your laptop/PC ports and charger ports, most of the time when it doesn't work, it's because the rating is very low on it and not designed to power an Iron (check specified Watts, Volts, Amps on the port and see if they meet the minimum needed by Pinecil).

=== Links to Chargers/Batteries ===
This is a very small list compared to all the possible chargers that work, and new chargers come on the market all the time.

PD/QC/DC Barrel Chargers/Batteries/Cables

==== Usb-C Cables ====
* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with usb 20V chargers and have been tested with Pinecil.
# [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
# [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
# [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
# [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]

* EPR PD 3.1 Usb-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** There are no silicone 240W cables available yet. The below cables have been tested to work, but are not silicone.

** [https://a.co/25QgL0E certified 240W+Low speed data] Club 3D (slower usb2 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], coupon $25 off, highest USB-IF data speed, 40Gbps, USB 4 Gen3
*** (if amazon promo is expired, or from EU/other country, scroll all the way to the bottom of page, and click on paypal to buy directly).

==== Usb-C Charger ====
[[File:USB_C_PD65_Shared_Power_Chargers.jpeg|300px|thumb|right| Many multi-port Usb-C chargers give 65w-20v-3amps+ Only when using the single top port. For the best performance on these chargers, only use the single top port with Pinecil. ]]

* [https://pine64.com/product-category/pinepower/ PD120w PinePower Desktop w/Grounded 3-pin plug] (PD@20V)
* [https://pine64.com/product/pinepower-65w-gan-2c1a-charger-with-international-plugs/ PD65w Pinepower Portable Travel charger] (PD@20V)
* [https://www.amazon.com/dp/B09GK6QY1K Cirtek 65W charger 3-port] (PD@20V)
* [https://www.amazon.com/Charger-Cirtek-Compatible-MacBook-iPhone/dp/B09HKLXB1Z Cirtek 100W 4-port] $10 off as of Oct. 14, '22 (PD@20V)
* [https://a.co/d/5Ai1McE EfaithFix PD65W, 3-port] (PD@20V)
* [https://www.amazon.com/Charger-HTC-PowerIQ-Foldable-Charging/dp/B09F6HF28L HTC PD65W, 3-port black] (PD@20V)
* [https://www.amazon.com/HTC-Charger-Compact-Foldable-MacBook/dp/B09J83YZ8M HTC PD65W, 3-port, white] (PD@20V)
* [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V, need to buy EPR PD3.1 cable separately] (PD@28V, PD@20V) works for all USB-C devices
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* Notebook AC Adapter Lenovo ADLX95YCC3A (PD@20V)
* [https://www.amazon.com/gp/product/B087MD5MYH Amazon Basics 65W One-Port GaN USB-C PD 3.0]
* Charger Harbor SAIL01 65W Dual USB-C Power Delivery GaN PPS $12.99 (https://www.amazon.com/dp/B097CVQ868)
* Baseus GaN2 Pro Quick Charger 100W (CCGAN100UE) (PD@20V)
* Elecjet AnyWatt SQ, USB-C to Lenovo Square Slim-Tip Adapter 45W or 65W, used with a 65W Lenovo Supply (PD@20V, Pinecil shows 64W)
* [https://nekteck.com/products/nekteck-60w-usb-c-charger-gan-tech?tab=description Nekteck 60W with PD60 cable]

==== Battery Power bank ====
* [https://www.amazon.com/Anker-PowerCore-Portable-Charger-Compatible/dp/B09VPHVT2Z Anker 737 28V-140W EPR (must use EPR-PD 3.1 cable if you want 28V, otherwise it will be lower PD volts)]
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mAh QC2]
* [https://www.bestbuy.com/site/insignia-80w-26800-mah-portable-charger-for-most-usb-c-laptops-black/6419522.p?skuId=6419522 Insignia 80W 26,800mAh NS-PWLB80]
* Baseus BiPow 10000mAh 18W PD&QC3.0
* [https://www.amazon.de/gp/product/B07KRLRCDJ/ Intenso 7332330 Powerbank PD 10000 - External Battery PowerDelivery & QuickCharge3] - 10000mAh Powerbank, the Pinecil shows 12V and about 17W when heating up, using USB C PD (Red Silicone Pinecil cable)
* Marbero M87 30W PD 3.0
* [https://www.amazon.co.uk/Charmast-23800mAh-Delivery-Portable-Compatible/dp/B08ML1PHB2 Charmast C2032 65W Power Bank], maximum power at 20V is only available from the IN/OUT usb C port, the OUT usb C port delivers only 12V.

==== DC Barrel Power ====
{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://www.youtube.com/watch?v=5DBTNplNTfA Check the polarity of the DC Barrel plug]''' before plugging in a random charger or it could break the Pinecil.
|}

==== DC Laptop Brick ====

* Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video how to check if polarity is Center Positive''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.

* DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adaptors to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]).

* DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus, and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])

==== Tool Batteries 18V-21V ====

[[File:Power_Wheel_Adapters_for_18-21V_Tool_Batteries.png|400px|thumb|right| [https://a.co/bo626Nk Power-Wheels adapter link] with Ryobi battery ]]

* Easy way: just get a Power Wheels adapter. They are made for different tool brands and get a DC5525 Pigtail wire.
* [https://www.amazon.com/Hobbypark-Connector-Soldering-Outdoor-Repairing/dp/B08LKY5DBX DC5525 pigtail (keep the XT60 connector or cut it off)]
* Some people print their own 3D adaptors for tool batteries.
** Must use a 5.5mm x 2.5 mm DC barrel Plug. Forcing an an incorrect size, i.e., DC 5521 will break [https://forum.pine64.org/showthread.php?tid=13237 the connector as seen here] (if it doesn't go in, it doesn't fit).
* If you use a random DC barrel charger, first Check the Polarity of the plug to make sure it is Center Positive before using it. [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]. Using reverse polarity DC plug will destroy the pinecil.
* [https://smile.amazon.com/gp/product/B09GXBJMNF Get a Power Wheels Adapter like this for Ryobi, then connect a DC5525 Pigtail]
* [https://smile.amazon.com/stores/page/F3CF7FFA-3021-4014-AA81-E214F6F7CEDC?ingress=0&visitId=485f97ee-6a92-43e8-aaef-479873fccd6f Other kinds of Power-Wheels Adapters Ridgid, Milwaukee, Makita, etc.]
* [https://www.amazon.com/Adapter-Battery-terminals-Connector-Robotics/dp/B09GY21VXL Adapter for Ridgid batteries]
* To prevent battery overdrain, add this Pinecil setting which works for all the 18-21V tool batteries typical for Ridgid/Ryobi, etc.
{| class="wikitable" | style="text-align:left; "
|-style="background-color:LightYellow"
| Power source = 5S, Minimum Voltage = 3.3V
|}
* Tip: only if you change to a different size battery do you need to alter this. If you only ever switch between a USB-C charger and the tool battery, you could just leave the 5S/3.3V setting. Overdrain means using the battery past the point where you can charge it again. Many tool batteries have internal protection to prevents this, but some brands don't have it (unfortunately, unlike most brands, Dewalt puts it into the tool & not the batttery). Setting it in Pinecil is an extra safety setting in case you are not sure and want to preserve batteries.

'''Limited usability:'''
* Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V). Does not work on V2 (needs 3+amps). Works on V1, but slower heat speed because it's low amps and only 15V.
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V)
** (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB (1.7x 4.8mm need adaptor, tip is not DC5525)
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W) (tip is 1.7mmx5.5mm would need adaptor for DC5525)
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

==== Not compatible ====
* Zendure Power bank [https://a.co/d/aJ79FvF like this one] does not work. It does not appear to be USB-C PD 3.0 compliant. Only the USB-A port seems to work at lower QC voltage. It does not deliver USB-C 20V-5amps or USB-C 20V -3amps.
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)
* Sabrent HB-B7C3 USB3 hub, 7 data ports, 3 charge ports, 60W supply -- does not negotiate higher voltages.

==== [https://wiki.pine64.org/wiki/Pinecil Go Back to Pinecil Wiki]====

Pinecil

2022-02-09T14:01:23Z

Ondronr:

[[File:Pinecil-bb2-01_rotate.jpg|400px|thumb|right|The Pinecil]]

The '''Pinecil''' is a portable, temperature controlled soldering iron. It also has the intended use of being a Risc-V development device using a breakout board.

== Description ==
The Pinecil's main features are:

* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** More than half a dozen available. Currently sold as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** Barrel jack
** USB Type C power delivery

There are additional features that include (Useful for devkit use):

* A Programmable Gigadevice Risc-V GD32V embedded processor
* 0.67" Monochrome Display that can render text or graphics
* Support for Idle detection, for automatic power down of tip

== Usage ==

Pinecil comes with a separate heating element / tip. After inserting its barrel into the end of the handle, lightly tighten the screw onto it. Loosen this screw when changing out the tip.

The USB port, connected to any host, provides enough power to drive the user interface, but not necessarily enough to heat the tip. 5 volts from a USB 2 port will only display the user interface.

To check the firmware version, hold down the "-" button. It will display something like "v2.14.2425902 17-01-21", suggesting its actual release date, here 2021-01-17. Clicking the "+" button repeatedly reveals various internal settings, such as hardware version, current temperature, time since power-on, and number of motions detected. Clicking "-" returns to the regular display of current temperature, target temperature, and supply voltage. At other times it may show power draw.

To actually heat up the tip, you will need a power supply that can provide 12V or more. This may be a dedicated power supply with a standard barrel connector (+ center, - outside) that supplies anywhere from 12V to 21V, or a USB-C supply that can negotiate up to such a voltage. (You probably have a suitable supply disused in a box somewhere.)

Clicking "+" starts the tip heating. The display then shows power draw, current temperature, supply voltage, and estimated time to reach target temperature. You can adjust the target temperature with further clicks of "+" and "-" buttons. Waiting for the regular display to return, then holding down "-" for a moment turns the heat off. You can watch the temperature measurement go up and down. Certain settings involve holding down both buttons.

The iron will "sleep", switching to a lower temperature, after it has been put down for a short time, and heat up again when it is picked up.

Clicking "-" when heat is off steps through menus to control a variety of settings, such as the sleep temperature, time until sleep, motion sensitivity, temperature units (C or F) etc.

'''Menu Items''' items (accurate for firmware 2.16)

* Power settings
** Power source (cutoff choices for voltage and battery operation)
** QC voltage (voltage to negotiate for with QC chargers (9..22 volts in 0.2V steps, recommended up to 21 volts)
** PD timeout (compatibility setting for some picky QC power supplies, allowing to set a shorter amount of time for PD negotiation in 100ms steps)
* Soldering Settings
** Boost Temperature
** Heat on power up (Auto Start)
** Temperature Change (short click)
** Temperature Change (long click)
** Allow locking buttons (when soldering)
* Sleep mode
** Motion Sensor Sensitivity
** Sleep Temperature
** Sleep Timeout
** Shutdown Timeout
** Hall Sensor Sensitivity
* User Interface
** Temperature Units (C/F)
** Display orientation (auto/right/left)
** Cooldown Blink
** Scrolling Speed (slow/fast)
** Reverse +/- buttons
** Animation speed (off/slow/medium/fast)
** Animation loop
** Screen brightness (1..10)
** Screen inversion
** Detailed idle screen
** Detailed solder screen
* Advanced Settings
** Power Limit (watts)
** Factory Reset?
** Calibrate Temperature
** Calibrate Voltage
** Power Pulse (watts)

== Pictures ==

Pre-release:
<gallery>
File:Pinecil_Exploded_Diagram_ver_0.9.png|Pinecil renders|alt=alt language
File:PinecilPrototype.jpg|Pinecil prototype|alt=alt language
</gallery>

Production:
<gallery>
File:Pinecil-bb2-01.jpg|Pinecil and TS-B2 retail package|alt=alt language
File:Pinecil-Case-Red-1.jpg|Pinecil red casing|alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 compatible tips
* Tip model TS-B2 is the default tip supplied with the Pinecil
* Tip set 1 (left) & 2 (right): 
[[File:PinecilTipSets.jpg|800px]]

== Specifications ==
* '''Dimensions:''' 170mm with solder tip or 98mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 30g with solder tip, 20g without solder tip
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''DC in (only one of the following at a time):'''
** 12V- 21V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

== Pinecil board information, schematics and certifications ==

* Pinecil mainboard schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v1.0a_20201120.pdf Pinecil mainboard schematic ver 1.0 20201120, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Top PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Bottom PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Top Drawing file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Bottom Drawing file]

* Pinecil certifications:
** [https://files.pine64.org/doc/cert/Pinecil%20CE%20RED%20Certificate-S20102803801001.pdf Pinecil CE RED Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20FCC%20Certificate-S20102803802001.pdf Pinecil FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20RoHS10%20Certificate-S20102803803001.pdf Pinecil ROHS Certificate]

* Pinecil breakout board schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_Schematic_v1.0_20201005.pdf Pinecil breakout board schematic ver 1.0 20201005]
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_PCB_layout_v1.0_20201005.pdf Pinecil breakout board PCB layout ver 1.0]
* Photos:
<gallery>
File:Pinecil-breakout-board-02.jpg|Store photo
File:Pinecil breakout top.jpg|Top view
File:Pinecil breakout bottom.jpg|Bottom view
</gallery>

== Firmware Image Releases ==

* [https://github.com/pine64/pinecil-firmware-updater/releases/latest Latest Pinecil Firmware Updater] for MacOS and Windows

* [https://files.pine64.org/os/Pinecil/Pinecil_firmware_20201115.zip Pinecil production firmware 20201115, thanks to Ralimtek]

Links to development firmware and documentation:

* [https://github.com/Ralim/IronOS/releases GitHub repository for IronOS, from Ralimtek]
* [https://github.com/Ralim/IronOS/blob/master/Documentation/Flashing.md GitHub link for IronOS flashing documentation]

== Batch changes ==

* For the first manufacture batch of the Pinecil, the copper ring connecting the earth screw to the tip was omitted as the engineering team found the TS100 design lacking. For the second round onwards, an improved design copper ring has been included as standard, and is also included with the replacement red and black handles. For normal operation of the iron, omission of the ring does not impact it's operation. If you are working with ESD components, you will however need it in order to ground the iron tip via the earth screw at the back of the iron. If you ordered one from the first batch, and need that part, please contact info at pine64 dot org with the subject "Pinecil copper ring", and include your order number and shipment will be arranged.

* The first batch of Pinecil's were rated 12-24v @ 65W. After some heated discussion on the discussion group, it was decided that it would be downgraded to 12-21V @ 60W, due to concern over the connection of the DC jack to the USB-PD chip, which has a recommended maximum of 21v, and absolute maximum of 28v.

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Firmware Images
! Description

|-
! Ralimtek
| [https://github.com/Ralim/IronOS/ Ralim/IronOS]
| https://github.com/Ralim/IronOS/releases/
| Officially endorsed Pinecil firmware
|-
! Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
|
| Collection of Rust code demos for Pinecil
|}

== How to update a firmware ==

The official firmware that comes with the Pinecil is IronOS, you will want that if you just want to use your Pinecil as a soldering iron.

If you're using the manual firmware update method described below, you can [https://github.com/Ralim/IronOS/releases/ download new IronOS releases from here].

While you can't brick your Pinecil permanently (DFU is in ROM); a firmware update can make your Pinecil inoperable if you flash an invalid firmware. However, flashing a working firmware using these same instructions will remedy that.

{{warning|1=Do not have a barrel jack PSU plugged in at the same time as a USB-C cable. Doing this will severely damage your computer (or Type-C PSU).}}
=== With application ===

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# (Windows only) Be sure that you have installed Microsoft Visual C++ Redistributable x64. Else, you can download it [http://pinecil.pine64.org/updater/vc_redist.x64.exe here]
# Open it, select operating system you want to flash and click '''Flash'''. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.
# '''In case of error''': If you will get error about erasing the Pinecil, you need to tick '''Mass Erase''' checkbox and try again.

=== Manually ===

(Method tested on Linux, should work on any OS which supply dfu-util 0.10, if your distro comes with 0.9 you might soft-brick your Pinecil)

{{note|1=If <code>dfu-util</code> command cannot find a device with 28e9:0189 ID, try to run it with <code>sudo</code>}}

{{note|1=To check if you can use dfu-util 0.9, you can use <code>dfu-util -l</code>. If it reports <code>alt=0, name="@Internal Flash /0x08000000/128*001Kg"</code> you are fine, otherwise you need to upgrade to 0.10, important part is <code>128*001Kg</code>, which is flash amount of blocks and block size, as a chip used in Pinecil have 128 KB of Flash with 1KB page size}}

# Enter the update mode. For that, unplug a barrel jack PSU if you have one plugged in. Then, plug USB cable while holding *-* button (button that's closest to USB-C port).
# Make a firmware backup: <code>dfu-util -d 28e9:0189 -a 0 -U ~/pinecil/internal.flash.stock -s 0x08000000</code>
## <code>28e9:0189</code> -- USB Device ID (can be obtained from <code>lsusb</code> or <code>dfu-util -l</code> but in dfu-util output it might be hard to identify the Pinecil device)
## <code>-a 0</code> -- selects partition to flash. List of possible options can be obtained via <code>dfu-util -l</code>. Partition 0 - internal SPI flash. Partition 1 - fuses (description of fuses can be found in User Manual for the chip)
## <code>-U</code> -- specifies a mode. U is upload, which means that firmware will be downloaded and saved to file (yes, that's confusing, but it is what it is, feel free to verify that in a manual of your version of dfu-util). Command must be followed by a path to file where you want to save your firmware. dfu-util will refuse to dump firmware if you already have a file with that name.
## <code>-s 0x08000000</code> -- specify the address in a flash from which dump will start. This can be obtained from <code>dfu-util -l</code>.
# Flash a new firmware: <code>dfu-util -d 28e9:0189 -a 0 -D Pinecil_EN.bin -s 0x08000000:mass-erase:force</code>
## <code>-D</code> -- is a mode to Download firmware to the device (yes, that's confusing, but you indeed Upload from device and Download to device with dfu-util). That should follow the file with the firmware. Update archive from Ralim usually contains two files: <code>.hex</code> and <code>.bin</code>. One that is required - is <code>.bin</code>. <code>_EN</code> is the language code of the firmware, means that <code>_EN</code> will flash english version of firmware.
## <code>-s 0x08000000:mass-erase:force</code> -- specified the address where to flash the file. <code>:mass-erase:force</code> is required to force-erase flash before updating firmware, otherwise you might have unpredictable results.
## If it fails with <code>Error during special command "MASS_ERASE" get_status</code> (as has happened with recent shipments) then use ...<code>-s 0x08000000</code> without attempting "mass-erase".

== Disassembly steps ==

# Remove tip if present.
## Let tip cool down.
## Loosen top (display side) screw (PH1) on the tip side of the device.
## Gently pull tip out.
# Slide rubber off towards the tip side.
# Remove the ground screw (longer screw on the top side towards the port side) (PH1).
# Remove the bottom screw (at the tip side, between the legs) (PH1).
# Slightly pull the two halves of the case apart at the tip side, enough to get a fingernail or guitar pick between the halves.
# Move the pick down the length of the split to loosen the bottom half's clips from the top half of the case.
# Once loose, remove the bottom half by moving it forward (it is retained by the top half at the port side).
# Remove the screws retaining the copper tip contacts (PH000).
# Remove the now loose copper tip contacts.
# Gently push the board towards the tip side by pushing on one of the ports (for example, by using a misaligned USB C connector).
# The PCB assembly is now free to be lifted out.
## The key caps are now no longer retained, carefully set aside the top half, or remove the caps and store them separately.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Place the PCB assembly into the top half of the case ports first.
## Lower the rest of the board into the case and move the PCB assembly towards the port side of the case (the DC barrel connector may be a firm place to gently push).
# Install the copper tip contacts.
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 (5.5mm outer diameter, 2.5mm post) centre-positive jack, or with any USB power supply that supports the QC2, QC3 or USB-PD (Power Delivery) specification. QC2 and most QC3 power supplies will only be able to provide a maximum of 12V, limiting the Pinecil to about 17W of thermal capability. A suitable USB-PD power supply / power bank will be able to provide 20V, allowing the Pinecil to deliver the full 60W of heat to soldering tip.

For certain QC power adapters, there is a limited time for QC negotiation, otherwise voltage will fall back to 5V. 
Starting from firmware v2.16, there is a PD timeout setting (in 100ms steps) which allows QC negotiation start earlier. 
This enables some QC adapters to work (like some of the Baseus QC chargers) but may result problems with PD negotiation on slower PD adapters.

For certain adapters, a PD timeout value of 15 is needed while most of PD adapters are also work using this value.

Known working QC/PD/barrel power adapters / power banks include:

Power adapter:
* [https://pine64.com/product/pinepower-120w-desktop-power-supply-us-version/ PinePower Desktop]
* [https://www.nekteck.com/product/usb-if-certified-usb-c-charger-nekteck-60w-type-c-wall-charger-power-delivery-pd3-0-travel-charger-compatible-with-macbook-pro-2018-macbook-air-ipad-pro-pixel-3-galaxy-note-9-s9-with-6ft-cable/ Nekteck 60W with 6ft cable]
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* Notebook AC Adapter Lenovo LN-A0403A3C (Barrel 20V/2A)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V)
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V)
** (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Ankosen 65W USB C Charger for Mac Book and Laptop Fast Wall Charger, GaN PD 3.0 Power Adapter Amazon $9.99 (https://www.amazon.com/dp/B08T1P7ZRW/ref=cm_sw_r_oth_api_glt_fabc_X68FK4PW9VH02M4NK8CA?_encoding=UTF8&psc=1)
* Apple 140W USB-C Power Adapter A2452 (PD@20V)

Adapters:
* Elecjet AnyWatt SQ, USB-C to Lenovo Square Slim-Tip Adapter 45W or 65W, used with a 65W Lenovo Supply (PD@20V, Pinecil shows 64W)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mAh QC2]
* [https://www.bestbuy.com/site/insignia-80w-26800-mah-portable-charger-for-most-usb-c-laptops-black/6419522.p?skuId=6419522 Insignia 80W 26,800mAh NS-PWLB80]
* Baseus BiPow 10000mAh 18W PD&QC3.0
* [https://www.amazon.de/gp/product/B07KRLRCDJ/ Intenso 7332330 Powerbank PD 10000 - External Battery PowerDelivery & QuickCharge3] - 10000mAh Powerbank, the Pinecil shows 12V and about 17W when heating up, using USB C PD (Red Silicone Pinecil cable)
* Marbero M87 30W PD 3.0

Limited usability:
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)
* Sabrent HB-B7C3 USB3 hub, 7 data ports, 3 charge ports, 60W supply -- does not negotiate higher voltages.

== Cases and 3D Models ==

* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://www.thingiverse.com/thing:4734830 T12 Tip Adapter]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']

== Caring for a soldering iron ==

https://www.weller-tools.com/how-to-care-for-soldering-iron-tips/

https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/

== Checklist ==

Upon receipt, or buying a used Pinecil, one may want to check the following:
# the display turns on when 5-21V is supplied
#* via USB type C or 5525 center positive barrel
# it gets 20V from a 20V capable USB PD charger
#* check both orientations of the type C connector
# in update mode, it shows up on a computer as a GD32 DFU bootloader (or longan nano)
#* this requires a data capable USB cable
#* to enter update mode, press <code>-</code> (button near back/ground screw) while powering on
# both buttons work
#* <code>-</code> to enter menu or decrease temperature, long press to get software version info or to turn off heating
#* <code>+</code> to turn on heating or select a menu item
# the displayed text rotates according to gravity when orientation is set to Automatic
#* menu -> User interface -> Display orientation -> Automatic
# all 3 external screws are present
## one near the back near the screen (ground screw)
## one at the front on top (to hold the tip in)
## one at the front on the bottom (to hold the case together)
# the tip is clean (uniformly silver at the front, with no pitting or texture)
#* see [[#Caring for a soldering iron]] in case it is used
# it heats up an installed tip, and stops increasing when it reaches the set point
#* this may draw up to ~3A, make sure the supply can provide that
#* minor overshoot may occur, but, disconnect power if the temperature keeps going up
# the reported temperature is correct
#* if no direct measurement is possible, set it to ~230°C and see if it melts SAC (lead-free) solder (~190°C for leaded)
# if there are multiple tips, check all of them

== Datasheets for components and peripherals ==
* GigaDevice RISC-V SoC information:
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]
* Display Module information:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG 9616TSWCG02 Display Module Datasheet]
* USB Type-C PD Controller information:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Sensor information:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Silicon Lab Si7210 Hall-Effect Magnetic Position Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet]
* Power Regulator information:
** [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf Ricktek RT7272B 3A Switching Power Regulator Datasheet - on mainboard]
** [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LowPowerSemi LP6498B6F 1.2A Switching Power Regulator Datasheet - on breakout board]
* Power MOSFET Switch information:
** [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf Chang Jiang CJQ7328 8A MOSFET Datasheet]
* OP Amp information:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet]

== Community links ==

* [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]
* [https://matrix.to/#/#pinecil:matrix.org Matrix]
* [https://discordapp.com/invite/DgB7kzr Discord]

[[Category:Pinecil]]

Pinecil

2022-02-08T19:33:38Z

Ondronr:

[[File:Pinecil-bb2-01_rotate.jpg|400px|thumb|right|The Pinecil]]

The '''Pinecil''' is a portable, temperature controlled soldering iron. It also has the intended use of being a Risc-V development device using a breakout board.

== Description ==
The Pinecil's main features are:

* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** More than half a dozen available. Currently sold as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** Barrel jack
** USB Type C power delivery

There are additional features that include (Useful for devkit use):

* A Programmable Gigadevice Risc-V GD32V embedded processor
* 0.67" Monochrome Display that can render text or graphics
* Support for Idle detection, for automatic power down of tip

== Usage ==

Pinecil comes with a separate heating element / tip. After inserting its barrel into the end of the handle, lightly tighten the screw onto it. Loosen this screw when changing out the tip.

The USB port, connected to any host, provides enough power to drive the user interface, but not necessarily enough to heat the tip. 5 volts from a USB 2 port will only display the user interface.

To check the firmware version, hold down the "-" button. It will display something like "v2.14.2425902 17-01-21", suggesting its actual release date, here 2021-01-17. Clicking the "+" button repeatedly reveals various internal settings, such as hardware version, current temperature, time since power-on, and number of motions detected. Clicking "-" returns to the regular display of current temperature, target temperature, and supply voltage. At other times it may show power draw.

To actually heat up the tip, you will need a power supply that can provide 12V or more. This may be a dedicated power supply with a standard barrel connector (+ center, - outside) that supplies anywhere from 12V to 21V, or a USB-C supply that can negotiate up to such a voltage. (You probably have a suitable supply disused in a box somewhere.)

Clicking "+" starts the tip heating. The display then shows power draw, current temperature, supply voltage, and estimated time to reach target temperature. You can adjust the target temperature with further clicks of "+" and "-" buttons. Waiting for the regular display to return, then holding down "-" for a moment turns the heat off. You can watch the temperature measurement go up and down. Certain settings involve holding down both buttons.

The iron will "sleep", switching to a lower temperature, after it has been put down for a short time, and heat up again when it is picked up.

Clicking "-" when heat is off steps through menus to control a variety of settings, such as the sleep temperature, time until sleep, motion sensitivity, temperature units (C or F) etc.

'''Menu Items''' items (accurate for firmware 2.16)

* Power settings
** Power source (cutoff choices for voltage and battery operation)
** QC voltage (voltage to negotiate for with QC chargers (9..22 volts in 0.2V steps, recommended up to 21 volts)
** PD timeout (compatibility setting for some picky QC power supplies, allowing to set a shorter amount of time for PD negotiation in 100ms steps)
* Soldering Settings
** Boost Temperature
** Heat on power up (Auto Start)
** Temperature Change (short click)
** Temperature Change (long click)
** Allow locking buttons (when soldering)
* Sleep mode
** Motion Sensor Sensitivity
** Sleep Temperature
** Sleep Timeout
** Shutdown Timeout
** Hall Sensor Sensitivity
* User Interface
** Temperature Units (C/F)
** Display orientation (auto/right/left)
** Cooldown Blink
** Scrolling Speed (slow/fast)
** Reverse +/- buttons
** Animation speed (off/slow/medium/fast)
** Animation loop
** Screen brightness (1..10)
** Screen inversion
** Detailed idle screen
** Detailed solder screen
* Advanced Settings
** Power Limit (watts)
** Factory Reset?
** Calibrate Temperature
** Calibrate Voltage
** Power Pulse (watts)

== Pictures ==

Pre-release:
<gallery>
File:Pinecil_Exploded_Diagram_ver_0.9.png|Pinecil renders|alt=alt language
File:PinecilPrototype.jpg|Pinecil prototype|alt=alt language
</gallery>

Production:
<gallery>
File:Pinecil-bb2-01.jpg|Pinecil and TS-B2 retail package|alt=alt language
File:Pinecil-Case-Red-1.jpg|Pinecil red casing|alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 compatible tips
* Tip model TS-B2 is the default tip supplied with the Pinecil
* Tip set 1 (left) & 2 (right): 
[[File:PinecilTipSets.jpg|800px]]

== Specifications ==
* '''Dimensions:''' 170mm with solder tip or 98mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 30g with solder tip, 20g without solder tip
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''DC in (only one of the following at a time):'''
** 12V- 21V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

== Pinecil board information, schematics and certifications ==

* Pinecil mainboard schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v1.0a_20201120.pdf Pinecil mainboard schematic ver 1.0 20201120, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Top PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Bottom PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Top Drawing file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Bottom Drawing file]

* Pinecil certifications:
** [https://files.pine64.org/doc/cert/Pinecil%20CE%20RED%20Certificate-S20102803801001.pdf Pinecil CE RED Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20FCC%20Certificate-S20102803802001.pdf Pinecil FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20RoHS10%20Certificate-S20102803803001.pdf Pinecil ROHS Certificate]

* Pinecil breakout board schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_Schematic_v1.0_20201005.pdf Pinecil breakout board schematic ver 1.0 20201005]
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_PCB_layout_v1.0_20201005.pdf Pinecil breakout board PCB layout ver 1.0]
* Photos:
<gallery>
File:Pinecil-breakout-board-02.jpg|Store photo
File:Pinecil breakout top.jpg|Top view
File:Pinecil breakout bottom.jpg|Bottom view
</gallery>

== Firmware Image Releases ==

* [https://github.com/pine64/pinecil-firmware-updater/releases/latest Latest Pinecil Firmware Updater] for MacOS and Windows

* [https://files.pine64.org/os/Pinecil/Pinecil_firmware_20201115.zip Pinecil production firmware 20201115, thanks to Ralimtek]

Links to development firmware and documentation:

* [https://github.com/Ralim/IronOS/releases GitHub repository for IronOS, from Ralimtek]
* [https://github.com/Ralim/IronOS/blob/master/Documentation/Flashing.md GitHub link for IronOS flashing documentation]

== Batch changes ==

* For the first manufacture batch of the Pinecil, the copper ring connecting the earth screw to the tip was omitted as the engineering team found the TS100 design lacking. For the second round onwards, an improved design copper ring has been included as standard, and is also included with the replacement red and black handles. For normal operation of the iron, omission of the ring does not impact it's operation. If you are working with ESD components, you will however need it in order to ground the iron tip via the earth screw at the back of the iron. If you ordered one from the first batch, and need that part, please contact info at pine64 dot org with the subject "Pinecil copper ring", and include your order number and shipment will be arranged.

* The first batch of Pinecil's were rated 12-24v @ 65W. After some heated discussion on the discussion group, it was decided that it would be downgraded to 12-21V @ 60W, due to concern over the connection of the DC jack to the USB-PD chip, which has a recommended maximum of 21v, and absolute maximum of 28v.

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Firmware Images
! Description

|-
! Ralimtek
| [https://github.com/Ralim/IronOS/ Ralim/IronOS]
| https://github.com/Ralim/IronOS/releases/
| Officially endorsed Pinecil firmware
|-
! Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
|
| Collection of Rust code demos for Pinecil
|}

== How to update a firmware ==

The official firmware that comes with the Pinecil is IronOS, you will want that if you just want to use your Pinecil as a soldering iron.

If you're using the manual firmware update method described below, you can [https://github.com/Ralim/IronOS/releases/ download new IronOS releases from here].

While you can't brick your Pinecil permanently (DFU is in ROM); a firmware update can make your Pinecil inoperable if you flash an invalid firmware. However, flashing a working firmware using these same instructions will remedy that.

{{warning|1=Do not have a barrel jack PSU plugged in at the same time as a USB-C cable. Doing this will severely damage your computer (or Type-C PSU).}}
=== With application ===

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# (Windows only) Be sure that you have installed Microsoft Visual C++ Redistributable x64. Else, you can download it [http://pinecil.pine64.org/updater/vc_redist.x64.exe here]
# Open it, select operating system you want to flash and click '''Flash'''. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.
# '''In case of error''': If you will get error about erasing the Pinecil, you need to tick '''Mass Erase''' checkbox and try again.

=== Manually ===

(Method tested on Linux, should work on any OS which supply dfu-util 0.10, if your distro comes with 0.9 you might soft-brick your Pinecil)

{{note|1=If <code>dfu-util</code> command cannot find a device with 28e9:0189 ID, try to run it with <code>sudo</code>}}

{{note|1=To check if you can use dfu-util 0.9, you can use <code>dfu-util -l</code>. If it reports <code>alt=0, name="@Internal Flash /0x08000000/128*001Kg"</code> you are fine, otherwise you need to upgrade to 0.10, important part is <code>128*001Kg</code>, which is flash amount of blocks and block size, as a chip used in Pinecil have 128 KB of Flash with 1KB page size}}

# Enter the update mode. For that, unplug a barrel jack PSU if you have one plugged in. Then, plug USB cable while holding *-* button (button that's closest to USB-C port).
# Make a firmware backup: <code>dfu-util -d 28e9:0189 -a 0 -U ~/pinecil/internal.flash.stock -s 0x08000000</code>
## <code>28e9:0189</code> -- USB Device ID (can be obtained from <code>lsusb</code> or <code>dfu-util -l</code> but in dfu-util output it might be hard to identify the Pinecil device)
## <code>-a 0</code> -- selects partition to flash. List of possible options can be obtained via <code>dfu-util -l</code>. Partition 0 - internal SPI flash. Partition 1 - fuses (description of fuses can be found in User Manual for the chip)
## <code>-U</code> -- specifies a mode. U is upload, which means that firmware will be downloaded and saved to file (yes, that's confusing, but it is what it is, feel free to verify that in a manual of your version of dfu-util). Command must be followed by a path to file where you want to save your firmware. dfu-util will refuse to dump firmware if you already have a file with that name.
## <code>-s 0x08000000</code> -- specify the address in a flash from which dump will start. This can be obtained from <code>dfu-util -l</code>.
# Flash a new firmware: <code>dfu-util -d 28e9:0189 -a 0 -D Pinecil_EN.bin -s 0x08000000:mass-erase:force</code>
## <code>-D</code> -- is a mode to Download firmware to the device (yes, that's confusing, but you indeed Upload from device and Download to device with dfu-util). That should follow the file with the firmware. Update archive from Ralim usually contains two files: <code>.hex</code> and <code>.bin</code>. One that is required - is <code>.bin</code>. <code>_EN</code> is the language code of the firmware, means that <code>_EN</code> will flash english version of firmware.
## <code>-s 0x08000000:mass-erase:force</code> -- specified the address where to flash the file. <code>:mass-erase:force</code> is required to force-erase flash before updating firmware, otherwise you might have unpredictable results.
## If it fails with <code>Error during special command "MASS_ERASE" get_status</code> (as has happened with recent shipments) then use ...<code>-s 0x08000000</code> without attempting "mass-erase".

== Disassembly steps ==

# Remove tip if present.
## Let tip cool down.
## Loosen top (display side) screw (PH1) on the tip side of the device.
## Gently pull tip out.
# Slide rubber off towards the tip side.
# Remove the ground screw (longer screw on the top side towards the port side) (PH1).
# Remove the bottom screw (at the tip side, between the legs) (PH1).
# Slightly pull the two halves of the case apart at the tip side, enough to get a fingernail or guitar pick between the halves.
# Move the pick down the length of the split to loosen the bottom half's clips from the top half of the case.
# Once loose, remove the bottom half by moving it forward (it is retained by the top half at the port side).
# Remove the screws retaining the copper tip contacts (PH000).
# Remove the now loose copper tip contacts.
# Gently push the board towards the tip side by pushing on one of the ports (for example, by using a misaligned USB C connector).
# The PCB assembly is now free to be lifted out.
## The key caps are now no longer retained, carefully set aside the top half, or remove the caps and store them separately.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Place the PCB assembly into the top half of the case ports first.
## Lower the rest of the board into the case and move the PCB assembly towards the port side of the case (the DC barrel connector may be a firm place to gently push).
# Install the copper tip contacts.
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 (5.5mm outer diameter, 2.5mm post) centre-positive jack, or with any USB power supply that supports the QC2, QC3 or USB-PD (Power Delivery) specification. QC2 and most QC3 power supplies will only be able to provide a maximum of 12V, limiting the Pinecil to about 17W of thermal capability. A suitable USB-PD power supply / power bank will be able to provide 20V, allowing the Pinecil to deliver the full 60W of heat to soldering tip.

For certain QC power adapters, there is a limited time for QC negotiation, otherwise voltage will fall back to 5V. 
Starting from firmware v2.16, there is a PD timeout setting (in 100ms steps) which allows QC negotiation start earlier. 
This enables some QC adapters to work (like some of the Baseus QC chargers) but may result problems with PD negotiation on slower PD adapters.

For certain adapters, a PD timeout value of 15 is needed while most of PD adapters are also work using this value.

Known working QC/PD/barrel power adapters / power banks include:

Power adapter:
* [https://pine64.com/product/pinepower-120w-desktop-power-supply-us-version/ PinePower Desktop]
* [https://www.nekteck.com/product/usb-if-certified-usb-c-charger-nekteck-60w-type-c-wall-charger-power-delivery-pd3-0-travel-charger-compatible-with-macbook-pro-2018-macbook-air-ipad-pro-pixel-3-galaxy-note-9-s9-with-6ft-cable/ Nekteck 60W with 6ft cable]
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* Notebook AC Adapter Lenovo LN-A0403A3C (Barrel 20V/2A)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V)
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V)
** (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Ankosen 65W USB C Charger for Mac Book and Laptop Fast Wall Charger, GaN PD 3.0 Power Adapter Amazon $9.99 (https://www.amazon.com/dp/B08T1P7ZRW/ref=cm_sw_r_oth_api_glt_fabc_X68FK4PW9VH02M4NK8CA?_encoding=UTF8&psc=1)
* Apple 140W USB-C Power Adapter A2452 (PD@20V)
** power cycles until Pinecil starts heating

Adapters:
* Elecjet AnyWatt SQ, USB-C to Lenovo Square Slim-Tip Adapter 45W or 65W, used with a 65W Lenovo Supply (PD@20V, Pinecil shows 64W)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mAh QC2]
* [https://www.bestbuy.com/site/insignia-80w-26800-mah-portable-charger-for-most-usb-c-laptops-black/6419522.p?skuId=6419522 Insignia 80W 26,800mAh NS-PWLB80]
* Baseus BiPow 10000mAh 18W PD&QC3.0
* [https://www.amazon.de/gp/product/B07KRLRCDJ/ Intenso 7332330 Powerbank PD 10000 - External Battery PowerDelivery & QuickCharge3] - 10000mAh Powerbank, the Pinecil shows 12V and about 17W when heating up, using USB C PD (Red Silicone Pinecil cable)
* Marbero M87 30W PD 3.0

Limited usability:
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)
* Sabrent HB-B7C3 USB3 hub, 7 data ports, 3 charge ports, 60W supply -- does not negotiate higher voltages.

== Cases and 3D Models ==

* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://www.thingiverse.com/thing:4734830 T12 Tip Adapter]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']

== Caring for a soldering iron ==

https://www.weller-tools.com/how-to-care-for-soldering-iron-tips/

https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/

== Checklist ==

Upon receipt, or buying a used Pinecil, one may want to check the following:
# the display turns on when 5-21V is supplied
#* via USB type C or 5525 center positive barrel
# it gets 20V from a 20V capable USB PD charger
#* check both orientations of the type C connector
# in update mode, it shows up on a computer as a GD32 DFU bootloader (or longan nano)
#* this requires a data capable USB cable
#* to enter update mode, press <code>-</code> (button near back/ground screw) while powering on
# both buttons work
#* <code>-</code> to enter menu or decrease temperature, long press to get software version info or to turn off heating
#* <code>+</code> to turn on heating or select a menu item
# the displayed text rotates according to gravity when orientation is set to Automatic
#* menu -> User interface -> Display orientation -> Automatic
# all 3 external screws are present
## one near the back near the screen (ground screw)
## one at the front on top (to hold the tip in)
## one at the front on the bottom (to hold the case together)
# the tip is clean (uniformly silver at the front, with no pitting or texture)
#* see [[#Caring for a soldering iron]] in case it is used
# it heats up an installed tip, and stops increasing when it reaches the set point
#* this may draw up to ~3A, make sure the supply can provide that
#* minor overshoot may occur, but, disconnect power if the temperature keeps going up
# the reported temperature is correct
#* if no direct measurement is possible, set it to ~230°C and see if it melts SAC (lead-free) solder (~190°C for leaded)
# if there are multiple tips, check all of them

== Datasheets for components and peripherals ==
* GigaDevice RISC-V SoC information:
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]
* Display Module information:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG 9616TSWCG02 Display Module Datasheet]
* USB Type-C PD Controller information:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Sensor information:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Silicon Lab Si7210 Hall-Effect Magnetic Position Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet]
* Power Regulator information:
** [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf Ricktek RT7272B 3A Switching Power Regulator Datasheet - on mainboard]
** [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LowPowerSemi LP6498B6F 1.2A Switching Power Regulator Datasheet - on breakout board]
* Power MOSFET Switch information:
** [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf Chang Jiang CJQ7328 8A MOSFET Datasheet]
* OP Amp information:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet]

== Community links ==

* [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]
* [https://matrix.to/#/#pinecil:matrix.org Matrix]
* [https://discordapp.com/invite/DgB7kzr Discord]

[[Category:Pinecil]]

Pinecil

2022-02-08T19:30:13Z

Ondronr:

[[File:Pinecil-bb2-01_rotate.jpg|400px|thumb|right|The Pinecil]]

The '''Pinecil''' is a portable, temperature controlled soldering iron. It also has the intended use of being a Risc-V development device using a breakout board.

== Description ==
The Pinecil's main features are:

* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** More than half a dozen available. Currently sold as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** Barrel jack
** USB Type C power delivery

There are additional features that include (Useful for devkit use):

* A Programmable Gigadevice Risc-V GD32V embedded processor
* 0.67" Monochrome Display that can render text or graphics
* Support for Idle detection, for automatic power down of tip

== Usage ==

Pinecil comes with a separate heating element / tip. After inserting its barrel into the end of the handle, lightly tighten the screw onto it. Loosen this screw when changing out the tip.

The USB port, connected to any host, provides enough power to drive the user interface, but not necessarily enough to heat the tip. 5 volts from a USB 2 port will only display the user interface.

To check the firmware version, hold down the "-" button. It will display something like "v2.14.2425902 17-01-21", suggesting its actual release date, here 2021-01-17. Clicking the "+" button repeatedly reveals various internal settings, such as hardware version, current temperature, time since power-on, and number of motions detected. Clicking "-" returns to the regular display of current temperature, target temperature, and supply voltage. At other times it may show power draw.

To actually heat up the tip, you will need a power supply that can provide 12V or more. This may be a dedicated power supply with a standard barrel connector (+ center, - outside) that supplies anywhere from 12V to 21V, or a USB-C supply that can negotiate up to such a voltage. (You probably have a suitable supply disused in a box somewhere.)

Clicking "+" starts the tip heating. The display then shows power draw, current temperature, supply voltage, and estimated time to reach target temperature. You can adjust the target temperature with further clicks of "+" and "-" buttons. Waiting for the regular display to return, then holding down "-" for a moment turns the heat off. You can watch the temperature measurement go up and down. Certain settings involve holding down both buttons.

The iron will "sleep", switching to a lower temperature, after it has been put down for a short time, and heat up again when it is picked up.

Clicking "-" when heat is off steps through menus to control a variety of settings, such as the sleep temperature, time until sleep, motion sensitivity, temperature units (C or F) etc.

'''Menu Items''' items (accurate for firmware 2.16)

* Power settings
** Power source (cutoff choices for voltage and battery operation)
** QC voltage (voltage to negotiate for with QC chargers (9..22 volts in 0.2V steps, recommended up to 21 volts)
** PD timeout (compatibility setting for some picky QC power supplies, allowing to set a shorter amount of time for PD negotiation in 100ms steps)
* Soldering Settings
** Boost Temperature
** Heat on power up (Auto Start)
** Temperature Change (short click)
** Temperature Change (long click)
** Allow locking buttons (when soldering)
* Sleep mode
** Motion Sensor Sensitivity
** Sleep Temperature
** Sleep Timeout
** Shutdown Timeout
** Hall Sensor Sensitivity
* User Interface
** Temperature Units (C/F)
** Display orientation (auto/right/left)
** Cooldown Blink
** Scrolling Speed (slow/fast)
** Reverse +/- buttons
** Animation speed (off/slow/medium/fast)
** Animation loop
** Screen brightness (1..10)
** Screen inversion
** Detailed idle screen
** Detailed solder screen
* Advanced Settings
** Power Limit (watts)
** Factory Reset?
** Calibrate Temperature
** Calibrate Voltage
** Power Pulse (watts)

== Pictures ==

Pre-release:
<gallery>
File:Pinecil_Exploded_Diagram_ver_0.9.png|Pinecil renders|alt=alt language
File:PinecilPrototype.jpg|Pinecil prototype|alt=alt language
</gallery>

Production:
<gallery>
File:Pinecil-bb2-01.jpg|Pinecil and TS-B2 retail package|alt=alt language
File:Pinecil-Case-Red-1.jpg|Pinecil red casing|alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 compatible tips
* Tip model TS-B2 is the default tip supplied with the Pinecil
* Tip set 1 (left) & 2 (right): 
[[File:PinecilTipSets.jpg|800px]]

== Specifications ==
* '''Dimensions:''' 170mm with solder tip or 98mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 30g with solder tip, 20g without solder tip
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''DC in (only one of the following at a time):'''
** 12V- 21V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

== Pinecil board information, schematics and certifications ==

* Pinecil mainboard schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v1.0a_20201120.pdf Pinecil mainboard schematic ver 1.0 20201120, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Top PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.pdf Pinecil mainboard ver 1.0 PCB Component Placement Bottom PDF file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-topplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Top Drawing file]
** [https://files.pine64.org/doc/Pinecil/Pinecil-PCB-placement-v1.0-bottomplace.dxf Pinecil mainboard ver 1.0 PCB Component Placement Bottom Drawing file]

* Pinecil certifications:
** [https://files.pine64.org/doc/cert/Pinecil%20CE%20RED%20Certificate-S20102803801001.pdf Pinecil CE RED Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20FCC%20Certificate-S20102803802001.pdf Pinecil FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecil%20RoHS10%20Certificate-S20102803803001.pdf Pinecil ROHS Certificate]

* Pinecil breakout board schematic:
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_Schematic_v1.0_20201005.pdf Pinecil breakout board schematic ver 1.0 20201005]
** [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_PCB_layout_v1.0_20201005.pdf Pinecil breakout board PCB layout ver 1.0]
* Photos:
<gallery>
File:Pinecil-breakout-board-02.jpg|Store photo
File:Pinecil breakout top.jpg|Top view
File:Pinecil breakout bottom.jpg|Bottom view
</gallery>

== Firmware Image Releases ==

* [https://github.com/pine64/pinecil-firmware-updater/releases/latest Latest Pinecil Firmware Updater] for MacOS and Windows

* [https://files.pine64.org/os/Pinecil/Pinecil_firmware_20201115.zip Pinecil production firmware 20201115, thanks to Ralimtek]

Links to development firmware and documentation:

* [https://github.com/Ralim/IronOS/releases GitHub repository for IronOS, from Ralimtek]
* [https://github.com/Ralim/IronOS/blob/master/Documentation/Flashing.md GitHub link for IronOS flashing documentation]

== Batch changes ==

* For the first manufacture batch of the Pinecil, the copper ring connecting the earth screw to the tip was omitted as the engineering team found the TS100 design lacking. For the second round onwards, an improved design copper ring has been included as standard, and is also included with the replacement red and black handles. For normal operation of the iron, omission of the ring does not impact it's operation. If you are working with ESD components, you will however need it in order to ground the iron tip via the earth screw at the back of the iron. If you ordered one from the first batch, and need that part, please contact info at pine64 dot org with the subject "Pinecil copper ring", and include your order number and shipment will be arranged.

* The first batch of Pinecil's were rated 12-24v @ 65W. After some heated discussion on the discussion group, it was decided that it would be downgraded to 12-21V @ 60W, due to concern over the connection of the DC jack to the USB-PD chip, which has a recommended maximum of 21v, and absolute maximum of 28v.

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Firmware Images
! Description

|-
! Ralimtek
| [https://github.com/Ralim/IronOS/ Ralim/IronOS]
| https://github.com/Ralim/IronOS/releases/
| Officially endorsed Pinecil firmware
|-
! Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
|
| Collection of Rust code demos for Pinecil
|}

== How to update a firmware ==

The official firmware that comes with the Pinecil is IronOS, you will want that if you just want to use your Pinecil as a soldering iron.

If you're using the manual firmware update method described below, you can [https://github.com/Ralim/IronOS/releases/ download new IronOS releases from here].

While you can't brick your Pinecil permanently (DFU is in ROM); a firmware update can make your Pinecil inoperable if you flash an invalid firmware. However, flashing a working firmware using these same instructions will remedy that.

{{warning|1=Do not have a barrel jack PSU plugged in at the same time as a USB-C cable. Doing this will severely damage your computer (or Type-C PSU).}}
=== With application ===

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# (Windows only) Be sure that you have installed Microsoft Visual C++ Redistributable x64. Else, you can download it [http://pinecil.pine64.org/updater/vc_redist.x64.exe here]
# Open it, select operating system you want to flash and click '''Flash'''. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.
# '''In case of error''': If you will get error about erasing the Pinecil, you need to tick '''Mass Erase''' checkbox and try again.

=== Manually ===

(Method tested on Linux, should work on any OS which supply dfu-util 0.10, if your distro comes with 0.9 you might soft-brick your Pinecil)

{{note|1=If <code>dfu-util</code> command cannot find a device with 28e9:0189 ID, try to run it with <code>sudo</code>}}

{{note|1=To check if you can use dfu-util 0.9, you can use <code>dfu-util -l</code>. If it reports <code>alt=0, name="@Internal Flash /0x08000000/128*001Kg"</code> you are fine, otherwise you need to upgrade to 0.10, important part is <code>128*001Kg</code>, which is flash amount of blocks and block size, as a chip used in Pinecil have 128 KB of Flash with 1KB page size}}

# Enter the update mode. For that, unplug a barrel jack PSU if you have one plugged in. Then, plug USB cable while holding *-* button (button that's closest to USB-C port).
# Make a firmware backup: <code>dfu-util -d 28e9:0189 -a 0 -U ~/pinecil/internal.flash.stock -s 0x08000000</code>
## <code>28e9:0189</code> -- USB Device ID (can be obtained from <code>lsusb</code> or <code>dfu-util -l</code> but in dfu-util output it might be hard to identify the Pinecil device)
## <code>-a 0</code> -- selects partition to flash. List of possible options can be obtained via <code>dfu-util -l</code>. Partition 0 - internal SPI flash. Partition 1 - fuses (description of fuses can be found in User Manual for the chip)
## <code>-U</code> -- specifies a mode. U is upload, which means that firmware will be downloaded and saved to file (yes, that's confusing, but it is what it is, feel free to verify that in a manual of your version of dfu-util). Command must be followed by a path to file where you want to save your firmware. dfu-util will refuse to dump firmware if you already have a file with that name.
## <code>-s 0x08000000</code> -- specify the address in a flash from which dump will start. This can be obtained from <code>dfu-util -l</code>.
# Flash a new firmware: <code>dfu-util -d 28e9:0189 -a 0 -D Pinecil_EN.bin -s 0x08000000:mass-erase:force</code>
## <code>-D</code> -- is a mode to Download firmware to the device (yes, that's confusing, but you indeed Upload from device and Download to device with dfu-util). That should follow the file with the firmware. Update archive from Ralim usually contains two files: <code>.hex</code> and <code>.bin</code>. One that is required - is <code>.bin</code>. <code>_EN</code> is the language code of the firmware, means that <code>_EN</code> will flash english version of firmware.
## <code>-s 0x08000000:mass-erase:force</code> -- specified the address where to flash the file. <code>:mass-erase:force</code> is required to force-erase flash before updating firmware, otherwise you might have unpredictable results.
## If it fails with <code>Error during special command "MASS_ERASE" get_status</code> (as has happened with recent shipments) then use ...<code>-s 0x08000000</code> without attempting "mass-erase".

== Disassembly steps ==

# Remove tip if present.
## Let tip cool down.
## Loosen top (display side) screw (PH1) on the tip side of the device.
## Gently pull tip out.
# Slide rubber off towards the tip side.
# Remove the ground screw (longer screw on the top side towards the port side) (PH1).
# Remove the bottom screw (at the tip side, between the legs) (PH1).
# Slightly pull the two halves of the case apart at the tip side, enough to get a fingernail or guitar pick between the halves.
# Move the pick down the length of the split to loosen the bottom half's clips from the top half of the case.
# Once loose, remove the bottom half by moving it forward (it is retained by the top half at the port side).
# Remove the screws retaining the copper tip contacts (PH000).
# Remove the now loose copper tip contacts.
# Gently push the board towards the tip side by pushing on one of the ports (for example, by using a misaligned USB C connector).
# The PCB assembly is now free to be lifted out.
## The key caps are now no longer retained, carefully set aside the top half, or remove the caps and store them separately.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Place the PCB assembly into the top half of the case ports first.
## Lower the rest of the board into the case and move the PCB assembly towards the port side of the case (the DC barrel connector may be a firm place to gently push).
# Install the copper tip contacts.
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 (5.5mm outer diameter, 2.5mm post) centre-positive jack, or with any USB power supply that supports the QC2, QC3 or USB-PD (Power Delivery) specification. QC2 and most QC3 power supplies will only be able to provide a maximum of 12V, limiting the Pinecil to about 17W of thermal capability. A suitable USB-PD power supply / power bank will be able to provide 20V, allowing the Pinecil to deliver the full 60W of heat to soldering tip.

For certain QC power adapters, there is a limited time for QC negotiation, otherwise voltage will fall back to 5V. 
Starting from firmware v2.16, there is a PD timeout setting (in 100ms steps) which allows QC negotiation start earlier. 
This enables some QC adapters to work (like some of the Baseus QC chargers) but may result problems with PD negotiation on slower PD adapters.

For certain adapters, a PD timeout value of 15 is needed while most of PD adapters are also work using this value.

Known working QC/PD/barrel power adapters / power banks include:

Power adapter:
* [https://pine64.com/product/pinepower-120w-desktop-power-supply-us-version/ PinePower Desktop]
* [https://www.nekteck.com/product/usb-if-certified-usb-c-charger-nekteck-60w-type-c-wall-charger-power-delivery-pd3-0-travel-charger-compatible-with-macbook-pro-2018-macbook-air-ipad-pro-pixel-3-galaxy-note-9-s9-with-6ft-cable/ Nekteck 60W with 6ft cable]
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* Notebook AC Adapter Lenovo LN-A0403A3C (Barrel 20V/2A)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V)
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V)
** (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Ankosen 65W USB C Charger for Mac Book and Laptop Fast Wall Charger, GaN PD 3.0 Power Adapter Amazon $9.99 (https://www.amazon.com/dp/B08T1P7ZRW/ref=cm_sw_r_oth_api_glt_fabc_X68FK4PW9VH02M4NK8CA?_encoding=UTF8&psc=1)
* Apple 140W USB-C Power Adapter A2452 - power cycles until Pinecil starts heating

Adapters:
* Elecjet AnyWatt SQ, USB-C to Lenovo Square Slim-Tip Adapter 45W or 65W, used with a 65W Lenovo Supply (PD@20V, Pinecil shows 64W)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mAh QC2]
* [https://www.bestbuy.com/site/insignia-80w-26800-mah-portable-charger-for-most-usb-c-laptops-black/6419522.p?skuId=6419522 Insignia 80W 26,800mAh NS-PWLB80]
* Baseus BiPow 10000mAh 18W PD&QC3.0
* [https://www.amazon.de/gp/product/B07KRLRCDJ/ Intenso 7332330 Powerbank PD 10000 - External Battery PowerDelivery & QuickCharge3] - 10000mAh Powerbank, the Pinecil shows 12V and about 17W when heating up, using USB C PD (Red Silicone Pinecil cable)
* Marbero M87 30W PD 3.0

Limited usability:
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)
* Sabrent HB-B7C3 USB3 hub, 7 data ports, 3 charge ports, 60W supply -- does not negotiate higher voltages.

== Cases and 3D Models ==

* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://www.thingiverse.com/thing:4734830 T12 Tip Adapter]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']

== Caring for a soldering iron ==

https://www.weller-tools.com/how-to-care-for-soldering-iron-tips/

https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/

== Checklist ==

Upon receipt, or buying a used Pinecil, one may want to check the following:
# the display turns on when 5-21V is supplied
#* via USB type C or 5525 center positive barrel
# it gets 20V from a 20V capable USB PD charger
#* check both orientations of the type C connector
# in update mode, it shows up on a computer as a GD32 DFU bootloader (or longan nano)
#* this requires a data capable USB cable
#* to enter update mode, press <code>-</code> (button near back/ground screw) while powering on
# both buttons work
#* <code>-</code> to enter menu or decrease temperature, long press to get software version info or to turn off heating
#* <code>+</code> to turn on heating or select a menu item
# the displayed text rotates according to gravity when orientation is set to Automatic
#* menu -> User interface -> Display orientation -> Automatic
# all 3 external screws are present
## one near the back near the screen (ground screw)
## one at the front on top (to hold the tip in)
## one at the front on the bottom (to hold the case together)
# the tip is clean (uniformly silver at the front, with no pitting or texture)
#* see [[#Caring for a soldering iron]] in case it is used
# it heats up an installed tip, and stops increasing when it reaches the set point
#* this may draw up to ~3A, make sure the supply can provide that
#* minor overshoot may occur, but, disconnect power if the temperature keeps going up
# the reported temperature is correct
#* if no direct measurement is possible, set it to ~230°C and see if it melts SAC (lead-free) solder (~190°C for leaded)
# if there are multiple tips, check all of them

== Datasheets for components and peripherals ==
* GigaDevice RISC-V SoC information:
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
** [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]
* Display Module information:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG 9616TSWCG02 Display Module Datasheet]
* USB Type-C PD Controller information:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Sensor information:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Silicon Lab Si7210 Hall-Effect Magnetic Position Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet]
* Power Regulator information:
** [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf Ricktek RT7272B 3A Switching Power Regulator Datasheet - on mainboard]
** [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LowPowerSemi LP6498B6F 1.2A Switching Power Regulator Datasheet - on breakout board]
* Power MOSFET Switch information:
** [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf Chang Jiang CJQ7328 8A MOSFET Datasheet]
* OP Amp information:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet]

== Community links ==

* [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]
* [https://matrix.to/#/#pinecil:matrix.org Matrix]
* [https://discordapp.com/invite/DgB7kzr Discord]

[[Category:Pinecil]]