PINE64 - User contributions [en]

Pinecil Power Supplies

2023-02-27T11:09:50Z

PineDude: Clarify that USB-C is not something that QC3 may negotiate. Make USB capitalization consistent.

This article is about compatible power supplies for the [[Pinecil]].

== 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.
# Any USB-C power supply that supports PD (Power Delivery) and has at least the minimum Volt/amps listed should work. The USB-C PD65W, 3.25A, 20V is recommended, but a lower PD45W will also work on V1).
# Also, any quality "center positive" DC barrel 12-21V battery or power supply using a DC 5525 jack (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 pre-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 will work, see the [[#Tool_Batteries_18V-21V| tool battery section]] for details.
# QC3.0 phone chargers: not recommended, it is weaker in power and does not auto-negotiate like USB-C PD does. QC3 requires manually setting the voltage in the Power settings. A 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 <code>Thermal Runaway</code> message (this means the weak power causes Pinecil to auto-shutdown continuously).
# QC is more problematic for V2 which comes with the Pine64 designed shorter 6.2 ohm resistance tip. This means the V2 needs more power than the V1. Switching to the longer tys100 style 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 are not USB compliant.

=== Troubleshooting QC chargers ===
# older QC2.0 chargers are not supported in IronOS firmware (only QC3.0 and PD type).
# 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 (lower the PD timeout to see if that will help QC charger work). (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 (PD USB-C chargers are recommended over QC only type)

=== 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''', it must be center positive ([https://www.youtube.com/watch?v=5DBTNplNTfA see Video])
# Use a known good quality cable that will not short. There are low cost $3 cable testers that test for shorts.
# If the Pinecil heats up very slowly or gets <code>Thermal Runaway</code> 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 and prevent proper Pinecil operation.
# QC 2.0 not supported by IronOS firmware (only QC 3.0 and PD type).
# most PC & laptop ports don't work as they are only 5V which is good enough for simple Firmware updates but not to provide the constant higher power a "resistance" type of soldering Iron needs to 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).

== Cables, 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.

=== 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-C 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 USB 2.0 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 ===
==== Should I get a GaN type Charger? ====

* Sure, if there are two PD65 20V chargers that are similar in price, and one is GaN, this is generally a [https://www.kensington.com/news/docking-connectivity-blog/5-reasons-why-you-should-make-the-switch-to-gallium-nitride-gan-over-silicon-devices/#:~:text=GaN%20devices%20have%20lower%20cooling,costs%20than%20silicon%2Dbased%20devices good chioce].
* Older style chargers could become dangerously hot, whereas GaN can stay cooler, even in a smaller size.
* If the GaN charger senses a potentially dangerous condition, i.e., overcurrent spikes, the chips are designed to go into a cycle-by-cycle sleep state, protecting the device. [https://www.ti.com/lit/an/snoaa15/snoaa15.pdf?ts=1677349470127&ref_url=https%253A%252F%252Fwww.google.com%252F Over current protection in GAN].
* The [https://pine64.com/product/pinepower-65w-gan-2c1a-charger-with-international-plugs/ PinePower Portable PD65] is GAN II (2nd generation GaN).
* Will Pinecil work with regular USB-C PD 65w 20V-3.25A chargers also? Yes, as long as it supports PD (power delivery protocol).

==== EPR PD3.1, 140W Chargers ====
{{Info| need to buy a EPR PD3.1 240W cable separately if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices, i.e., Pinecil V2, and will do 20V and less for older usb-C devices that don't need as much power.}}
# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presetly).

==== PD3.0 65w 20V Chargers ====
[[File:USB C PD shared watts charger.jpg|400px|right]]
# [https://pine64.com/product-category/pinepower/ PD120w PinePower Desktop w/Grounded 3-pin plug]
# [https://pine64.com/product/pinepower-65w-gan-2c1a-charger-with-international-plugs/ PD65w GAN II Pinepower Portable Travel charger] (PD@20V)
# [https://www.amazon.com/dp/B09GK6QY1K Cirtek 65W charger 3-port]
# [https://a.co/4RLyqzN 65W 3-port charger]
# [https://a.co/d/5Ai1McE EfaithFix PD65W, 3-port]
# [https://a.co/1mhjg35 Ultra-thin Portable PD65w]
#* small flat, full 20V PD65W charger, works well with Pinecil
#* it may not as durable as bigger chargers as it has no thick insulation around it.
# [https://www.amazon.com/Charger-HTC-PowerIQ-Foldable-Charging/dp/B09F6HF28L HTC PD65W, 3-port black]
# [https://www.amazon.com/HTC-Charger-Compact-Foldable-MacBook/dp/B09J83YZ8M HTC PD65W, 3-port, white]
# [https://www.amazon.com/gp/product/B087MD5MYH Amazon Basics 65W One-Port GaN USB-C PD 3.0]

=== 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 240W cable if you want the full 28V, otherwise it will provide a lower PD20V)
# [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]
# [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.
# Baseus BiPow 10000mAh 18W PD&QC3.0

=== DC Barrel Power ===
{| class="wikitable"
|-style="background-color:LightYellow"
| '''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.
|-style="background-color:LightYellow"
|[https://www.youtube.com/watch?v=5DBTNplNTfA Video here] shows how to check.
|-
|}
[[File:AC adaptor polarity.png|350px]]

[[File:Nintendo-center-negative.png|350px]]

=== 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.

* '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils [are] damaged by such power supply."

* 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]), and possibly push back and break the positive pin connection inside pinecil where the DC barrel attaches to the PCB.

* 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])

* It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
** These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
** Members have experienced broken pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

