View source for User:Liz 34/Pinecil

'''Pinecil''' is a portable soldering iron with computer controlled temperature, sleep modes, motion detection, and allows many options for power from AC supplies (USB-C, DC Barrel) to external tool/lipo batteries. You may already have a power supply that works. It also has the intended use of being a RISC-V development device using a [https://wiki.pine64.org/wiki/Pinecil#Pinecil_Breakout_board breakout board]. The Pinecil has evolved over the years from a 60W device into the latest rendition, [https://wiki.pine64.org/wiki/Pinecil#Batch_changes the V2], which supports 24V/88W and includes the new Pine64 designed shorter tip.

{{Info|Other irons only care if they can solder. The Pinecil is held to an additional standard; how well can it meet the needs of the open source community as a RISC-V development tool. It includes hardware features not found on other soldering irons in order to support FOSS community feature requests for both fun and science.}}

[[File:Pinecil GraphicOrange.png|500px]]

[[File:Pinecilv2-1.jpg|300px|thumb|right| Pinecil V2, launched Aug 2, 2022]]
[[File:Pinecilv2-2-transparent-background.png|300px|thumb|right| Pinecil V2, side view]]

== Pinecil Soldering Iron: main features ==
* Portability and Temperature control
* Soldering tips:
# Replaceable and low cost
# Many styles: [https://pine64.com/product-category/pinecil/ Currently sold] as 2 separate sets of 4, one fine set, the other larger.
# Compatible with other ts100 tips.
* Flexible power sources:
# USB-C PD (power delivery), minimum 3 Amps, 12V.
# DC 5525 Barrel jack charger, minimum 3 Amps, 12V.
# Battery: connect to 18V-21V Lithium-ion tool batteries or 3S/4S/5S LiPo batteries.
* Pinecil V2 has a BL706 chip, see [https://wiki.pine64.org/wiki/Pinecil#Batch_changes batch changes below].
** Board [https://wiki.pine64.org/wiki/Pinecil#Schematics,_Board_data,_and_Certifications 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.

Additional features (useful for devkit):

* 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. 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 [https://wiki.pine64.org/wiki/Pinecil#Pictures Pictures]), it has a black color handle with a 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:

{| class="wikitable"
|-style="background-color:LightYellow"|
 |  '''[https://pinecil.pine64.org/ Pinecil V2 Authenticity Checker]'''
|}

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''
* [https://pine64.com/product-category/pinecil/ Main global PINE64 store] (ships from China, exports only, Global, VAT not included).
* [https://www.amazon.com/dp/B096X6SG13/ Amazon-USA official pine64 store] (ships from USA, only Pinecil V2 - no tips)

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

'''Affiliates'''
* [https://ameridroid.com/collections/pine AmeriDroid] (offers pre-order, ships to USA/Global/Brazil)
* [https://eleshop.de/pinecil-smart-mini-tragbarer-lotkolben.html Eleshop.eu] (ships from EU, offers pre-order, 2-year warranty included per EU laws). In Netherlands, use https://www.eleshop.nl/
* [https://droneit.se/shop/?filtering=1&filter_brand=pine64 Droneit] (ships from Sweden, sells all Pine tips/accessories).
* [https://keycapsss.com/accessories/227/pinecil-v2-smart-mini-portable-soldering-iron Keycapsss] (ships from Germany to EU/AUS/Global)
* [https://testclips.co.uk/product-category/pinecil-pine64/ Testclips] (ships from GB)
* [https://typeractive.xyz/products/pinecil Typeractive.xyz] (Ships from US)
* [https://www.ursele.com/contact URS Electronics] (local in-store only sales in Portland, Oregon, USA)
* [https://bitcompact.com/products/pinecil-v2 bitcompact] (ships from Canada)

In July 2022, all final stock sold out of PINE64 Pinecil V1 (with GD32VF103 MCU) 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'). Pine does shipments in '''batches''', you get the tracking number faster or slower depending on when batch day is (up to 10 days). Pine Store is a small company.
# If you don't get the first "order 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 (some reported 2 weeks), this sometimes gets delayed in the Customs department in your home country due to backlogs (some had 7 weeks mainly because it was stuck in their country's Customs department for many weeks before being cleared to leave customs, especially during height of Covid/reduced Customs staffing). Currently members report about 2-3 weeks, as always it can be held up in the Customs department of your country if you are shipping it from outside of your country.
* 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. They are in different countries and set all of their own procedures, shipping costs and options. Get all reseller shipping details for each store from their specific websites/chat tools/email.

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

* If you see the message "outbound imports cancelled," just wait. We think it is 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"
| Wipe new tips with isopropyl alcohol IPA to remove factory residue before installing. If you have none, try to wipe it down with a dry clean towel, especially the 2 contacts at the cold end (water is not recommended as it can get into the seam on the white end).
|-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]).
## Always unplug before swapping tips if you have multiple tips.
# '''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.
## Calibration of the Tip temperature is usually not necessary and should only be done if the tip is off by +/- 5 °C or temperature is behaving oddly. See instructions to [https://ralim.github.io/IronOS/Menu/#calibrate-tip-cjc calibrate the tip in the firmware on Github IronOS.]
## '''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 with the Menu ===
* '''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''': also available [https://ralim.github.io/IronOS/DebugMenu/ , see Github/IronOS]

=== Community Advanced Modifications ===
* [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md Optional Hall Effect Sensor; how it works in the Firmware IronOS]
* [https://forum.pine64.org/showthread.php?tid=16989 Installing LED lights]
* Add an LED pcb light ring to Pinecil: [https://github.com/Herushan/Pinecil_LED_Ring/blob/main/Pinecil_LED_Ring_writeup.pdf Github LED Light]

== Community Chat links ==
* PINE64 open source community live chat with many channels specific to different Pine items.
* Need troubleshooting advice on a PINE64 pinecil?
* '''Join one of the Community Chat links below'''
Pine64 live chat is hosted on Discord and is bridged to Telegram/Matrix/IRC. Those bridges will not have all the features available within Discord Pine64, but the chat is relayed between all three.

Note that live chat has volunteer members and are not paid Pine64 employees.

* <code> '''[https://discordapp.com/invite/DgB7kzr Discord]''' </code>

* <code> '''[https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]''' </code>

* <code> '''[https://matrix.to/#/#pinecil:matrix.org Matrix]''' </code>

== Firmware ==

The 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 version

=== Update Pinecil V2 ===

The V1 and V2 use different Flasher software & firmware files because they have different MCU and features.
However both connect to the PC/laptop and enter the Flash mode in the same way, by holding down the (-) button:
# Long hold the <code>'''[-]'''</code> button **before** plugging the usb-c cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means you are in Flashing Mode. If you have issues, try again, do not plug the usb-C cable into Pinecil until you first press & hold the [-] button. Flip the cable over or try another port if you still have issues.
# Pinecil is designed to use only 1 port at a time. Only the USB-C cable should be plugged in during Updates. Never attempt to use both rear ports at the same time or your PC and Pinecil will be damaged.
# Use the different flashers below to write new firmware to your Pinecil ([https://wiki.pine64.org/wiki/Pinecil#How_to_Update_Pinecil_V1 older V1 instructions are lower down here]).

'''V2 Windows'''
# For V2, download the CLI [https://wiki.pine64.org/wiki/File:Blisp_Windows64.zip Windows Blisp Flasher here.]
# Extract the blisp zip. Run '''windows powershell''' as administrator, cd to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/tag/v2.20 stable Pinecilv2.zip Releases here]. Scoll down to the Assets to get the zip files (works for EPR 140W chargers).
# Grab and Put Pinecilv2_EN.bin (English) file or language chosen into the blisp folder (same place as the blisp executable).
#* If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate 2-letter code for your language.
# Connect the V2 to the PC ([https://wiki.pine64.org/wiki/Pinecil#Connect_Pinecil_V2/V1_to_PC see Connecting above]). If you are curious, it will connect as a Serial COM device in device manager.
# cd to the blisp folder, and Execute this line. (replace the EN file with any language bin filename you choose).
# <code> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin </code>
# Hold down <code>'''[-]'''</code> for 3 seconds to see the version.
{{info| To test the new beta BLE bluetooth website, [https://github.com/joric/IronOS/releases/latest/download/Pinecilv2_EN.bin get BLE firmware here] (also works with EPR 140w chargers). [https://www.reddit.com/r/PINE64official/comments/z5ix9a/bluetooth_ble_testing_pinecil_v2/ Instructions here]}}
[https://wiki.pine64.org/wiki/Pinecil#Troubleshooting_V2_Flashing See Troubleshooting down below if it does not flash]

'''V2 Linux'''
# For V2, download the CLI [https://wiki.pine64.org/wiki/File:Blisp_Linux_x86.tar.gz Linux Blisp Flasher here (x86)].
# Extract the Blisp and cd to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/tag/v2.20 stable Pinecilv2.zip Releases here]. Scoll down to the Assets to get the zip files (works for EPR 140W chargers).
# Grab and Put Pinecilv2_EN.bin (English) file or language chosen into the blisp folder (same place as the blisp executable).
#* If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate 2-letter code for your language.
# Connect the V2 to the PC ([https://wiki.pine64.org/wiki/Pinecil#Connect_Pinecil_V2/V1_to_PC see Connecting above]). It will connect as a serial '''ttyACM''' USB ACM type device.
# <code> cd </code> to the blisp folder and execute:
# <code> sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin </code>
# Hold down <code>'''[-]'''</code> for 3 seconds to see the version.
{{info| To test the new beta BLE bluetooth website, [https://github.com/joric/IronOS/releases/latest/download/Pinecilv2_EN.bin get BLE firmware here] (also works with EPR 140w chargers). [https://www.reddit.com/r/PINE64official/comments/z5ix9a/bluetooth_ble_testing_pinecil_v2/ Instructions here]}}
[https://wiki.pine64.org/wiki/Pinecil#Troubleshooting_V2_Flashing See Troubleshooting down below if it does not flash]

==== Troubleshooting V2 Flashing ====
# Often times, issues are related to the USB cable, try flipping the cable over, or try other ports on the PC. Don't use a hub, connect directly to a port, ports on the back of a PC may be better as they are directly connected to the motherboard. USB-C to C cables sometimes works better than USB-A to C cables (your cable may be power-only and not able to do firmware data transfers). Try using a USB-C to C cable on a C port and not a USB-A to C cable.
# Try holding down the <code>[-]</code> the whole time (don't release) - if you had to do this, let Gamiee know in the Github Blisp [https://github.com/pine64/blisp/issues Issues ticket here].
# Blisp flashers are from [https://github.com/pine64/blisp Gamiee's open source Blisp code here]. It is only an updater for the BL706 MCU on Pinecil V2 (means it "writes" to the V2 chip). It is separate from the firmware files needed which are in located in Github Ralim's IronOS.
# If there is a problem with the flasher, or you have a different Linux architecture like ARM, you could also build it from code, see directions at Github Blisp.
# If you have issues completing the update, join the [https://wiki.pine64.org/wiki/Pinecil#Community_Chat_links Live Community Chat for Pine64 Pinecil].
# If the blisp flasher is not working, open a ticket here: <https://github.com/pine64/blisp/issues>
# If you are running Windows VM emulator, & it fails, make sure you have MS "Visual C++ 2015-2022" installed.
# All firmware releases and betas are located in the [https://github.com/Ralim/IronOS Github Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS that runs the Pinecil or have issue with it, please look at the Github link or submit an issue ticket. It is recommended to read through all the Github IronOS documents first as they may have the answers. The screen menus and troubleshooting is documented as well.

=== Update Pinecil V1 ===

''' Connecting a V1 or a V2''' to a laptop or PC for Flashing/Updating is the same method, but the Flasher used is different because they have a different MCU and capabilities.
# Long hold the [-] button **before** plugging the usb-c cable in. Keep holding down the [-] for ~15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means you are in Flashing Mode. If you have issues, try again, do not plug the usb-C cable into Pinecil until you first press & hold the [-] button. Flip the cable over or try another port if you have issues.
# Pinecil is designed to use only 1 port at a time. Only the USB-C cable should be plugged in during Updates. Never attempt to use both rear ports at the same time or your PC and/or Pinecil could be damaged.
# See the version installed by holding down [-] for 3 seconds.

* '''V1 Windowsor Mac'''
# For V1, follow these instructions on Github and download the [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ '''Pine64 Easy Gui Updater''']

* '''V1 Linux'''
# For V1, download [https://github.com/Laar3/PineFlash Pineflash GUI for Linux or Mac]
# Or could use a command line DFU per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]

=== General Firmware Details ===
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from Github with 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.

* Problems with IronOS firmware? - read documents here. If the answer is not found, open ticket here: <https://github.com/Ralim/IronOS/issues>

* See [https://wiki.pine64.org/wiki/Pinecil#Community_links Pine64 Community Chat Links] or [https://github.com/Ralim/IronOS/issues Github IronOS Issues] if you run into issues updating. There are knowledgeable volunteers in that the live chat.

== Development Projects ==

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

|-
| Ben Brown (ralimtek) || [https://ralim.github.io/IronOS/ Ralim's IronOS] || Official Pinecil firmware
|-
| Marek Kraus (gamiee) || [https://github.com/pine64/blisp Pinecil V2 Flasher] || Windows & Linux CLI Updater for BL70x
|-
| Marek Kraus (gamiee) || [https://github.com/pine64/pine64_updater Pinecil V1 Flasher] || Windows & Mac GUI Updater
|-
| Arkaitz Goni Hedger (spagett) || [https://github.com/Laar3/PineFlash PineFlash V1 Flasher] || Linux & Mac GUI Updater
|-
| Joric (iamjoric)
| [https://joric.github.io/pinecil/ BLE API for V2]
| Install [https://github.com/joric/pinecil/wiki Pinecilv2 BLE IronOS first]
|-
| Bouffalo Lab || [https://dev.bouffalolab.com/download B-Lab Dev Cube ] || Vendor generic GUI for Dev/flashing BL706
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs gd32vf103-pinecil-demo-rs]
| Rust code demos for Pinecil
|}

== Checklist ==
{| class="wikitable"
|-style="background-color:LightYellow"
| 1. Clean new tips with isopropyl alcohol to remove factory residue before installing (avoid strange behavior from poor contact). If you have none, try to wipe it down with dry clean towel especially the 2 contacts at the back (do not use water, it could get into the small white seam line).
|-style="background-color:LightYellow"
| 2. Don't bend the tiny internal contacts, they are thin spring metal and may break.
|-style="background-color:LightYellow"
| 3. Only use one port, USB-C or the DC barrel, but Never both at the same time. Damage will occur to PC/ Laptop/ Pinecil !
|}

Upon receipt, or buying a used Pinecil, one may want to check the following:
# The display turns on when 5-21V is supplied (V2 models can do 24V).
#* 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 needs 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 & use Beta 2.20 firmware until stable is released.
#** 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.

== Power Supplies and Watts ==
'''Generally, higher watts = better, up to how much you can afford.'''
{| 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:left; "
|-style="background-color:Honeydew"
| * PINE64 officially states V2 up to 24V-88W. Tentatively, V2 supports 28V-140W EPR/PD3.1 chargers with certified EPR 240W usb-C cables.
|}

* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] supports EPR 28V-140W on Pinecil V2 models.
* EPR Usb-C is new to the market in 2022; they are expensive and require EPR PD 3.1, 240W cables.
* EPR is backwards compatible for all USB-C devices. EPR chargers/cables can be used for everything else Usb-C as well.
* Ralimtek: ''"Please understand wattages [detailed screen] are wild estimates and are at best +-10%. Use external metering for any comparisons."'' Pinecil is not a USB-C tester, the watts shown on detailed screen mode is a big picture number for convenience of debugging various chargers used. It is not going to be as accurate as an external tester. External testers also cause a small reduction in watts.

{| class="wikitable"
|-style="background-color:LightYellow"
| '''Quick Charge or QC3''' 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'''] or ['''Undervoltage'''] messages because of weak power (QC2 does not work at all as it is not supported in the firmware).
|}

{| 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/Screws ===
* Originals screws 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 m2x 3mm.

[[File:Pinecil-Thumb-Screws-02.png|200px|thumb|right| Thumb Screws]]
* '''Thumbs screws''' are popular upgrades: an '''M2 x 4mm''' thumb screw could replace '''both''' the screen-side Tip holder screw and the rear end ground screw.
* It was found that an M2x3mm thumb screw for the tip is a hair too short, and just grazes the Tip and the longer '''m2 x 4mm is better on top'''.

# [https://www.aliexpress.com/item/3256803069568247.html Stainless Steel, smaller thumb screw, get M2x4mm]
# [https://www.aliexpress.us/item/3256804077282767.html Black, smaller thumb screw get M2x4mm]
# Wider head [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]
# Bling! [https://www.aliexpress.com/item/3256802759810600.html Gold hex screws]
# Many Assorted [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm M2x4mm screw Options]
{{Info| If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used lightly to shorten it a small amount. Stainless steel is recommended as the softer aluminum screws could mushroom as you tighten down the tip screw too much or over time.}}


* If you just want to swap out the stock phillips screws for Hex key/Allen screws get two - m2x4mm & one- 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]

== 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 ==
{{Hint| Tips are rated by manufacturers to '''400 °C maximum'''. Boosting is unlocked on Ralim's IronOS firmware to 450 °C - '''use at your own risk!''' Running or boosting to higher than 400 °C could permanently damage/break the tip. Overclocking tips will prematurely damage them, your luck may vary.}}

==== What kinds of Tips work? ====
# Pinecil V2 uses '''both''' Pine64 designed Short Tips (ST line, 6.2-6.5 Ω, white box) and TS-100 Normal length compatible tips (TS line, ~8.0 Ω).
# '''Unplug before swapping''' tips as the V2  automatically detects the tip resistance at boot-up and it is safer.
# Typically, lead solder uses a working temperature of ~300°C-320°C and no-lead solder ~350°C-365°C (check the temperature charts in [https://wiki.pine64.org/wiki/Pinecil#What_Temperature_should_I_use? the Guide below] or google it for your specific solder type, it varies).
# Always start lower than needed and increase ~5°C at a time until you reach a good working temperature. If you want your tips to last longer, use the lowest temperatures you can comfortably work at. Tihcker wires, etc., may need more (adjust).
# The open source firmware allows you to use temperatures past the manufacturer limit, but that doesn't mean you should. That said, people have reported using the boost feature at 5-15 second burst to >430°C and have been perfectly fine (TS100 and Pine64 tips are readily available at reasonable prices and some people prefer convenience of higher temperatures and accept they might replace tips more frequently if used at higher temperatures). Your luck may vary (Tip premature failure possible when frequently used at excessive high temperatures).
# Tips are not too expensive, some just keep spare tips around and boost freely when they want, and replace the tip when it loses it's plating or the tip fails (common sign of tip failure is tip plating is gone or the multimeter measures OL infinite ohms across the 2 silver contacts on the tip).
# Check out this [https://wiki.pine64.org/wiki/Pinecil#Guides_for_Soldering_&_Maintenance Soldering Guide link] for more details on best practices for use and maintenance of tips.

==== How does the Tip Work? ====
# Every tip contains a thermocouple; advantage is every new tip includes a brand new thermocouple.
# Pinecil tips are considered [https://www.youtube.com/watch?v=kmq769_ed9w newer tech style]. This is more accurate compared to older style Irons where the thermocouple is in the handle and much farther from the end of the tip.
# '''[https://www.youtube.com/watch?v=v7NUi88Lxi8 Science: in general, how do thermocouples work?]'''
# '''[https://ralim.github.io/IronOS/Temperature/ How is Tip Temperature measured in Ralim's IronOS firmware?]'''
# '''[http://www.minidso.com/forum.php?mod=viewthread&tid=1110 What does the inside of a ts100 tip look like?]'''

=== Pine Store has Short & Normal length Tips ===
{| class="wikitable"
|-style="background-color:LightYellow"|
| '''Pay attention to the length!''' Pine Store sells two different lengths.
|}
=== I. Short Tips ===
# All Pinecil V2 packages include a single Pine64 newly designed Short tip (ST-B2 conical).
# The discontinued V1 came with a longer normal length TS-B2 conical tip.
# Pine Store carries 4-Packs of Pine64 designed Short Tips (only Pine64 makes these presently)
<code>Short tips [https://pine64.com/product/pinecil-soldering-short-tip-set-fine/ Fine link, white box] (~6.2-6.5 Ω)</code>

<code>Short tips [https://pine64.com/product/pinecil-soldering-short-tip-set-gross/ Gross link, white box] (~6.2-6.5 Ω)</code>

4. See down below for [https://wiki.pine64.org/wiki/Pinecil#Normal_Tips,_black_box Normal length], TS100 style tips (~8.0 Ω)

5. Pine64 Short tip packs are lower resistance/ohms which means higher performance and better ergonomics. Many professional irons have shorter tips for more control while soldering.

{{Info| Older pinecil V1 can not use the short tips until firmware code is written to enable manual selection of 6.2 Ω or 8.0 Ω tip.
'''Only V2 model''' has the hardware to auto-detect the two kinds of tips short 6.2 Ω or regular length 8.0 Ω . If you would like to volunteer, see [https://github.com/Ralim/IronOS Github/IronOS] }}

[[File:Pinecil-Short-Tip-SetGross-1.jpeg| none |300px |thumb| [https://pine64.com/product/pinecil-soldering-short-tip-set-gross/ Short Gross set, white box]: ST-I, ST-C4, ST-D24, ST-K]]
[[File:Pinecil-Short-Tip-SetFine-1.jpeg| none | 300px |thumb| [https://pine64.com/product/pinecil-soldering-short-tip-set-fine/ Short Fine set, white box]: ST-BC2, ST-C1, ST-ILS, ST-Ku]]

[[File:Pinecil-ST-B2.jpg|250px|thumb|right| ST-B2 conical short tip included with the V2 Pinecil]]
* The shorter tip is designed for higher performance and requires more power than longer traditional TS100 tips
* Recommend using minimum of usb-C PD65W-3.25A-20V or higher voltage charger when using Short tips (short tip draws more power than longer tips because of the lower ohms).
* For example with a PD65W-20V charger, the maximum watts with a standard 8 ohm 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]).
* Heating formula: P = IV = I^2 * R = V^2 / R (⇧ watts = ⇧ faster heating)
<code>20V @8Ω tip=50W; @6.2Ω tip=64.5W</code>

<code>24V @8Ω tip=72W; @6.2Ω tip=92.9W</code>

===II. Normal Tips ===
{| class="wikitable"
|-style="background-color:LightYellow"|
| '''Pay attention to the length!''' Pine Store sells two different lengths.
|}
* Normal Length [https://pine64.com/product/pinecil-soldering-tip-set-gross/ Gross Set here] (~8.0 Ω)
* Normal Length [https://pine64.com/product/pinecil-soldering-tip-set-fine/ Fine Set here] (~8.0 Ω)

[[File:Regular Tips Gross 8ohms.jpeg|none|150px|thumb| Normal ts100 length tips (~7.8-8.3 Ω)]]
[[File:PinecilTipSets.jpg|none|500px|thumb| Regular Length TS Tips: Left= Fine set, Right = Gross set. Both TS sets have ~8.0 ohm tips and are the standard length similar to other TS100 style tips.]]

{{Note| Currently, Pinecil V1 original uses the normal length ts100 style tips and not the newer Short tips designed for V2. Ralim is working on adding a feature to the firmware to allow people with the older V1 Pinecil to manually switch a profile setting which allows toggling between Normal Tip and Short tip profiles (adequate power supply must also be used min. PD65w 3.25A, 20V recommended). Check Github Ralim's IronOS for progress information. Always unplug when swapping tips.}}

'''Other Compatible normal length tip models'''
[[File:TS100-Tip-Styles.png|300px|thumb|none| Compatible TS100 Tips, ~8.0 Ω]]


'''Common resistance for tips:'''
[[File:TipResistance2.png|left| 200px]]
* Pine64 short tip 6.2 Ω, new. Pine64 shorter length, only available at pine64.com.
* no brand long tip 7.9 Ω, new, standard length ts100 style
* Miniware long tip 8.0 Ω, new, standard length ts100 style
* no brand long tip 8.3 Ω, lightly used, standard length ts100 style


== Guides for Soldering & Maintenance ==
=== Guides to Soldering ===
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever Cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [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]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]

=== How do I keep the Tip Clean? ===
* [https://www.youtube.com/watch?v=nhwEghcG5HE Clean & Care for Tips]
* [https://www.youtube.com/watch?v=JADI1N-K9Yc How to Clean Soldering Tips]
* [https://www.youtube.com/watch?v=gq-q64ncivM Sodering Tip Maintenance]

=== What Temperature should I use? ===
1. General Formula: <code>add 120°C to the melting point</code> listed on the solder label, and adjust up/down as needed for different tasks.
* Example: the solder says 220°C melt point, then <code>220 + 120 = 340 °C</code>
* One could also try these common working temperatures below, start lower and increment by 5 °C until you get a comfortable working temperature (thicker wires & situations dictate more or less). 
<code> Common Working Temperatures </code>

<code>* For Lead solder: 300°C - 320°C </code>

<code>* For No-lead solder: 350°C - 365°C </code>

2. If there is no listed melting point, refer to google or a chart like below for your specific type of solder alloy:
*[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]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help. See the soldering guides for demontrations of this.

== Cases, Holder/Stands, 3D Models, Supplies ==

=== Cases/Bags ===

* [https://a.co/d/hjFRpzK EVA Shockproof Case]
* [https://www.aliexpress.com/item/1005002553816919.html Zippered Case]
* [https://a.co/d/i6QoxKl Aluminum hard case w/foam] (check size before ordering if multiple listed).
* [https://a.co/d/gAYy8fG Aluminum poker case w/foam]
* Soft Bag [https://a.co/d/48PjOwZ Molle IFAK/EDC]: look for bags that can fully open like a sandwich when unzipped which allows tools to be easily seen and retrieved. Bags that only partially unzip make it harder to find tools without dumping out the whole bag.

=== Holder/Stands ===
* [https://a.co/ex0JeQw Noah Metal Stand with Brass wool]
* [https://a.co/bR0Xfpr YiHua X-4 Stand with Tip Holder, Brass Wool & hard rosin inside for tip cleaning]
* [https://a.co/iZ2KAF1 Yihua X-2 Stand on Amazon]
* [https://www.aliexpress.us/item/3256801095630464.html?gatewayAdapt=glo2usa4itemAdapt&_randl_shipto=US Yihua X-2 Stand on Aliexpress], and [https://www.aliexpress.us/item/3256803804222600.html?mp=1&gatewayAdapt=glo2usa&_randl_shipto=US alternate X-2 Stand] 
* [https://www.hakko.com/english/products/hakko_kote_board.html#fh300-81 Hakko FH300-81]
* Pine Store [https://pine64.com/product/pinecil-portable-mini-stand/ Portable Mini Stand]

=== 3D Print ===
* [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]

=== Supplies ===
* Brass Wool with hard rosin in the bottom for tip cleaning: [https://www.aliexpress.us/item/2251832826887062.html '''Brass w/Rosin''']
* Tip Refresher/tinner for when the tip is very dirty: Mechanic brand [https://www.aliexpress.us/item/2251832764094798.html '''MCN-20 lead-solder version'''], and [https://www.aliexpress.us/item/2251832803171199.html Lead-free version].
* Budget Tweezers Set: [https://a.co/d/cLELK10 '''Tweezers ESD with case''']
* Weller no-lead solder, 3-pack variety sizes for portable kits & sampling 3 common useful sizes: [https://a.co/d/ilor7wI '''Lead-Free 3-pack'''] (0.3/0.5/0.8mm).
* Syringe Flux: Amtech [https://amtechdirect.com/collections/tf-v3 '''NC-559-V3 from amtechdirect'''] (comes in paste or convenient syringe). Be careful, there is a lot of fake Amtech online. Amtech is made in the USA, avoid any flux from Aliexpress, many reports of flux that simply does not work and appears to be fake from Aliexpress.
* Solder Wick for removing solder: [https://a.co/d/g01udsS '''Solder Wick''', variety pack] (add a lot of flux to the area & solder wick works better).

== 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 green color silicone grip versus the light 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-PD3.1 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 or black handles.

* 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 only sold until July 2022, and then discontinued for newer V2 model.
* [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]

=== Pinecil Breakout board ===
Get Pinecil [https://pine64.com/product/pinecil-break-out-board/ Breakout Board here]

* [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 One place to buy it]. Also sold on Digikey and Mouser.

* 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-1AXN5G,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://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
** [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
** [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]

* USB-C port, possible part, has not been verified. [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html  Replacement here: '''USB C Port''']

=== 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 (U8)]
** [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33, Ultra-low noise LDO Regulator (U5)]
*** [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement LP 3986-33]

* 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 (U11)]
* Capacitors
** [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]

* [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LowPowerSemi LP6498B6F 1.2A Switching Power Regulator Datasheet - on breakout board]

* USB-C port, possible part, has not been verified. [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html  Replacement here: '''USB C Port''']

== Pinecil in the Media ==
=== Humor ===
* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Pinecil Humor]

=== Video Reviews ===
*[https://www.youtube.com/watch?v=YeKv0fwshFQ V2 review, Platima Tinkers]
*[https://youtu.be/k-wo_al9QJU?t=61 V1 review, Adrian's Basement]
*[https://www.youtube.com/watch?v=eme_AUayLp8 V1 review, Adam Welch]

'''V2 Reviews'''
* [https://hackaday.com/2023/01/31/all-about-usb-c-pinecil-soldering-iron How Pinecil Integrates newest USB-C protocols]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]
*[https://www.cnx-software.com/2022/07/29/pinecil-v2-soldering-iron-gets-bl706-bluetooth-le-risc-v-mcu-usb-pd-epr-support/ CNX Software Review]

'''V1 Reviews'''
*[https://hackspace.raspberrypi.com/articles/pinecil-soldering-iron-review Hackspace Review]
*[https://hackaday.com/2021/01/05/review-pine64-pinecil-soldering-iron/ Hackaday Review]

[[Category:Pinecil]]