[[File:Power_Wheel_Adapters_for_18-21V_Tool_Batteries.png|450px|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 Dewalt, etc.. Some tool brands have the overdrain protection already; it doesn't hurt to also set this in Pinecil or in case you don't know if your brand/type has it or not.

<code> Power source = 5S, Minimum Voltage = 3.3V </code>

* 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.

== Go back to Pinecil article ==
Go back to [[Pinecil|Pinecil article]].

[[Category:Pinecil]]
[[Category:Pinecil]]

STAR64

2022-11-11T07:43:04Z

PineDude: Add first boot journey logs

[[File:Star64.jpg|400px|thumb|right|The STAR64]]

The '''Star64''' is a RISC-V based Single Board Computer powered by StarFive JH7110 Quad-Core SiFive U74 64-Bit CPU, Imagination Technology BX-4-32 GPU and supports up to 8GB 1866MHz LPDDR4 memory. It provides an eMMC module socket, MicroSD Card slot, PCI-e, Pi-2 Bus, USB 3.0, and many other peripheral interfaces for makers to integrate with sensors and other devices.

[[File:RISC-V.png|600px|]]

== Software releases ==

=== Quick Links to the Source of OS Images Build ===

OS images are still in '''alpha build''' which are only fit for board bring up and testing purposes.

* [https://github.com/Icenowy/linux/tree/star64-5.15/ Icenowy's Star64's Github Linux kernel source tree]

== SoC and Memory Specification ==
* Based on [https://www.starfivetech.com/en/site/soc StarFive JH7110]
[[File:StarFive.jpg|right]]
[[File:JH7110_Block_Diagram.jpg|600px]]

=== CPU Architecture ===
* [https://www.sifive.com/cores/u74 Quad-core U74 up to 1.5GHz CPU]
[[File:SiFive.jpg|right|200px]]
* Fully compliant with the RISC-V ISA specification
* 64-bit RISC-V Application Core
* 32KB L1 I-cache with ECC
* 32KB L1 D-cache with ECC
* 8 Region Physical Memory Protection
* Virtual Memory support with up to 47 Physical Address bits
* Integrated up to 2MB L2 Cache with ECC
* includes RV64IMAC S7 monitor core, 16 KB L1 I-Cache with ECC, 8 KB DTIM with ECC
* 32-bit RISC-V CPU core (E24) for real time control, support RV32IMFC RISC-V ISA

=== GPU Architecture ===
* [https://www.imaginationtech.com/product/img-bxe-4-32-mc4/ Imagination Technology BXE-4-32 up to 600Mhz GPU]
[[File:imgtech.png|right|200px]]
* Support OpenCL 3.0
* Support OpenGL ES 3.2
* Support Vulkan 1.2
* Tile-based deferred rendering architecture for 3D graphics workloads, with concurrent processing of multiple tiles
* Support for GPU visualization, up to 8 virtual GPUs
* On fly frame buffer compression and decompression (TFBC) algorithm
* Performance: 128 FP32 FLOPs/Clock, 256 FP16 FLOPs/Clock

=== System Memory ===
* LPDDR4 RAM Memory Variants: 2GB, 4GB and 8GB.

== Board Features ==

=== Video ===
* Digital Video output up to 4K@30Hz
* 4K HDR @ 60fps
* H.264/AVC Base/Main/High/High10 profile @ level 5.1; up to 4Kx2K @ 60fps
* H.265/HEVC Main/Main10 profile @ level 5.1 High-tier; up to 4Kx2K @ 60fps

=== Audio ===
* 3.5mm audio Jack

=== Network ===
* Single or Dual 10/100/1000Mbps Ethernet
* 2.4GHz/5Ghz MIMO WiFi 802.11 b/g/n/ac with Bluetooth 5.2

=== Storage ===
* on-board 128Mb (16MB) XSPI NOR flash memory - bootable
* microSD - bootable, supports SDHC and SDXC and storage up to 256GB
* eMMC - bootable (optional eMMC Module)
* 1 USB3.0 Dedicated Host port
* 3 USB2.0 Host port

=== Expansion Ports ===
* PCIe 2.0
* 2x20 pins "Pi2" GPIO Header
* 4 lane MiPi DSI port for LCD panel
* 4 lane MiPi CSI port for camera module

== Board Information, Schematics and Certifications ==
* Model "A" Baseboard Dimensions: 133mm x 80mm x 19mm
* Input Power: DC 12V @ 3A 5.5mmOD/2.1mmID center-positive Barrel DC Jack connector
* Schematic:
** [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf STAR64 Schematic 20220721 v1.0 (Prototype Board)]
* Certifications:
** Disclaimer: Please note that PINE64 SBC is not a "final" product and in general certification is not necessary. However, PINE64 still submits the SBC for FCC, CE, and ROHS certifications and obtain the certificates to prove that the SBC board can pass the testing. Please note, a final commercial product needs to perform its own testing and obtain its own certificate.
** Not yet available

== Datasheets for Components and Peripherals ==
* Star64 JH7110 SoC information:
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Product_Brief.pdf StarFive JH7110 SoC Product Brief]
** [https://doc-en.rvspace.org/JH7110/PDF/JH7110_Datasheet.pdf StarFive JH7110 SoC Datasheet]
* X-Power PMU information:
** [https://files.pine64.org/doc/datasheet/star64/AXP15060%20datasheet%20V0.1.pdf X-Power AXP15060 Datasheet V0.1]
* LPDDR4 (200 Balls) SDRAM:
** [https://files.pine64.org/doc/datasheet/rockpro64/SM512M32Z01MD2BNP(200BALL).pdf Micron LPDDR4 Mobile LPDDR4 Datasheet]
* eMMC information:
** [https://files.pine64.org/doc/rock64/PINE64_eMMC_Module_20170719.pdf PINE64 eMMC module schematic]
** [https://files.pine64.org/doc/rock64/usb%20emmc%20module%20adapter%20v2.pdf PINE64 USB adapter for eMMC module V2 schematic]
** [https://files.pine64.org/doc/rock64/USB%20adapter%20for%20eMMC%20module%20PCB.tar PINE64 USB adapter for eMMC module PCB in JPEG]
** [https://files.pine64.org/doc/datasheet/pine64/E-00517%20FORESEE_eMMC_NCEMAM8B-16G%20SPEC.pdf 16GB Foresee eMMC Datasheet]
** [https://files.pine64.org/doc/datasheet/pine64/SDINADF4-16-128GB-H%20data%20sheet%20v1.13.pdf 32GB/64GB/128GB SanDisk eMMC Datasheet]
* SPI NOR Flash information:
** [https://files.pine64.org/doc/datasheet/star64/gd25lq128e_rev1.0_20210513.pdf GigaDevice 128Mb XSPI-Flash Datasheet]
* Ethernet related info:
** TBA
* WiFi/BT module info:
** [https://files.pine64.org/doc/datasheet/star64/Fn-Link_6252B-UUB_datasheet_V1.1_20220329.pdf Fn-Link 6252B 11AC Dual Band 2T2R WiFi + Bluetooth5.2 Datasheet]

== Bringup Notes ==
(This section to be refined/replaced as boards and tools mature.)
#) The [https://files.pine64.org/doc/star64/Star64_Schematic_V1.0_20220721.pdf schematic] has several discrepancies with actual board labels.
#) The serial console can be found with TXD on pin 8 and TXD on pin 10; a convention common to Pi-style boards. Use the 40pin header pinouts in color on page one and not the schematic prose.
#) If you have only a single core running and no PCI card present, it appears to power up via the +5V/GND lines from the USB serial adapter pins.
#) It will not boot from a VisionFive R1 uSD card.
#) The boot device switch labels and the silk screen are inverted. "0" means "On".
#) 2021.10-00001-gdbdaad919b will attempt to boot from SPI, but it appears blank. If you let it for many minutes, the device will eventually time out and boot OpenSBI v1.0 from (SPI?). This will fail, but only after self-identifying as a VisionFive R2, complete with five cores and 4 GB of RAM, before failing. A "press any key" timeout is offered, but I've been unable to make it stop. It will eventually crash with:
Loading Environment from SPIFlash... SF: Detected gd25lq128 with page size 256 Bytes, erase size 4 KiB, total 16 MiB
*** Warning - bad CRC, using default environment

Not a StarFive EEPROM data format - magic error
[[Category:STAR64]] [[Category:StarFive JH7110]]

Pinecil

2022-10-06T12:12:29Z

PineDude: RISC is an acronym

[[File:Pinecilv2-1.jpg|300px|thumb|right|'''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. (V2 in Photo)]]

== Pinecil Soldering Iron: main features ==
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://github.com/bouffalolab/bl_mcu_sdk tools from Bouffalo Labs], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== Authenticity ==

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same quality control as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, EU countries pay VAT to delivery person).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil V2)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU, VAT+ 2-year warranty included per EU laws)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from California, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)
* [https://www.ursele.com/contact URS Electronics] (local in-store sales only in Portland, Oregon, USA)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official [https://ralim.github.io/IronOS/ Github IronOS firmware], will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work? (main Pine store info. below)'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping (~$12): could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive (~$30), takes 4-10 business days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy] (30-day warranty starts when Pinecil is delivered).

* Note: resellers operate independently from the main Pine Store. Get all shipping info on their websites/chat tools/email. They are in different countries and set their own procedures and have different shipping costs/options.

'''Tracking websites'''
* https://parcelsapp.com/
* https://www.17track.net/
* The tracking number issued in the shipping email may not work for a couple days, just check again.
* If you see the message "outbound imports cancelled," just wait. We think it's a poor short coded message. Members experience that it updates after 1-3 days to show a hand off from China Post to a USA facility. The message would be more clear if it was "outbound imports transferred/complete".

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply].
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ Github IronOS for details on firmware] settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended ([https://wiki.pine64.org/wiki/Pinecil_Power_Supplies see Power Supply page]).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Power Supply page]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://ralim.github.io/IronOS/GettingStarted/ Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://ralim.github.io/IronOS/Settings/ Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore default/factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major [https://ralim.github.io/IronOS/GettingStarted/ firmware update] as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': are also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners in the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://ralim.github.io/IronOS/ open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Long hold down <code>'''[-]'''</code> to see the firmware version
* [https://ralim.github.io/IronOS/GettingStarted/ Firmware update instructions]

* To submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/issues Ralim's IronOS Issues]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
* To give some love back, you could donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://ralim.github.io/IronOS/ Ralim's IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| *Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact).
|-style="background-color:LightYellow"
| *Do not bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| *Pinecil only uses one power port, the USB-C or the DC barrel, but never both at the same time. Damage will occur if attempted.
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# The display turns on when 5-24V is supplied (5-21V for older V1 models).
#* Use a USB type C cable or a DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are are used independently and not at the same time.
#* Note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the type C cable (try to flip it if one way doesn't work)
# Check Update mode [https://ralim.github.io/IronOS/#getting-started (see Ralim/IronOS for details on flashing updates)]
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in a a time. You could damage devices doing this.
#* V2 does not have an new release yet (2.18 is the highest release version as of Oct.1, 2022).
#** It will need a different type of Updater/flasher which will be announced on Github/Ironos when a new release is available.
#** V2 owners with EPR 28V chargers are advised to join the Community chat linked in the wiki for possible Beta firmware versions.
#** If you have issues with V2 firmware, create a new [https://github.com/Ralim/IronOS/issues Github Issues ticket]
#* V1 can use [https://github.com/pine64/pine64_updater Pine64 Easy Updater here (Windows/MAC)]
#* Requires a data capable USB cable connected to a laptop or some appropriate device.
#* To enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* Screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
# 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
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS]
# 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)
#* most tips come with pre-dipped in solder for protection. heat them up, clean with brass or solder sponge and inspect.
#* See [[#Caring for a soldering iron]] for maintenance and soldering tips
#* Re-tin the tip before storing is advised to prevent oxidation.
# It heats up an installed tip, and stops increasing when it reaches the set point
#* This may draw up to ~3A, make sure the [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# If there are multiple tips, clean all of them with IPA and check all of them.
# If the tip moves a little while using it, try to hold Pinecil with the screen sideways or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel.

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Click Here for Compatible Power Supplies and Cables]'''
|}

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V '''3A''' and QC 3.0 12V-20V '''3A''' (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, '''minimum 3amps.'''
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and [https://ralim.github.io/IronOS/ IronOS firmware].
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw. It was found that an M2x3mm thumb screw for the tip just grazes the Tip and the '''longer M2 x4mm is better on top'''.
** [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (2) Thumb screw] [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://ralim.github.io/IronOS/#getting-started Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|Thumb screws on V1 & V2 |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in the firmware?]'''
* '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of the tip look like?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Guides for Soldering & Maintenance ==

=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=gnU80BRM5Vs Why have different tips?]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/watch?v=vIT4ra6Mo0s&list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Switching to Lead-free solder]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== Does Solder type and Flux matter? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

=== What Temperature should I use? ===
* Generally, add 120°C to the melting point listed on the solder label, and adjust up or down as needed for different tasks.
* If there is no listed melting point, refer to google or a chart like below:
** [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
** [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Solder Temperature Chart]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]

* 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.

== Schematics, Board data, and Certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* USB-C PD Controller data:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX, location U1]
*** [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-ICs_onsemi-Fusb302mpx_C442699.html Replacement FUSB302MPX]

* Power Regulators:
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator, location U5]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, location U8]
*** [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html Replacement TP6841S6-A]

* Sensor data:
** [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20, Acceleration/Gyroscope sensor, Silan, location U9]
** [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTC Temperature Sensor, location NTC1 (U10 will be empty if NTC is used)]
*** [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html Replacement NTCG163JF103FTDS]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor Si7210-B-00-IV(R), by Silicon Labs, Optional add-on, location U14]
*** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
*** [https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Get it here]

* Power MOSFET Switch:
** [https://datasheet.lcsc.com/lcsc/2105241831_HUASHUO-HSM4313_C2828487.pdf HSM4313 MOSFET, location U13]
** [https://lcsc.com/product-detail/MOSFETs_HUASHUO-HSM4313_C2828487.html Replacement HSM4313]

* Operational Amplifier:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGM8557-1,SGMicro , Low Noise OP Amp Datasheet, location U11]

* Display Screen OLED:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG-9616TSWCG02 Display OLED Datasheet]
** [https://www.lcsc.com/product-detail/OLED-Displays-Modules_UG-Univision-Semicon-UG-9616TSWCG02_C88335.html Replacement QUG-9616TSWCG02 OLED Display]

* MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet, location U15]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
*** [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator 32MHZ/12PF-10PPM, SMD2016-4P, location UX1]
*** [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html Replacement SMD Resonator 32MHz/12PF-10PPM]

=== Pinecil V1 ===
* GigaDevice RISC-V SoC data:
** [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]
* Sensor data:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet (U10)]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* Display Module data:
** [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 data:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Power Regulator data:
** [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 data:
** [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]

== Pinecil in Media ==
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]

[[Category:Pinecil]]

Pinecil

2022-10-06T11:22:02Z

PineDude: a little more shrinking

[[File:Pinecilv2-1.jpg|300px|thumb|right|'''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 (V2 in Photo)]]

== Pinecil Soldering Iron: main features ==
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://github.com/bouffalolab/bl_mcu_sdk tools from Bouffalo Labs], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== Authenticity ==

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same quality control as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, EU countries pay VAT to delivery person).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil V2)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU, VAT+ 2-year warranty included per EU laws)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from California, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)
* [https://www.ursele.com/contact URS Electronics] (local in-store sales only in Portland, Oregon, USA)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official [https://ralim.github.io/IronOS/ Github IronOS firmware], will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work? (main Pine store info. below)'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping (~$12): could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive (~$30), takes 4-10 business days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy] (30-day warranty starts when Pinecil is delivered).

* Note: resellers operate independently from the main Pine Store. Get all shipping info on their websites/chat tools/email. They are in different countries and set their own procedures and have different shipping costs/options.

'''Tracking websites'''
* https://parcelsapp.com/
* https://www.17track.net/
* The tracking number issued in the shipping email may not work for a couple days, just check again.
* If you see the message "outbound imports cancelled," just wait. We think it's a poor short coded message. Members experience that it updates after 1-3 days to show a hand off from China Post to a USA facility. The message would be more clear if it was "outbound imports transferred/complete".

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply].
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ Github IronOS for details on firmware] settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended ([https://wiki.pine64.org/wiki/Pinecil_Power_Supplies see Power Supply page]).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Power Supply page]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://ralim.github.io/IronOS/GettingStarted/ Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://ralim.github.io/IronOS/Settings/ Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore default/factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major [https://ralim.github.io/IronOS/GettingStarted/ firmware update] as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': are also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners in the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://ralim.github.io/IronOS/ open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Long hold down <code>'''[-]'''</code> to see the firmware version
* [https://ralim.github.io/IronOS/GettingStarted/ Firmware update instructions]

* To submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/issues Ralim's IronOS Issues]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
* To give some love back, you could donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://ralim.github.io/IronOS/ Ralim's IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| *Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact).
|-style="background-color:LightYellow"
| *Do not bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| *Pinecil only uses one power port, the USB-C or the DC barrel, but never both at the same time. Damage will occur if attempted.
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# The display turns on when 5-24V is supplied (5-21V for older V1 models).
#* Use a USB type C cable or a DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are are used independently and not at the same time.
#* Note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the type C cable (try to flip it if one way doesn't work)
# Check Update mode [https://ralim.github.io/IronOS/#getting-started (see Ralim/IronOS for details on flashing updates)]
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in a a time. You could damage devices doing this.
#* V2 does not have an new release yet (2.18 is the highest release version as of Oct.1, 2022).
#** It will need a different type of Updater/flasher which will be announced on Github/Ironos when a new release is available.
#** V2 owners with EPR 28V chargers are advised to join the Community chat linked in the wiki for possible Beta firmware versions.
#** If you have issues with V2 firmware, create a new [https://github.com/Ralim/IronOS/issues Github Issues ticket]
#* V1 can use [https://github.com/pine64/pine64_updater Pine64 Easy Updater here (Windows/MAC)]
#* Requires a data capable USB cable connected to a laptop or some appropriate device.
#* To enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* Screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
# 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
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS]
# 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)
#* most tips come with pre-dipped in solder for protection. heat them up, clean with brass or solder sponge and inspect.
#* See [[#Caring for a soldering iron]] for maintenance and soldering tips
#* Re-tin the tip before storing is advised to prevent oxidation.
# It heats up an installed tip, and stops increasing when it reaches the set point
#* This may draw up to ~3A, make sure the [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# If there are multiple tips, clean all of them with IPA and check all of them.
# If the tip moves a little while using it, try to hold Pinecil with the screen sideways or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel.

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Click Here for Compatible Power Supplies and Cables]'''
|}

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V '''3A''' and QC 3.0 12V-20V '''3A''' (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, '''minimum 3amps.'''
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and [https://ralim.github.io/IronOS/ IronOS firmware].
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw. It was found that an M2x3mm thumb screw for the tip just grazes the Tip and the '''longer M2 x4mm is better on top'''.
** [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (2) Thumb screw] [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://ralim.github.io/IronOS/#getting-started Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|Thumb screws on V1 & V2 |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in the firmware?]'''
* '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of the tip look like?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Guides for Soldering & Maintenance ==

=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=gnU80BRM5Vs Why have different tips?]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/watch?v=vIT4ra6Mo0s&list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Switching to Lead-free solder]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== Does Solder type and Flux matter? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

=== What Temperature should I use? ===
* Generally, add 120°C to the melting point listed on the solder label, and adjust up or down as needed for different tasks.
* If there is no listed melting point, refer to google or a chart like below:
** [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
** [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Solder Temperature Chart]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]

* 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.

== Schematics, Board data, and Certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* USB-C PD Controller data:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX, location U1]
*** [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-ICs_onsemi-Fusb302mpx_C442699.html Replacement FUSB302MPX]

* Power Regulators:
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator, location U5]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, location U8]
*** [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html Replacement TP6841S6-A]

* Sensor data:
** [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20, Acceleration/Gyroscope sensor, Silan, location U9]
** [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTC Temperature Sensor, location NTC1 (U10 will be empty if NTC is used)]
*** [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html Replacement NTCG163JF103FTDS]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor Si7210-B-00-IV(R), by Silicon Labs, Optional add-on, location U14]
*** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
*** [https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Get it here]

* Power MOSFET Switch:
** [https://datasheet.lcsc.com/lcsc/2105241831_HUASHUO-HSM4313_C2828487.pdf HSM4313 MOSFET, location U13]
** [https://lcsc.com/product-detail/MOSFETs_HUASHUO-HSM4313_C2828487.html Replacement HSM4313]

* Operational Amplifier:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGM8557-1,SGMicro , Low Noise OP Amp Datasheet, location U11]

* Display Screen OLED:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG-9616TSWCG02 Display OLED Datasheet]
** [https://www.lcsc.com/product-detail/OLED-Displays-Modules_UG-Univision-Semicon-UG-9616TSWCG02_C88335.html Replacement QUG-9616TSWCG02 OLED Display]

* MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet, location U15]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
*** [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator 32MHZ/12PF-10PPM, SMD2016-4P, location UX1]
*** [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html Replacement SMD Resonator 32MHz/12PF-10PPM]

=== Pinecil V1 ===
* GigaDevice RISC-V SoC data:
** [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]
* Sensor data:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet (U10)]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* Display Module data:
** [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 data:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Power Regulator data:
** [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 data:
** [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]

== Pinecil in Media ==
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]

[[Category:Pinecil]]

Pinecil

2022-10-06T10:40:43Z

PineDude: Shrink top image to make page scale down better.

[[File:Pinecilv2-1.jpg|350px|thumb|right|'''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 (V2 in Photo)]]

== Pinecil Soldering Iron: main features ==
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://github.com/bouffalolab/bl_mcu_sdk tools from Bouffalo Labs], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== Authenticity ==

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same quality control as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, EU countries pay VAT to delivery person).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil V2)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU, VAT+ 2-year warranty included per EU laws)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from California, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)
* [https://www.ursele.com/contact URS Electronics] (local in-store sales only in Portland, Oregon, USA)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official [https://ralim.github.io/IronOS/ Github IronOS firmware], will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work? (main Pine store info. below)'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping (~$12): could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive (~$30), takes 4-10 business days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy] (30-day warranty starts when Pinecil is delivered).

* Note: resellers operate independently from the main Pine Store. Get all shipping info on their websites/chat tools/email. They are in different countries and set their own procedures and have different shipping costs/options.

'''Tracking websites'''
* https://parcelsapp.com/
* https://www.17track.net/
* The tracking number issued in the shipping email may not work for a couple days, just check again.
* If you see the message "outbound imports cancelled," just wait. We think it's a poor short coded message. Members experience that it updates after 1-3 days to show a hand off from China Post to a USA facility. The message would be more clear if it was "outbound imports transferred/complete".

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply].
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ Github IronOS for details on firmware] settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended ([https://wiki.pine64.org/wiki/Pinecil_Power_Supplies see Power Supply page]).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Power Supply page]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://ralim.github.io/IronOS/GettingStarted/ Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://ralim.github.io/IronOS/Settings/ Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore default/factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major [https://ralim.github.io/IronOS/GettingStarted/ firmware update] as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': are also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners in the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://ralim.github.io/IronOS/ open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Long hold down <code>'''[-]'''</code> to see the firmware version
* [https://ralim.github.io/IronOS/GettingStarted/ Firmware update instructions]

* To submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/issues Ralim's IronOS Issues]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
* To give some love back, you could donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://ralim.github.io/IronOS/ Ralim's IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| *Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact).
|-style="background-color:LightYellow"
| *Do not bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| *Pinecil only uses one power port, the USB-C or the DC barrel, but never both at the same time. Damage will occur if attempted.
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# The display turns on when 5-24V is supplied (5-21V for older V1 models).
#* Use a USB type C cable or a DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are are used independently and not at the same time.
#* Note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the type C cable (try to flip it if one way doesn't work)
# Check Update mode [https://ralim.github.io/IronOS/#getting-started (see Ralim/IronOS for details on flashing updates)]
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in a a time. You could damage devices doing this.
#* V2 does not have an new release yet (2.18 is the highest release version as of Oct.1, 2022).
#** It will need a different type of Updater/flasher which will be announced on Github/Ironos when a new release is available.
#** V2 owners with EPR 28V chargers are advised to join the Community chat linked in the wiki for possible Beta firmware versions.
#** If you have issues with V2 firmware, create a new [https://github.com/Ralim/IronOS/issues Github Issues ticket]
#* V1 can use [https://github.com/pine64/pine64_updater Pine64 Easy Updater here (Windows/MAC)]
#* Requires a data capable USB cable connected to a laptop or some appropriate device.
#* To enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* Screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
# 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
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS]
# 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)
#* most tips come with pre-dipped in solder for protection. heat them up, clean with brass or solder sponge and inspect.
#* See [[#Caring for a soldering iron]] for maintenance and soldering tips
#* Re-tin the tip before storing is advised to prevent oxidation.
# It heats up an installed tip, and stops increasing when it reaches the set point
#* This may draw up to ~3A, make sure the [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# If there are multiple tips, clean all of them with IPA and check all of them.
# If the tip moves a little while using it, try to hold Pinecil with the screen sideways or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel.

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Click Here for Compatible Power Supplies and Cables]'''
|}

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V '''3A''' and QC 3.0 12V-20V '''3A''' (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, '''minimum 3amps.'''
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and [https://ralim.github.io/IronOS/ IronOS firmware].
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw. It was found that an M2x3mm thumb screw for the tip just grazes the Tip and the '''longer M2 x4mm is better on top'''.
** [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (2) Thumb screw] [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://ralim.github.io/IronOS/#getting-started Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|Thumb screws on V1 & V2 |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in the firmware?]'''
* '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of the tip look like?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Guides for Soldering & Maintenance ==

=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=gnU80BRM5Vs Why have different tips?]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/watch?v=vIT4ra6Mo0s&list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Switching to Lead-free solder]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== Does Solder type and Flux matter? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

=== What Temperature should I use? ===
* Generally, add 120°C to the melting point listed on the solder label, and adjust up or down as needed for different tasks.
* If there is no listed melting point, refer to google or a chart like below:
** [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
** [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Solder Temperature Chart]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]

* 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.

== Schematics, Board data, and Certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* USB-C PD Controller data:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX, location U1]
*** [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-ICs_onsemi-Fusb302mpx_C442699.html Replacement FUSB302MPX]

* Power Regulators:
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator, location U5]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, location U8]
*** [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html Replacement TP6841S6-A]

* Sensor data:
** [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20, Acceleration/Gyroscope sensor, Silan, location U9]
** [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTC Temperature Sensor, location NTC1 (U10 will be empty if NTC is used)]
*** [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html Replacement NTCG163JF103FTDS]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor Si7210-B-00-IV(R), by Silicon Labs, Optional add-on, location U14]
*** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
*** [https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Get it here]

* Power MOSFET Switch:
** [https://datasheet.lcsc.com/lcsc/2105241831_HUASHUO-HSM4313_C2828487.pdf HSM4313 MOSFET, location U13]
** [https://lcsc.com/product-detail/MOSFETs_HUASHUO-HSM4313_C2828487.html Replacement HSM4313]

* Operational Amplifier:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGM8557-1,SGMicro , Low Noise OP Amp Datasheet, location U11]

* Display Screen OLED:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG-9616TSWCG02 Display OLED Datasheet]
** [https://www.lcsc.com/product-detail/OLED-Displays-Modules_UG-Univision-Semicon-UG-9616TSWCG02_C88335.html Replacement QUG-9616TSWCG02 OLED Display]

* MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet, location U15]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
*** [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator 32MHZ/12PF-10PPM, SMD2016-4P, location UX1]
*** [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html Replacement SMD Resonator 32MHz/12PF-10PPM]

=== Pinecil V1 ===
* GigaDevice RISC-V SoC data:
** [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]
* Sensor data:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet (U10)]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* Display Module data:
** [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 data:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Power Regulator data:
** [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 data:
** [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]

== Pinecil in Media ==
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]

[[Category:Pinecil]]

Pinecil

2022-10-06T09:29:53Z

PineDude: Syntax fix

[[File:Pinecilv2-1.jpg|400px|thumb|right|'''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 (V2 in Photo)]]

== The Pinecil Soldering Iron's main features are: ==
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://github.com/bouffalolab/bl_mcu_sdk tools from Bouffalo Labs], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== Authenticity ==

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same quality control as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, EU countries pay VAT to delivery person).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil V2)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU, VAT+ 2-year warranty included per EU laws)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from California, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)
* [https://www.ursele.com/contact URS Electronics] (local in-store sales only in Portland, Oregon, USA)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official [https://ralim.github.io/IronOS/ Github IronOS firmware], will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work? (main Pine store info. below)'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping (~$12): could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive (~$30), takes 4-10 business days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy] (30-day warranty starts when Pinecil is delivered).

* Note: resellers operate independently from the main Pine Store. Get all shipping info on their websites/chat tools/email. They are in different countries and set their own procedures and have different shipping costs/options.

'''Tracking websites'''
* https://parcelsapp.com/
* https://www.17track.net/
* The tracking number issued in the shipping email may not work for a couple days, just check again.
* If you see the message "outbound imports cancelled," just wait. We think it's a poor short coded message. Members experience that it updates after 1-3 days to show a hand off from China Post to a USA facility. The message would be more clear if it was "outbound imports transferred/complete".

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply].
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ Github IronOS for details on firmware] settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended ([https://wiki.pine64.org/wiki/Pinecil_Power_Supplies see Power Supply page]).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Power Supply page]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://ralim.github.io/IronOS/GettingStarted/ Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://ralim.github.io/IronOS/Settings/ Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore default/factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major [https://ralim.github.io/IronOS/GettingStarted/ firmware update] as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': are also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners in the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://ralim.github.io/IronOS/ open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Long hold down <code>'''[-]'''</code> to see the firmware version
* [https://ralim.github.io/IronOS/GettingStarted/ Firmware update instructions]

* To submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/issues Ralim's IronOS Issues]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
* To give some love back, you could donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://ralim.github.io/IronOS/ Ralim's IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| *Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact).
|-style="background-color:LightYellow"
| *Do not bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| *Pinecil only uses one power port, the USB-C or the DC barrel, but never both at the same time. Damage will occur if attempted.
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# The display turns on when 5-24V is supplied (5-21V for older V1 models).
#* Use a USB type C cable or a DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are are used independently and not at the same time.
#* Note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the type C cable (try to flip it if one way doesn't work)
# Check Update mode [https://ralim.github.io/IronOS/#getting-started (see Ralim/IronOS for details on flashing updates)]
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in a a time. You could damage devices doing this.
#* V2 does not have an new release yet (2.18 is the highest release version as of Oct.1, 2022).
#** It will need a different type of Updater/flasher which will be announced on Github/Ironos when a new release is available.
#** V2 owners with EPR 28V chargers are advised to join the Community chat linked in the wiki for possible Beta firmware versions.
#** If you have issues with V2 firmware, create a new [https://github.com/Ralim/IronOS/issues Github Issues ticket]
#* V1 can use [https://github.com/pine64/pine64_updater Pine64 Easy Updater here (Windows/MAC)]
#* Requires a data capable USB cable connected to a laptop or some appropriate device.
#* To enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* Screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
# 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
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS]
# 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)
#* most tips come with pre-dipped in solder for protection. heat them up, clean with brass or solder sponge and inspect.
#* See [[#Caring for a soldering iron]] for maintenance and soldering tips
#* Re-tin the tip before storing is advised to prevent oxidation.
# It heats up an installed tip, and stops increasing when it reaches the set point
#* This may draw up to ~3A, make sure the [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# If there are multiple tips, clean all of them with IPA and check all of them.
# If the tip moves a little while using it, try to hold Pinecil with the screen sideways or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel.

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V '''3A''' and QC 3.0 12V-20V '''3A''' (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, '''minimum 3amps.'''
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and [https://ralim.github.io/IronOS/ IronOS firmware].
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw. It was found that an M2x3mm thumb screw for the tip just grazes the Tip and the '''longer M2 x4mm is better on top'''.
** [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (2) Thumb screw] [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://ralim.github.io/IronOS/#getting-started Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Click Here for Compatible Power Supplies and Cables]'''
|}

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|Thumb screws on V1 & V2 |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in the firmware?]'''
* '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of the tip look like?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Guides for Soldering & Maintenance ==

=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=gnU80BRM5Vs Different Tips]
* [https://www.youtube.com/watch?v=vIT4ra6Mo0s&list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Switching to Lead-free solder]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== Does Solder type and Flux matter? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

=== What Temperature should I use? ===
* Generally, add 120°C to the melting point listed on the solder label, and adjust up or down as needed for different tasks.
* If there is no listed melting point, refer to google or a chart like below:
** [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
** [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Solder Temperature Chart]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]

* 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.

== Schematics, Board data, and Certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* USB-C PD Controller data:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX, location U1]
*** [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-ICs_onsemi-Fusb302mpx_C442699.html Replacement FUSB302MPX]

* Power Regulators:
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator, location U5]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, location U8]
*** [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html Replacement TP6841S6-A]

* Sensor data:
** [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20, Acceleration/Gyroscope sensor, Silan, location U9]
** [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTC Temperature Sensor, location NTC1 (U10 will be empty if NTC is used)]
*** [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html Replacement NTCG163JF103FTDS]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor Si7210-B-00-IV(R), by Silicon Labs, Optional add-on, location U14]
*** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
*** [https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Get it here]

* Power MOSFET Switch:
** [https://datasheet.lcsc.com/lcsc/2105241831_HUASHUO-HSM4313_C2828487.pdf HSM4313 MOSFET, location U13]
** [https://lcsc.com/product-detail/MOSFETs_HUASHUO-HSM4313_C2828487.html Replacement HSM4313]

* Operational Amplifier:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGM8557-1,SGMicro , Low Noise OP Amp Datasheet, location U11]

* Display Screen OLED:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG-9616TSWCG02 Display OLED Datasheet]
** [https://www.lcsc.com/product-detail/OLED-Displays-Modules_UG-Univision-Semicon-UG-9616TSWCG02_C88335.html Replacement QUG-9616TSWCG02 OLED Display]

* MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet, location U15]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
*** [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator 32MHZ/12PF-10PPM, SMD2016-4P, location UX1]
*** [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html Replacement SMD Resonator 32MHz/12PF-10PPM]

=== Pinecil V1 ===
* GigaDevice RISC-V SoC data:
** [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]
* Sensor data:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet (U10)]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* Display Module data:
** [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 data:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Power Regulator data:
** [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 data:
** [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]

== Pinecil in Media ==
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]

[[Category:Pinecil]]

Pinecil

2022-10-06T09:25:12Z

PineDude: Promote Main Features to front and center.

[[File:Pinecilv2-1.jpg|400px|thumb|right|'''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 (V2 in Photo)]]

== The Pinecil Soldering Iron's main features are:
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://github.com/bouffalolab/bl_mcu_sdk tools from Bouffalo Labs], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== Authenticity ==

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same quality control as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, EU countries pay VAT to delivery person).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil V2)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU, VAT+ 2-year warranty included per EU laws)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from California, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)
* [https://www.ursele.com/contact URS Electronics] (local in-store sales only in Portland, Oregon, USA)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official [https://ralim.github.io/IronOS/ Github IronOS firmware], will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work? (main Pine store info. below)'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping (~$12): could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive (~$30), takes 4-10 business days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy] (30-day warranty starts when Pinecil is delivered).

* Note: resellers operate independently from the main Pine Store. Get all shipping info on their websites/chat tools/email. They are in different countries and set their own procedures and have different shipping costs/options.

'''Tracking websites'''
* https://parcelsapp.com/
* https://www.17track.net/
* The tracking number issued in the shipping email may not work for a couple days, just check again.
* If you see the message "outbound imports cancelled," just wait. We think it's a poor short coded message. Members experience that it updates after 1-3 days to show a hand off from China Post to a USA facility. The message would be more clear if it was "outbound imports transferred/complete".

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply].
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ Github IronOS for details on firmware] settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power supply] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended ([https://wiki.pine64.org/wiki/Pinecil_Power_Supplies see Power Supply page]).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Power Supply page]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://ralim.github.io/IronOS/GettingStarted/ Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://ralim.github.io/IronOS/Settings/ Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore default/factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major [https://ralim.github.io/IronOS/GettingStarted/ firmware update] as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': are also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners in the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://ralim.github.io/IronOS/ open source Ralim's IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Long hold down <code>'''[-]'''</code> to see the firmware version
* [https://ralim.github.io/IronOS/GettingStarted/ Firmware update instructions]

* To submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/issues Ralim's IronOS Issues]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
* To give some love back, you could donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://ralim.github.io/IronOS/ Ralim's IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| *Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact).
|-style="background-color:LightYellow"
| *Do not bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| *Pinecil only uses one power port, the USB-C or the DC barrel, but never both at the same time. Damage will occur if attempted.
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# The display turns on when 5-24V is supplied (5-21V for older V1 models).
#* Use a USB type C cable or a DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are are used independently and not at the same time.
#* Note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the type C cable (try to flip it if one way doesn't work)
# Check Update mode [https://ralim.github.io/IronOS/#getting-started (see Ralim/IronOS for details on flashing updates)]
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in a a time. You could damage devices doing this.
#* V2 does not have an new release yet (2.18 is the highest release version as of Oct.1, 2022).
#** It will need a different type of Updater/flasher which will be announced on Github/Ironos when a new release is available.
#** V2 owners with EPR 28V chargers are advised to join the Community chat linked in the wiki for possible Beta firmware versions.
#** If you have issues with V2 firmware, create a new [https://github.com/Ralim/IronOS/issues Github Issues ticket]
#* V1 can use [https://github.com/pine64/pine64_updater Pine64 Easy Updater here (Windows/MAC)]
#* Requires a data capable USB cable connected to a laptop or some appropriate device.
#* To enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* Screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
# 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
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS]
# 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)
#* most tips come with pre-dipped in solder for protection. heat them up, clean with brass or solder sponge and inspect.
#* See [[#Caring for a soldering iron]] for maintenance and soldering tips
#* Re-tin the tip before storing is advised to prevent oxidation.
# It heats up an installed tip, and stops increasing when it reaches the set point
#* This may draw up to ~3A, make sure the [https://wiki.pine64.org/wiki/Pinecil_Power_Supplies power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# If there are multiple tips, clean all of them with IPA and check all of them.
# If the tip moves a little while using it, try to hold Pinecil with the screen sideways or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel.

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V '''3A''' and QC 3.0 12V-20V '''3A''' (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, '''minimum 3amps.'''
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and [https://ralim.github.io/IronOS/ IronOS firmware].
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Display:''' 0.67" QUG 9616TSWCG02 96x16 Monochrome Matrix display
* '''CPU:''' GD32VF103TB 32-bit RV32IMAC RISC-V “Bumblebee Core” @ 108 MHz
* '''Memory:'''
** 128KB Flash
** 32KB SRAM
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw. It was found that an M2x3mm thumb screw for the tip just grazes the Tip and the '''longer M2 x4mm is better on top'''.
** [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (2) Thumb screw] [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://ralim.github.io/IronOS/#getting-started Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

{| class="wikitable"
|-style="background-color:LightYellow"
| '''[https://wiki.pine64.org/wiki/Pinecil_Power_Supplies Click Here for Compatible Power Supplies and Cables]'''
|}

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|Thumb screws on V1 & V2 |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in the firmware?]'''
* '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of the tip look like?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Guides for Soldering & Maintenance ==

=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=gnU80BRM5Vs Different Tips]
* [https://www.youtube.com/watch?v=vIT4ra6Mo0s&list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Switching to Lead-free solder]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== Does Solder type and Flux matter? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

=== What Temperature should I use? ===
* Generally, add 120°C to the melting point listed on the solder label, and adjust up or down as needed for different tasks.
* If there is no listed melting point, refer to google or a chart like below:
** [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
** [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Solder Temperature Chart]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]

* 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.

== Schematics, Board data, and Certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* USB-C PD Controller data:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX, location U1]
*** [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-ICs_onsemi-Fusb302mpx_C442699.html Replacement FUSB302MPX]

* Power Regulators:
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator, location U5]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, location U8]
*** [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html Replacement TP6841S6-A]

* Sensor data:
** [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20, Acceleration/Gyroscope sensor, Silan, location U9]
** [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTC Temperature Sensor, location NTC1 (U10 will be empty if NTC is used)]
*** [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html Replacement NTCG163JF103FTDS]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor Si7210-B-00-IV(R), by Silicon Labs, Optional add-on, location U14]
*** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
*** [https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Get it here]

* Power MOSFET Switch:
** [https://datasheet.lcsc.com/lcsc/2105241831_HUASHUO-HSM4313_C2828487.pdf HSM4313 MOSFET, location U13]
** [https://lcsc.com/product-detail/MOSFETs_HUASHUO-HSM4313_C2828487.html Replacement HSM4313]

* Operational Amplifier:
** [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGM8557-1,SGMicro , Low Noise OP Amp Datasheet, location U11]

* Display Screen OLED:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG-9616TSWCG02 Display OLED Datasheet]
** [https://www.lcsc.com/product-detail/OLED-Displays-Modules_UG-Univision-Semicon-UG-9616TSWCG02_C88335.html Replacement QUG-9616TSWCG02 OLED Display]

* MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet, location U15]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
*** [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator 32MHZ/12PF-10PPM, SMD2016-4P, location UX1]
*** [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html Replacement SMD Resonator 32MHz/12PF-10PPM]

=== Pinecil V1 ===
* GigaDevice RISC-V SoC data:
** [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]
* Sensor data:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet (U10)]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* Display Module data:
** [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 data:
** [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF ON Semiconductor FUSB302 USB Type-C PD Controller Datasheet]
* Power Regulator data:
** [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 data:
** [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]

== Pinecil in Media ==
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]

[[Category:Pinecil]]

Pinecil

2022-09-19T05:55:29Z

PineDude: Prepare to move Power Supplies to new page

[[File:Pinecilv2-1.jpg|400px|thumb|right|Pinecil Version 2]]

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.

== Authenticity ==

{{Sidebar|The Pinecil's main features are:
* Portability
* Settable temperature
* Soldering tips:
** Replaceable
** Many styles available. [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
** Compatible with TS100
* Flexible power sources:
** USB Type C power delivery
** DC 5525 Barrel jack
** Battery: 3S/4S/5S LiPo batteries or 18V-21V Lithium-ion tool batteries
* Pinecil V2 has a BL706 chip, see batch changes below.
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

There are additional features that include (useful for devkit):

* A Programmable Risc-V BL706 embedded processor
* 0.69" Monochrome Display that can render text or graphics
* Support for Idle detection, sleep mode of tip, automatic shut-down
* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].}}

There are no PINE64 Pinecils sold on AliExpress. They are not made by PINE64. There are no authorized resellers on AliExpress. Some manfacturer has copied the PINE64 company name, trademark and Pinecone logo and is selling a product made to look like Pinecil through many store fronts, but it is not an authentic. They use a different type of box, i.e., a blue or red box. They are all fake copies and do not go through the same QC as Pine64. It is unclear what type of chips or poor quality cloned chips are used in them. They are not recommended. Genuine Pine64 Pinecil only comes in a black color with a silicone thumb grip (sky blue V1, teal green V2). The original V1 always came in a black box. This model was discontinued and has not been made or sold by PINE64 or authorized resellers since July 2022.

The current official Pinecil (a.k.a. V2) only comes in a white box (see Pictures), it has a black color handle with a teal green silicone thumb grip. If you receive anything that has the PINE64 brand name and Pinecone and does not look like described, it is a fake copy that was not made or authorized by PINE64 or the Pine Store Ltd (see Authenticity Checker below, all real PINE64 Pinecils purchased after Aug. 2, 2022 should pass the checker if they are genuine).

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number.
Check if your Pinecil is Authentic here:

<code>'''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''</code>

=== Where to buy a Pinecil ===

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, carries full line of PINE64 products)
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only has Pinecil)

'''PINE64 EU'''
* [https://pine64eu.com/about/ PINE64 EU store] (ships from EU)

'''Official affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (ships from USA, offers pre-order)

'''Other sites selling real Pinecil'''
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from UK)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103) at the Pine Store & all resellers. There are zero new authentic Pinecil V1 sold in the world after July 2022. Pinecil V1 was made in a black color with a sky blue finger grip. PINE64 never made an all-blue pinecil, and never used blue or red color boxes (those are fake copies with fake PINE64 logos and Pinecone).

Starting Aug. 2, 2022, only the new Pinecil V2 model with the new BL706 BLE bluetooth MCU are made by PINE64 and sold at all authentic resellers. They are black with a green finger grip (see photos in [https://wiki.pine64.org/wiki/Pinecil#Pictures the Picture section]). The new model has anti-counterfeiting features. Authentic Pinecil using the newest official Github IronOS firmware, will successfully pass the [https://pinecil.pine64.org/ Authenticiy Checker website]. If a new Pinecil does not have a BL706 chip, then it is a fake counterfeit. If the AliExpress seller tries to show "CE certification" documents as some type of proof, those are all copied public info from this Wiki page in the [https://wiki.pine64.org/wiki/Pinecil#Pinecil_board_information,_schematics_and_certifications Certifications section]. PINE64 publishes those as they are the CE/FCC certifications for the stamps on the Pinecil. They are not proof of purchase from the Pine Store Ltd.

== Shipping & Tracking ==
'''How does it work?'''
* '''Order Email''': when the Pine Store receives an order, an initial email is sent out within one day. This email confirms your order was charged (check spam folders for 'Pine Store').
* '''Shipping Email''': after several more days, when the order is shipped, a '''second''' email is sent with a tracking number. This could take a week or more depending on China holidays, non-working days, health lock-down, or an overwhelming number of orders. In general, people report getting a shipping/tracking email within 5 days, just wait for this email (search emails for 'Pine Store').
* If you don't get the first email soon after placing the order, then contact the Pine store as your order may not have completed or been charged.
* Cheap shipping option: could take 3-7 weeks (a few reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs.
* Courier shipping: more expensive, takes 4-7 days based on feedback from PINE64 members.
* [https://pine64.com/shipping-policy/ Pine Store shipping policy]

'''Tracking websites'''
* https://www.17track.net/
* https://parcelsapp.com/
* The tracking number issued in the shipping email may not work for a couple days, just check again.

== Usage ==
=== Overview ===
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with isopropyl alcohol IPA to remove factory residue before installing.
|-style="background-color:LightYellow"
| Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).
|}

# '''Install the Tip''': pinecil comes with a separate heating element, the tip.
## Remove the screw from the front top-side of handle. Then, gently push it all the way back until the wide collar/guard is touching the front of the plastic [https://wiki.pine64.org/images/thumb/b/b0/Pinecilv2-1.jpg/400px-Pinecilv2-1.jpg (see photo)].
## '''Gently''' tighten/loosen this one screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
## The bottom front screw should not touch the tip, it only holds the handle together ([https://wiki.pine64.org/wiki/Pinecil#Fasteners see fasteners]).
# '''Supply Power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.
## USB port at 5 volts (i.e., laptop) shows '''DC Low''', this is enough for firmware updates and to view the menu, but not to run the soldering iron.
## See Power section for details on power options. [https://wiki.pine64.org/wiki/Pinecil#Potential_Watts_of_different_Power_Supplies QC 12V phone chargers will not work, too weak]
# '''Heat the Tip''': plug Pinecil into an appropriate power supply.
## Clicking <code>'''[+]'''</code> starts the tip heating.
## The detailed display option shows power draw, current temperature, supply voltage, and estimated time to reach target temperature.
## Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
## Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
## You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see Github IronOS for details on firmware settings).
# '''Using the Settings Menu''':
## To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22"
### This is the firmware number and release date, the date is July 13, 2022 in the example.
## Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see Getting Started section.
## Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
## Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then Click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.
# '''Important notes''':
## 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.
## '''For Safety, unplug''' the soldering Iron when not in use or left unattended.
## To heat up the tip, we need a power supply that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended (see Power Supply section).
### Option 1: a USB-C supply that can negotiate up to such a voltage. For maximum performance and good soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
### Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
### Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adaptor, and a cable to plug into the Pinecil DC5525 barrel jack.
### You may have a suitable supply already that could be used, (see [https://wiki.pine64.org/wiki/Pinecil#Power_Supply_Compatibility Power Supply section below]).
### While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V Usb-C charger or a higher rated DC barrel charger.
### See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started ===
* '''Getting Started''' guide in [https://github.com/Ralim/IronOS/blob/dev/Documentation/GettingStarted.md Github/IronOS]

* '''Main Settings Menu''': updated list is found in the firmware repository '''[https://github.com/Ralim/IronOS/blob/dev/Documentation/Settings.md IronOS Settings Menu]'''
** '''Power settings''': settings related to power, battery cells, input voltage.
** '''Soldering settings''': settings for soldering such as, boost temps, increments for temperature change
** '''Sleep mode''': power & tip saving, such as sleep mode, sleep temperature, and shutdown modes, motion sensitivity
** '''User interface''': settings such as, units C/F, display orientation, button reversal, animation speed, brightness, boot logo duration
** '''Advanced settings''': assorted catchall for settings that don't fit elsewhere or settings that require some thought before use. Restore factory settings is here. It will not change the firmware version, but rather resets the menu back to IronOS defaults. This is good to do after a major firmware update as settings may have been altered and need to be re-selected/customized again to work as expected.

* '''Hidden Debug Menus''': [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md are also available, see Github/IronOS]

=== Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Installing Optional Hall Effect Sensor]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]

== Community links ==
* Want to hang out with other PINE64 Pinecil owners or the PINE64 open source community?
* Need troubleshooting advice on PINE64 pinecil?

'''Join one of the Community Chat links'''

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

== Firmware ==

The official firmware that comes with the Pinecil is [https://github.com/Ralim/IronOS open source IronOS]. It's a good idea to check for updates regularly as development is very active and there may be enhancements or new bug fixes available.

* Hold down <code>'''[-]'''</code> to see the firmware version
* [https://github.com/Ralim/IronOS/blob/master/Documentation/Flashing.md#pinecil-pine64 Firmware update instructions]

* To explore documentation on Menu or settings, submit a feature request, or help Ralim enhance the code, see [https://github.com/Ralim/IronOS/tree/master/Documentation GitHub Ralim/IronOS]

* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in rom. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware.

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Community Chat Links] if you run into issues updating.

== Development efforts ==

{| class="wikitable" | style="text-align:center; "
! Author
! Project Homepage
! Description

|-
| Ben Brown (ralimtek) || '''[https://github.com/Ralim/IronOS/ Github Ralim/IronOS]''' || Official Pinecil firmware
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs alvinhochun/gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| Clean new tips with Isopropyl alcohol to remove factory residue before installing (to avoid strange behavior from poor contact).
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
#
# the display turns on when 5-24V is supplied (5-21V for older V1 models).
#* via USB type C or DC 5525 '''center positive''' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* caution: do '''not''' plug in both USB-C and DC5525 at the same time. This will destroy devices, posibly your laptop/pc.
#* The two ports are intended to be used indenpendently and not at the same time.
#* note that 5v shows '''DC low''' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# it gets 20V from a 20V capable USB-C PD charger
#* check both orientations of the type C cable (try to flip it)
# Check Update mode [https://github.com/Ralim/IronOS/blob/dev/Documentation/Flashing.md#pinecil-pine64 (see Ralim/IronOS for details on flashing)]
#* requires a data capable USB cable connected to a laptop or some appropriate device.
#* to enter update mode, hold down <code>'''[-]'''</code> (button near back/ground screw) while plugging in USB cable.
#* screen is black/blank if you are correctly in update mode. This can be tested even if you are not updating the firmware.
#* note: do not connect the DC barrel at the same time as a USB-C cable, and never when connected to a PC for an Update.
# 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
#* [https://github.com/Ralim/IronOS/blob/dev/Documentation/Settings.md More menu options listed on Github/IronOS]
# 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 power 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 just about melts SAC (lead-free) solder (~190°C for leaded)
# if there are multiple tips, check all of them

== Specifications ==

=== Pinecil V2 ===
* '''Package:''' 15cm x 9cm x 2.2cm, white box (released Aug 2, 2022)
* '''Dimensions:''' 155mm with solder tip or 103mm without solder tip x 12.8mm x 16.2mm
* '''Weight:''' 28g with solder tip, 18g without solder tip
* '''Soldering Tip:''' includes type ST-B2 (short tip), Length 86mm, weight 8.2g
* '''Platform:''' Ralim's IronOS build
* '''Chipset:''' Bouffalo BL-706
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core” @ 144 MHz
* '''Display:''' OLED White Color Monochrome Display 0.69" 96x16 pixels
* '''Memory:'''
** 192KB Internal Flash
** 132KB SRAM System
* '''Power Ports (12V-24V, 88 Watts):'''
** Only use one power port at a time (usb or DC barrel)
** USB type C: PD 12V-20V 3A and QC 3.0 12V-20V 3A (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Barrel Jack: DC5525, 12V-24V, minimum 3amps.
** Trying to use an incorrect barrel jack, i.e., DC5521 will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector] (if it doesn't go in easy, it doesn't fit).
** Recommend operating voltage 12-24V, but a 12V USB-C charger will not perform as well or heat as fast as a USB-C PD65W/20V/3amp charger.
** Tentative support: EPR 140W/28V PD3.1 chargers + EPR cables are theoretically supported in hardware and IronOS firmware.
*** EPR is new technology in 2022. Theoretically Pinecil could get a max of 28V and 126W using EPR chargers & EPR cables (natural loss of 140W to 126W due to Tip ohms).
*** Bleeding edge users are using/testing this.
*** EPR is potentially the fastest/highest performance possible for V2; officially Pine Store states 12V-24V, 88W.

=== Pinecil V1 ===
* '''Package:''' 16.8cm x 11.8cm x 2.3cm, black box with clear plastic front (sold before Aug 2, 2022)
* '''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
* '''Power supply (12V -21V, 65W):'''
** Only use one power port at a time (usb or DC barrel)
** DC 12V-21V 5525 Barrel Jack. Do not try to use a larger 5521 (which requires excessive force). It will [https://forum.pine64.org/showthread.php?tid=13237 BREAK the connector].
** USB-C 12-20V PD or QC3.0 (magnetic tip USB-C cables are not recommended, and not USB compliant)
** Recommend operating voltage 12-21V, some components can tolerate higher voltages at "absolute maximum" but it's very ill-advised

=== Fasteners ===
* Originals are phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]):: two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button. The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter 3mm.
* Thumbs screws are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the top-front Tip holder screw and the ground screw (M2x3mm thumb screw just grazes the Tip, the longer M2 x4mm is better on top).
** [https://www.amazon.com/Knurled-Screws-Shoulder-Stainless-Metric/dp/B01MQSNPD0 (1) Thumb screw], [https://www.aliexpress.com/item/3256801293488521.html (2) Thumb screw], [https://www.aliexpress.com/item/2255799966445780.html (3) Thumb screw]
** [https://www.aliexpress.com/item/3256803069568247.html Smaller head thumb screw]
** [https://www.aliexpress.com/item/3256802759810600.html Bling Gold screws]
** [https://wiki.pine64.org/wiki/File:Pinecil-Thumb-Screws.png Photo of thumb screws on Pinecil]
** If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used to shorten it.
* If you just want to swap out the stock phillips screws for Hex key/Allen screws get (2- m2x4mm & 1- m2x3mm):
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw], [https://www.amazon.com/Socket-Screws-100-piece-Stainless-Thread/dp/B01H1ZF3TO (3) Hex cap screw], [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm (4) Different M2x4mm screw options]

== Manuals ==
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/GettingStarted.md Getting Started Guide IronOS firmware]
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]
* [[:File:Pinecil Shell Replacement Guide.pdf|Pinecil Shell Replacement Guide]]

== Potential Watts of different Power Supplies ==

{| class="wikitable" | style="text-align:center; "
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts

|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| *V2 models tentatively support 28V-140W EPR chargers with certified EPR cables. PINE64 officially states V2 up to 24V-88W.
|}

* Ralim's IronOS firmware supports EPR 28V-140W on Pinecil V2 models.
* EPR is new to the market in 2022; they are expensive and require special EPR cables.
* EPR is backwards compatible for all USB-C devices, so EPR chargers/cables can be used for everything else Usb-C as well.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''QC''' is '''not recommended''' as Pinecil V2 requires a '''minimum of 3 Amps''' or more to work properly ([https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ see Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to ['''Thermal Runaway'''] messages because of weak power.
|}

== Disassembly steps ==

{| class="wikitable" | style="text-align:center; "
|-style="background-color:Honeydew"
| '''[https://www.youtube.com/watch?v=aK01V5DrrVk Video of Alternate Method for opening Pinecil here.]'''
|}

# It is recommended to take photos to help with reassembly.
# Loosen the top tip screw (PH1) (top is the side with the screen).
# Gently pull the tip out and set aside (let the tip cool down first or use protection to prevent burns).
# Slide the rubber thumb grip off the front.
# Remove the bottom-front screw (between the bottom feet (PH1)).
# Remove the ground screw (longer m2x4mm screw next to the screen near the (-) button (PH1)).
# Slightly pull the two halves of the case apart at the tip front end first, enough to get a fingernail or guitar pick between 2 parts.
# 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 sliding it a little forward (it is retained by the top half at the DC barrel side).
# Remove the screws retaining the copper tip contacts (PH000, M1.4 x 5).
# Remove the copper tip contacts (note the orientation of the contacts & tiny tab hole).
# Lift the PCB gently up from Tip end.
# Remove the round copper contact under the PCB, near the tip end of the handle (this is installed first before the PCB).
# Remove the two small buttons so they do not get lost.

== Assembly steps ==

# Place the key caps into their recesses in the top half of the case.
# Install the round copper ground contact at the tip end before installing the PCB.
# Place the PCB assembly into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## 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.

== 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-V2-box-1024x1024.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2 and ST-B2 short tip retail package], sold after Aug. 2, 2022|alt=alt language
File:Pinecilv2-2.jpg| [https://pine64.com/product-category/pinecil/ Pinecil V2, side view]
File:Pinecil-V2-dissasebled.jpg|Pinecil V2 disassembled with new teal silicone grip, newly designed shorter 6.2 ohm tip|alt=alt language
File:Pinecil-Clear-Case1.png| Clear handle with transparent rubber finger grip|alt=alt language
File:Pinecil-Contact2.png|[https://pine64.com/product-category/pinecil/ Replacement internal contacts] |alt=alt language
File:Pinecil-bb2-01.jpg|Original Pinecil V1 and TS-B2 retail package, discontinued July 2022|alt=alt language
</gallery>

PCB:
<gallery>
File:PCP-Top-side-screen.jpg|Pinecil PCB screen side, V2 on top, V1 on bottom|alt=alt language
File:PCP-Bottom-Side.jpg|Pinecil PCB bottom side, V2 on top, V1 on bottom|alt=alt language
</gallery>

Accessories:
<gallery>
File:Pinecil-Thumb-Screws.png|V1 and V2 with Thumb screws |alt=alt language
</gallery>

== Pinecil tips ==
* Uses TS-100 (8 ohm) compatible tips and ST Short Tips (6.2 ohm)
* Every tip contains a thermocouple; when you replace the tip, you get a brand new thermocouple.
* Pinecil V2 includes a new Pine64 designed tip, ST-B2 Short tip. The discontinued V1 came with a TS-B2 tip.
* '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 How do Thermocouples work?]'''
* '''[https://github.com/Ralim/IronOS/blob/dev/Documentation/Temperature.md How is Tip Temperature measured in the firmware?]'''

==== Sold at the Pine Store ====
* Fine Tip set 1 (left) & Gross (large) set 2 (right): 
* Both sets are 8 ohm tips and are the standard length like other TS100 style tips
[[File:PinecilTipSets.jpg|800px]]

* Pine64 Short tip is only 6.2 ohm for higher performance, 86mm length
* Recommend PD65W-20V or better PSU when using short tips).
[[File:Pinecil-ST-B2.jpg| 200px]]

* Other Tips that are compatible with Pinecil
[[File:TS100-Tip-Styles.png|375px]]

'''Common resistance for tips, from top to bottom:'''

* Pine64 short tip 6.2 ohm, new
* no brand long tip 7.9 ohm, new
* Miniware long tip 8.0 ohm, new
* no brand long tip 8.3 ohm, lightly used
[[File:TipResistance2.png|200px]]

* The shorter tip is designed for higher performance but requires more power (minimum usb-C PD65W, 20V, 3+amp charger recommended).
* For example with a PD65W-20V charger, the max watt with a standard 8ohm tip is 50W, whereas the max watt with a 6.2 ohm tip is ~64 watts ([https://www.rapidtables.com/calc/electric/watt-volt-amp-calculator.html watts/volts calculator]).

== Caring for a soldering iron & guides ==

=== Guides to Soldering ===
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Working with Lead-free solder]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://kb.hakkousa.com/Knowledgebase/10297/What-are-the-different-optimal-soldering-temperatures-for-soldering-with-tinlead-solder-and-lead-free-solder Melt Points for No-Lead & Leaded Solder]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Soldering Comic book]

=== What type of Solder and Flux Should I Get? ===
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]

=== Solder Tip Maintenance ===
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]
* [https://www.eevblog.com/forum/beginners/best-way-to-clean-oxidized-soldering-iron-tip/ EEVblog, Caring for Tips]

== Cases and 3D Models ==

* [https://www.thingiverse.com/thing:4727212 Pinecil compact case]
* [https://www.thingiverse.com/thing:4723235 Pinecil and tips case]
* [https://github.com/kohkohwastaken/3D-Models/tree/main/Pine64 3D model of Pinecil by kohkoh]
* [https://www.printables.com/model/97073-pinecil-mosfet-saver-for-t12-tips T12 tip adaptor to protect internal Mosfet in Pinecil]
* [https://www.thingiverse.com/thing:4734830 T12 tip adapter for outside tip holding]
* [https://www.thingiverse.com/search?q=pinecil Thingiverse search for 'Pinecil']
* [https://www.thingiverse.com/thing:5186002 Multipart Pinecil Case by Pjotrke]

== Batch changes ==

==== V2 ====
* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accesories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing cases and tips. It comes with a teal color silicone grip versus the sky blue finger grip from Pinecil V1. It also includes one of Pine64's newly designed shorter 6.2 ohm tips. By reducing the tip resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (64W @ 20V compared to 8ohm tips which allowed a max of 50W to Pinecil). Pinecil V2 is rated for 12V-24V.

* Key changes in V2: new processor (BL706), higher maximum input voltage (24V), tentative support for USB-PD EPR (28V), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); so future IronOS firmware releases will work to expose features over BLE. This is not trivial work, but as people contribute to the opensource code of Github/IronOS, the BLE will be expanded.

* Things staying the same in V2: V2 still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, same case as V1 and compatibility with the clear/black/red cases.

* In V2 labeling, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

==== V1 ====
* For the first manufacture batch (October 2020, order number 158xxx) 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 clear 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 need it in order to ground the iron tip via the earth screw at the back of the iron.'''

* 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.

== Pinecil board information, schematics and certifications ==

* '''Pinecil V2 mainboard schematic:'''
** [https://files.pine64.org/doc/Pinecil/Pinecil_schematic_v2.0_20220608.pdf Pinecil mainboard schematic ver 2.0 20220608, this is production version schematic]
** [https://files.pine64.org/doc/Pinecil/Pinecil_PCB_placement_v2.0_20220608.pdf Pinecil mainboard ver 2.0 PCB Component Placement PDF file]

* '''Pinecil V2 Certifications:'''
** [https://files.pine64.org/doc/cert/Pinecilv2%20CE%20Certificate%20LCSA070722058E.pdf Pinecil V2 CE Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20FCC%20Certificate%20LCSA070722057E.pdf Pinecil V2 FCC Certificate]
** [https://files.pine64.org/doc/cert/Pinecilv2%20ROHS%20Report%20LCSA070722059R.pdf Pinecil V2 ROHS Report]

* '''Pinecil V1 mainboard schematic''' (V1 was sold pre- Aug 2, 2022):
** [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 V1 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]

* '''[https://pine64.com/product/pinecil-break-out-board/ 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>

== Datasheets for Components and Peripherals ==
=== Pinecil V2 ===

* MCU: Bouffalo Labs, BL-706 RISC-V + 2.4 GHz RF SoC Information:
** [https://lupyuen.github.io/articles/bl706 BL706 Analysis by Lupyuen, includes datasheet]
** [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* Sensor Information:
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
** [https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210]
* Display Module information:
** [https://files.pine64.org/doc/datasheet/pinecil/1810010328_UG-Univision-Semicon-UG-9616TSWCG02_C88335.pdf QUG 9616TSWCG02 Display Module Datasheet]
*Power Regulator:
** [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V Step-Down Buck Converter, Location U8]
* USB-C PD Controller information:
** [https://rocelec.widen.net/view/pdf/0av2cqef3a/FAIR-S-A0001311862-1.pdf?t.download=true&u=5oefqw FUSB302MPX]

=== Pinecil V1 ===
* 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]
* Sensor information:
** [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Acceleration Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Temparature Sensor Datasheet]
** [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Hall Effect Sensor (Si7210-B-00-IV by Silicon Labs), Optional add-on at U14 location]
* 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]
* 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]

== Power Supply Compatibility ==
[[Pinecil_Power_Supplies]]

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

* Pinecil can work with several power options:
** any USB-C power supply that supports PD (Power Delivery) that is same or more than minimum Volt/amps listed (PD65W-20V recommended, but PD45W will work on V1).
** 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 '''center-positive polarity'''].
** V2 can do DC barrel supply up to 24V without modyfying the PCB (check polarity, must have center-positive jack).
** QC2, QC3: not recommended because too weak, need 3 Amp or better charger, and most QC have low amps. QC2 and most QC3 power supplies are only be able to provide at most 12V 1.5amp, limiting Pinecil to about 17W of thermal capability which is weak and slow and may get "Thermal Runaway" message (weak power).

* USB-C PD type power supply / power bank that is 20V+/65W, allows the Pinecil to deliver the full 60W of heat to soldering tip.
** USB PD type power supplies with at least 20V+/65W+/3amp+ is highly recommended (higher V/W/A will work too as long as it's PD type).
** Magnetic tip USB-C cables are not recommended, and not USB compliant
* Troubleshooting QC chargers: 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.

=== Small sample of working PD/QC/Barrel power adapters / power banks: ===

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

Sometimes you have to test it, 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 or V2
* if using a DC barrel charger, check the Polarity first (must be center positive)
* use a good quality cable.
* if the Pinecil is too slow to heat up or gets Thermal Runaway message, then the psu is too weak, get something else.
* phone chargers are too weak if 12V 1.9amp or lower. QC 2.0 not supported by IronOS (only QC 3.0).
* most PC & laptop ports don't work as they are only 5V (good enough for simple Firmware update but not to provide the constant high power an Iron needs to run).
* check the specs on your laptop/PC port 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).

'''USB-C cables, PD60 Silicone:'''
* Silicone USB-C cables are recommended because 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 great with PD65W-20V chargers.
* [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ 1-cable, PINE64, silicone]
* [https://www.amazon.com/dp/B096XWD2HG/ 2-pack cables, Inter9er, silicone]
* [https://www.amazon.com/dp/B093GFBD2M 1-cable, Anker, silicone]

'''USB-C Power adapter:'''

* [https://pine64.com/product-category/pinepower/ 120W PinePower Desktop w/Grounded 3-pin plug] (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] (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 EPR charger with certified EPR Cable] (PD@28V, PD@20V) works for all USB-C devices
* [https://www.inter9ers.com/store?store-page=INTER9ERS-i9-All-In-One-Super-Cable-4ft-EPR-240W-40Gbps-USB4-p464220399 USB-C Certified EPR cable 240W/40Gbps] Coupon PINE64ONLY for $24 off backwards compatible works for all usb-C devices
* [https://www.amazon.com/gp/mpc/A1IOHY7DSV21KW?maas=maas_adg_85195
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* [https://www.amazon.com/dp/B08T1P7ZRW Ankosen 65W USB C Charger for Mac Book and Laptop Fast Wall Charger, GaN PD3.0]
* [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 with center-positive polarity:'''
{| 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 24V is supported on V2 (most V1 can 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])
* Generally any laptop charger with more than 3amps and 20-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA check polarity is '''Positive''' in the center] or you will break Pinecil).
* DC5525 barrel plug will work directly but if you have a different plug, there are many adaptors to convert it to 5.5mm, 2.5mm (don't force a bigger plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will break the barrel port]).

'''DC5525 Barrel with Tool Batteries 18V-21V:'''
* Easy way, get a 'Power Wheels' adaptor which are made for many brands and get a DC5525 Pigtail wire (can also 3D print an adaptor).
* [https://www.amazon.com/Hobbypark-Connector-Soldering-Outdoor-Repairing/dp/B08LKY5DBX DC5525 pigtail (keep the XT60 connector or cut it off)]
* [https://smile.amazon.com/gp/product/B09GXBJMNF Get a Power Wheels Adaptor like this for Ryobi, then connect a DC5525 Pigtail]
* [https://www.amazon.com/Adapter-Battery-terminals-Connector-Robotics/dp/B09GY21VXL Adapter for Ridgid batteries]

'''Limited usability:'''
* 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)
* 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:'''
* 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.

[[Category:Pinecil]]

Pinecil Power Supplies

2022-09-19T05:55:08Z

PineDude: Create new page for Power Supplies

== Power Supply Compatibility ==

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

* Pinecil can work with several power options:
** any USB-C power supply that supports PD (Power Delivery) that is same or more than minimum Volt/amps listed (PD65W-20V recommended, but PD45W will work on V1).
** 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 '''center-positive polarity'''].
** V2 can do DC barrel supply up to 24V without modyfying the PCB (check polarity, must have center-positive jack).
** QC2, QC3: not recommended because too weak, need 3 Amp or better charger, and most QC have low amps. QC2 and most QC3 power supplies are only be able to provide at most 12V 1.5amp, limiting Pinecil to about 17W of thermal capability which is weak and slow and may get "Thermal Runaway" message (weak power).

* USB-C PD type power supply / power bank that is 20V+/65W, allows the Pinecil to deliver the full 60W of heat to soldering tip.
** USB PD type power supplies with at least 20V+/65W+/3amp+ is highly recommended (higher V/W/A will work too as long as it's PD type).
** Magnetic tip USB-C cables are not recommended, and not USB compliant
* Troubleshooting QC chargers: 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.

=== Small sample of working PD/QC/Barrel power adapters / power banks: ===

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

Sometimes you have to test it, 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 or V2
* if using a DC barrel charger, check the Polarity first (must be center positive)
* use a good quality cable.
* if the Pinecil is too slow to heat up or gets Thermal Runaway message, then the psu is too weak, get something else.
* phone chargers are too weak if 12V 1.9amp or lower. QC 2.0 not supported by IronOS (only QC 3.0).
* most PC & laptop ports don't work as they are only 5V (good enough for simple Firmware update but not to provide the constant high power an Iron needs to run).
* check the specs on your laptop/PC port 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).

'''USB-C cables, PD60 Silicone:'''
* Silicone USB-C cables are recommended because 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 great with PD65W-20V chargers.
* [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ 1-cable, PINE64, silicone]
* [https://www.amazon.com/dp/B096XWD2HG/ 2-pack cables, Inter9er, silicone]
* [https://www.amazon.com/dp/B093GFBD2M 1-cable, Anker, silicone]

'''USB-C Power adapter:'''

* [https://pine64.com/product-category/pinepower/ 120W PinePower Desktop w/Grounded 3-pin plug] (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] (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 EPR charger with certified EPR Cable] (PD@28V, PD@20V) works for all USB-C devices
* [https://www.inter9ers.com/store?store-page=INTER9ERS-i9-All-In-One-Super-Cable-4ft-EPR-240W-40Gbps-USB4-p464220399 USB-C Certified EPR cable 240W/40Gbps] Coupon PINE64ONLY for $24 off backwards compatible works for all usb-C devices
* [https://www.amazon.com/gp/mpc/A1IOHY7DSV21KW?maas=maas_adg_85195
* Notebook AC Adapter HP L30757-002 (PD@20V)
* Notebook AC Adapter Lenovo ADLX65YLC3D (PD@20V)
* [https://www.amazon.com/dp/B08T1P7ZRW Ankosen 65W USB C Charger for Mac Book and Laptop Fast Wall Charger, GaN PD3.0]
* [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 with center-positive polarity:'''
{| 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 24V is supported on V2 (most V1 can 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])
* Generally any laptop charger with more than 3amps and 20-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA check polarity is '''Positive''' in the center] or you will break Pinecil).
* DC5525 barrel plug will work directly but if you have a different plug, there are many adaptors to convert it to 5.5mm, 2.5mm (don't force a bigger plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will break the barrel port]).

'''DC5525 Barrel with Tool Batteries 18V-21V:'''
* Easy way, get a 'Power Wheels' adaptor which are made for many brands and get a DC5525 Pigtail wire (can also 3D print an adaptor).
* [https://www.amazon.com/Hobbypark-Connector-Soldering-Outdoor-Repairing/dp/B08LKY5DBX DC5525 pigtail (keep the XT60 connector or cut it off)]
* [https://smile.amazon.com/gp/product/B09GXBJMNF Get a Power Wheels Adaptor like this for Ryobi, then connect a DC5525 Pigtail]
* [https://www.amazon.com/Adapter-Battery-terminals-Connector-Robotics/dp/B09GY21VXL Adapter for Ridgid batteries]

'''Limited usability:'''
* 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)
* 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:'''
* 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.

Pinecil

2022-03-15T19:31:57Z

PineDude: Sprinkle some linky-link love. Remove Amazon referral spam.

[[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. [https://pine64.com/product-category/pinecil/ 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
* GD32V Development platform
** Board schematics are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board]lets you use JTAG, GPIO, A2D, SPI, and more.

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

* A Programmable Gigadevice Risc-V GD32VF103 embedded processor
* 0.67" Monochrome Display that can render text or graphics
* Support for Idle detection, for automatic power down of tip
* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice], [https://github.com/riscv-software-src/homebrew-riscv HomeBrew] or [https://wiki.debian.org/RISC-V#Cross_compilation Linux RISC-V].

== 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. Most Android chargers since about 2015 should work.)

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 - Using a 5521 (which requires excessive force) will [https://forum.pine64.org/showthread.php?tid=13237BREAK the connector].
** 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 ==

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. It's a good idea to check for updates periodically, as development is very active and there may be new bug fixes available.

If you want to see the latest versions, visit the [https://github.com/Ralim/IronOS/releases GitHub repository for IronOS, from Ralimtek]

For update instructions, please visit the [https://github.com/Ralim/IronOS/blob/master/Documentation/Flashing.md#pinecil-pine64 update documentation on GitHub].

== 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
|}

== Batch changes ==

* For the first manufacture batch (October 2020, order number 158xxx) 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.

* 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.

== 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, M1.4 x 5).
# 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)
* 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
* [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.

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]]