PINE64 - User contributions [en]

Pinecil

2021-05-15T04:55:51Z

Ncm: Note Sabrent 60W hub failing

== Overall description ==
[[File:Pinecil-bb2-01_rotate.jpg]] 
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. It's main features are:

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

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

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

== Use ==

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

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

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

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

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

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

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

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

* Power Source
**(cutoff choices for voltage and battery operation)
* QC voltage
**(voltage to negotiate for with QC chargers (9, 12, 20 volts)
* Soldering Settings
** Boost Temperature
** Auto Start
** Temperature Change (short click)
** Temperature Change (long click)
** Allow Lock (when soldering)
* Sleep Settings
** Sleep Temperature
** Sleep Timeout
** Shutdown Time
** Motion Sensor Sensitivity
** Hall Sensor Sensitivity
* User Interface
** Temperature Units (C/F)
** Display orientation (right/left)
** Cooldown Blink
** Scroll Speed (slow/fast)
** Reverse +/- buttons
* Advanced Options
** Power Limit (watts)
** Detailed Idle Screen
** Detailed Solder Screen
** 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- 24V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, maximum rating at 24V

== Pinecil board information, schematics and certifications ==

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

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

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

== Firmware Image Releases ==

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

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

Links to development firmware and documentation:

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

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

== Batch changes ==

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

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

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Project Source
! Implementations

|-
! Ralimtek
| https://ralimtek.com
| https://www.gitmemory.com/Ralim

|-
! Alvin Wong
|
| https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs
|}

=== How to update a firmware ===

{{warning|1=While you can't brick your device permanently (DFU is in ROM); this can make your device inoperable if you flash an invalid firmware.}}

==== With application ====

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# Open it, select operating system you want to flash and click *Flash*. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.

==== Manually ====

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

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

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

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

== Disassembly steps ==

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

== Assembly steps ==

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

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 (5.5mm outer diameter, 1.5mm post) centre-positive jack, or with any USB power supply that supports the QC2, QC3 or USB-PD (Power Delivery) specification. QC2 and 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.

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)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mah QC2]

Limited usability:
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (Pinecil Firmware: 2.14.2425902)
** Pinecil switches between PD@20V/unpowered at ~ 0.5 Hz => No settings possible, but halfways works with power on setting or regulary pressing the heat up button
** Works fine when using PDC004-20V or ZY12PDN breakout on dc jack (DC@20V)
* 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)

Blacklist / 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/

== Community links ==

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

[[Category:Pinecil]]

PineCone

2021-04-14T08:19:59Z

Ncm: /* Loading code */ Correct instruction for jumper placement for loading code.

{{Note|Page under construction, information subject to change.}}
[[File:Pine64_BL602_EVB_photo-3-small.jpg|thumb|PineCone BL602 EVB (Evaluation Board)]]

== BL602 Specifications ==
* '''CPU:''' 32-bit RV32IMAFC RISC-V “SiFive E24 Core”
** [https://www.sifive.com/cores/e24 SiFive E24 Core information]
* '''Memory:'''
** 128KB ROM
** 276KB SRAM
** 1Kb eFuse
** 2MB Embedded Flash
* '''Security:'''
** Secure boot
** Secure debug
** AES 128/192/256
** SHA-1/224/256
** TRNG (True Random Number Generator)
** PKA (Public Key Accelerator)
* '''Wireless:'''
** Wi-Fi 802.11 b/g/n
** Bluetooth® Low Energy 5.0
** Wi-Fi Fast connection with BLE assistance
** Wi-Fi and BLE coexistence
** Wi-Fi Security WPS/WEP/WPA/WPA2/WPA3
** STA, SoftAP and sniffer modes
** Multi-Cloud connectivity
** 2.4 GHz RF transceiver
** Integrated RF balun, PA/LNA
* '''Package Type:'''
** 32 pin QFN 4mm x 4mm
* JTAG support (See below for BL602 impact)

[[File:BL602_Block_Diagram.jpg|600px]]

== JTAG ==
{| class="wikitable floatright"
|+ Default JTAG pins
|-
| GPIO Pin || JTAG Pin
|-
| GPIO17 || TDI
|-
| GPIO11 || TDO
|-
| GPIO12 || TMS
|-
| GPIO14 || TCK
|-
|}

BL602 multiplexes four GPIO pins to provide the familiar JTAG lines. See the accompanying table for the default pin mappings.

These are the default JTAG pins in use after a cold boot. However, many pieces of software, including the demo that's installed by default on new PineCones, remap these pins to other functions. You cannot use the default wiring for JTAG while such software is running. This issue is especially prevalent on the PineCone because three of the default JTAG pins are connected to the onboard RGB LED. Nothing about the LED itself interferes with JTAG, but any program that uses the LED will necessarily remap some of the default JTAG pins to be GPIO.

The MaskROM download mode that the BL602 enters when you tie GPIO8 high does '''not''' remap the default JTAG pins, and so you can and should use that mode while checking basic functionality of your JTAG adapter.

Note that, just as software can remap the default JTAG pins to be something else, it can also remap other pins to be JTAG. Control over this is quite granular, with 5-6 candidate pins for each individual JTAG signal that can be mapped independently of one another. LEE Lup Yuen has written some [https://lupyuen.github.io/articles/openocd#free-the-led-from-jtag-port sample code] showing how to remap the JTAG pins so that your software can use the LED without giving up support for debugging.

== Pine64 USB JTAG Adapter information and schematics ==
* [https://files.pine64.org/doc/Pinenut/PINE64%20USB%20JTAG%20Adapter%20Schematic-20201215.pdf PINE64 USB JTAG Adapter schematic 20202018 1.0]
* [[:File:PINE64_USB_JTAG_Adapter_Schematic_ver_1.0a-20210109.pdf|PINE64 USB JTAG Adapter schematic 20210109 1.0a]]

== PineCone BL602 EVB information and schematics ==
* Approximate dimensions: 26mm x 43mm
* Board layout:
[[File:PADI-II_EVB.png]]
* [https://files.pine64.org/doc/Pinenut/Pine64%20BL602%20EVB%20Schematic%20ver%201.1.pdf PineCone BL602 EVB schematic ver 1.1]
** Note: In PineCone revision 1.1 ("BL62B_EVB V1.1" silkscreened on back of board), CC1 and CC2 share one 5.1KΩ resistor. This means the board will fail to power when you use an e-marked USB-C cable like the one that comes with Apple chargers. See [https://medium.com/@leung.benson/how-to-design-a-proper-usb-c-power-sink-hint-not-the-way-raspberry-pi-4-did-it-f470d7a5910 this article] for details of why this happens. The next schematic design will give each line its own 5.1KΩ resistor as per the USB-C specification.
* The board uses a CH340 Serial/USB adapter. This chip is commonly used in Arduino-class development boards. It is a full speed (12Mbps) USB interface and has vendor ID 0x1a86 with product ID 0x7523.
* The GPIO pins (11, 12, 14, 17) plus the nearby RESET, POWER, and GND pins are all located on one side of the board, on J1 to provide JTAG connection.

== Pinenut-01S Module information and schematics ==
[[File:Pinenut-01S_PCB-Front.png|225px]][[File:Pinenut-01S_PCB-Back.png|225px]]
* [https://files.pine64.org/doc/Pinenut/Pinenut-01S%20V1.01%20SCH.pdf Pinenut-01S schematic ver 1.01]
* [https://wiki.pine64.org/images/6/6b/PineNut-01S_v1.01_KiCad.zip PineNut-01S KiCad schematic ver 1.01]
* [https://files.pine64.org/doc/Pinenut/NUT-01S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-01S GPIO Definition ver 1.0]
* [https://files.pine64.org/doc/Pinenut/USB%20Adapter%20for%20Pinenut-01S%20Schematic%20V1.0.pdf USB Programmer adapter for Pinenut-01S schematic ver 1.0]

== Pinenut-12S Module information ==
[[File:NUT-12S_module-front.jpg|200px]][[File:NUT-12S_module-back.jpg|200px]]
* [https://files.pine64.org/doc/Pinenut/NUT-12S%20GPIO%20Definition%20ver%201.0.pdf Pinenut-12S GPIO Definition ver 1.0]

== Datasheets for components and peripherals ==
* Bouffalo BL-602 SoC information:
** [https://github.com/bouffalolab/bl_docs Bouffalo Lab's official bl_docs repository]: should always contain the latest SoC documentation available, in PDF, HTML, and reStructuredText source forms.
** [https://github.com/pine64/bl602-docs/tree/main/mirrored PINE64's bl602-docs repository]: contains an archive of all historical datasheets and reference manual PDFs but may lag behind Bouffalo's official repository. If you notice that it is, please submit a pull request!
* USB/Serial adapter:
** [https://cdn.sparkfun.com/datasheets/Dev/Arduino/Other/CH340DS1.PDF CH340 serial converter]

== Misc notes ==
Planned to be available in at least three form factors:
* NUT-01S -> ESP-01S
* NUT-12S -> ESP-12S
* NUT-15 -> RTL8723/AMPAK

== Loading code ==
To load code, you must move the jumper to the position closest to the edge, press reset, load the code, move the jumper back toward the center of the board, and press reset again.

There are currently a number of loaders in progress, each with differing degrees of completeness and success on various operating systems.
* In the build tree, there is BLFlashCube for Windows, which is a proprietary GUI for flashing images. Linux and macOS binaries are available via [https://dev.bouffalolab.com/download Bouffalo Lab's developer portal].
* [https://github.com/stschake/bl60x-flash bl60x-flash] is in Python and has been reported successful on MacOS catalina (10.15.6) by Punnerud and madushan1000.
* [https://github.com/bouffalolab/BLOpenFlasher BLOpenFlasher] is a WIP, written in go, by Bouffalo Labs to provide source for a flash utility.
* [https://github.com/renzenicolai/bl602tool bl602tool] is a Python utility in development.
* [https://pypi.org/project/bflb-eflash-loader/ Bouffalo's Python Flash Loader] is a new (Dec 20) flash loader by the makers of the chip.
* <del>[https://pypi.org/project/bflb-image-build/ Bouffalo's image build] smooshes code and adds headers for downloads.</del>
* [https://pypi.org/project/bflb-mcu-tool/ Bouffalo's MCU tool] (Mar 2021) image tool replaced the above. Now combined with eflash loader, deals with partitions, DTS, signing, fuses etc.
* [https://github.com/spacemeowx2/blflash blflash serial flasher] BL602 serial flasher, inspired by BLOpenFlasher

== Development efforts ==
* [https://github.com/pine64/bl_iot_sdk PineCone BL602 GitHub Page (PINE64 fork)] has compilers, linkers, and all the code to build on Windows, Linux (x86_64), and MacOS.
* [https://github.com/bouffalolab/bl_iot_sdk Bouffalo Lab GitHub Page]
* [https://github.com/renzenicolai/bl602-docs/ BL602 Developer organize documentation GitHub Page]
* [https://github.com/renzenicolai/bl602tool BL602 Developer organize tool GitHub Page]
* [https://github.com/stschake/bl60x-flash Programming tool for Bouffalo Labs BL602/BL604 chips]
* [https://github.com/pine64/bl602-re BL602 reverse engineering working group]
* [https://github.com/pine64/bl602-sdio-linux Linux kernel module]
* [https://github.com/tchebb/bl602-docs BL602 Documentation]
* [https://github.com/spacemeowx2/blflash BL602 serial flasher]
* [https://github.com/mkroman/awesome-bouffalo#feature-matrix Awesome Bouffalo]

== Articles and Blogs ==
* [https://lupyuen.github.io/articles/pinecone Quick Peek of PineCone BL602 RISC-V Evaluation Board by Lup Yuen]
* [https://maero.dk/bl602-firmware-image-format/ Documenting the BouffaloLab BL602 firmware image format by MK]
* [https://lupyuen.github.io/articles/openocd Connect PineCone BL602 to OpenOCD by Lup Yuen]
* [https://lupyuen.github.io/articles/debug Debug Rust on PineCone BL602 with VSCode and GDB by Lup Yuen]
* [https://lupyuen.github.io/articles/mynewt Porting Mynewt to PineCone BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/flash Flashing Firmware to PineCone BL602 by Lup Yuen]
* [https://lupyuen.github.io/articles/led Control PineCone BL602 RGB LED with GPIO and PWM by Lup Yuen]
* [https://lupyuen.github.io/articles/gpio Mynewt GPIO ported to PineCone BL602 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/i2c PineCone BL602 talks to I2C Sensors by Lup Yuen]
* [https://lupyuen.github.io/articles/spi PineCone BL602 talks SPI too! by Lup Yuen]
* [https://lupyuen.github.io/articles/display PineCone BL602 Blasting Pixels to ST7789 Display with LVGL Library by Lup Yuen]
* [https://lupyuen.github.io/articles/uart PineCone BL602 Talks UART to Grove E-Ink Display by Lup Yuen]
* [https://lupyuen.github.io/articles/book The RISC-V BL602 Book by Lup Yuen]
* [https://lupyuen.github.io/articles/lora Connect PineCone BL602 to LoRa Transceiver by Lup Yuen]
* [https://lupyuen.github.io/articles/wisblock RAKwireless WisBlock talks LoRa with PineCone BL602 RISC-V Board by Lup Yuen]
* [https://lupyuen.github.io/articles/lora2 PineCone BL602 RISC-V Board Receives LoRa Packets by Lup Yuen]

[[Category:Nutcracker]]

Main Page

2021-04-14T08:08:52Z

Ncm: /* Devices */ Mention PineCone

{{TOC right}}

This is the main page of the '''official PINE64 wiki'''.

PINE64 is a community-driven company focused on creating high-quality, low-cost ARM devices and, more recently, RISC-V devices for individuals and businesses around the globe. PINE64 made its debut with the [[PINE A64|Pine A64]] single-board computer, which successfully launched on Kickstarter in 2015. PINE64 has since released a multitude of other devices, including both development boards and end-user devices. To learn more about the available devices, please see [[#Devices|the list]] of devices below.

PINE64 has a large, diverse and active community, and offers a variety of resources for hobbyists and businesses to successfully leverage various PINE64 products. To become connected and involved with the community, please see [[#Community and Support|the description]] of available chat platforms and forums below. To learn more about PINE64 as a company, please visit '''[https://www.pine64.org/ www.pine64.org]''' or '''[https://www.pine64.com/ www.pine64.com]''', which are the main PINE64 website and the PINE64 store, respectively.

= Devices =
[[File:Marchupdate-1024x594.jpg|thumb|upright=1.2|[[Pinebook Pro]] (left) and [[PinePhone]] (right)]]

You can learn more about the following ARM and RISC-V devices manufactured by PINE64:

* Phones and tablets: '''[[PinePhone]]''' and '''[[PineTab]]'''
* Laptops: '''[[Pinebook]]''', '''[[Pinebook Pro]]''' and '''[[Pinebook Pro Dock|Pinebook Pro Docking station]]'''
* Single-board computers: '''[[Quartz64]]''', '''[[ROCKPro64]]''', '''[[ROCK64]]''', '''[[PINE A64]]''', '''[[PINE A64-LTS]]''' and '''[[PINE H64]]'''
* Clusters and modules: '''[[Clusterboard]]''', '''[[SOPine]]''' and '''[[SOEdge]]'''
* Smartwatches: '''[[PineTime]]'''
* IP cameras: '''[[PineCube]]'''
* Makerspace: '''[[Pinecil]]''', '''[[PinePower]]''' and '''[[Nutcracker]]/PineCone'''

= Community and Support =
Community collaboration and support is focused around the chat platforms and forums described below. As an example of the collaborative efforts of the community, recent activity has resulted in drafting a [[PineFlash|proposal]] for a new flash-based storage device.

== Chat Platforms ==
{| class="wikitable floatright"
! Channel !! Matrix !! Telegram
|-
| PINE64 News || missing || [https://t.me/PINE64_News @PINE64_News]
|-
| PINE A64 SBC || [https://riot.im/app/#/room/#pine64:matrix.org #pine64:matrix.org] || [https://t.me/mtrx_rock64 @mtrx_pine64]
|-
| ROCK64 / ROCKPro64 || [https://riot.im/app/#/room/#rock64:matrix.org #rock64:matrix.org] || [https://t.me/mtrx_rock64 @mtrx_rock64]
|-
| Quartz64 || [https://riot.im/app/#/room/#quartz64:matrix.org #quartz64:matrix.org] || [https://t.me/joinchat/Vq50DXkH31e0_i-f Quartz64]
|-
| Quartz64 Development || missing || missing
|-
| Pinebook and Pinebook Pro || [https://riot.im/app/#/room/#pinebook:matrix.org #pinebook:matrix.org] || [https://t.me/mtx_pinebook @mtx_pinebook]
|-
| PinePhone || [https://riot.im/app/#/room/#pinephone:matrix.org #pinephone:matrix.org] || [https://t.me/pinephone @pinephone]
|-
| PineTab || [https://riot.im/app/#/room/#pinetab:pine64.org #pinetab:matrix.org] || [https://t.me/PineTab @PineTab]
|-
| PineTime || [https://riot.im/app/#/room/#pinetime:matrix.org #pinetime:matrix.org] || [https://t.me/pinetime @pinetime]
|-
| PineTime Development || [https://riot.im/app/#/room/#pinetime-dev:matrix.org #pinetime-dev:matrix.org] || [https://t.me/pinetime_dev @pinetime_dev]
|-
| Accessories || missing || missing
|-
| Pinecil || [https://riot.im/app/#/room/#pinecil:matrix.org #pinecil:matrix.org] || [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Pinecil]
|-
| Pinetalk || missing || missing
|-
| Cube || [https://riot.im/app/#/room/#cube64:matrix.org #cube64:matrix.org] || missing
|-
| Nutcracker || [https://riot.im/app/#/room/#pine64-nutcracker:matrix.org #pine64-nutcracker:matrix.org] || [https://t.me/joinchat/Kmi2S0nOsT240emHk-aO6g Nutcracker]
|-
| Off-topic || [https://riot.im/app/#/room/#offtopic64:matrix.org #offtopic64:matrix.org] || [https://t.me/pine64offtopic @pine64offtopic]
|-
|}

PINE64 has a large and very active community. Community discussion takes place on a variety of chat platforms, which are all bridged together so the messages sent via one platform are sent to all other platforms automatically. The community chat platforms are the following:

* '''Internet Relay Chat (IRC)''': server [ircs://irc.pine64.org irc.pine64.org], type <code>/list</code> to see all available channels; web interface is available on [https://www.pine64.org/web-irc/ www.pine64.org/web-irc], but only some of the channels are available
* '''Discord''': use the [https://discordapp.com/invite/DgB7kzr invite link]; all channels are available
* '''Matrix and Telegram''': see the table in this section for the list of available channels

== Forums ==
PINE64 runs an offical forum powered by open-source [https://mybb.com/ MyBB] forum server software. According to the [https://www.pine64.org/gettings-started/ general guidelines], the forum can be used to report issues, help out other users, offer findings and new information, etc. Users can also engage directly with the community and the developers of partner projects, as well as with the PINE64 members.

The official PINE64 forum can be accessed on '''[https://forum.pine64.org/ forum.pine64.org]'''.

Also, these are the official Reddit subsections, commonly referred to as subreddits:

* [https://www.reddit.com/r/PINE64official/ Official PINE64 Reddit]
* [https://www.reddit.com/r/PinePhoneOfficial/ Official PinePhone Reddit]

= Help for Beginners =
There are sections in the wiki dedicated to the very beginners who are just getting started in the world of single-board computers (SBCs) and ARM architecture. If you're just starting out and having issues with getting going, please consider browsing these sections for pointers:

* '''[[NOOB|Getting started]]''': basic information on setting up and handling PINE64 devices, such as how to write (flash) OS images to microSD cards and eMMC modules
* '''[[Project|Project ideas]]''': a variety of well-documented PINE64 projects to serve as inspiration

Pinecil

2021-04-07T04:32:35Z

Ncm: Power supply details

== Overall description ==
[[File:Pinecil-bb2-01_rotate.jpg]] 
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. It's main features are:

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

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

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

== Use ==

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

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

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

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

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

== 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- 24V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, maximum rating at 24V

== Pinecil board information, schematics and certifications ==

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

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

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

== Firmware Image Releases ==

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

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

Links to development firmware and documentation:

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

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

== Batch changes ==

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

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

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Project Source
! Implementations

|-
! Ralimtek
| https://ralimtek.com
| https://www.gitmemory.com/Ralim

|-
! Alvin Wong
|
| https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs
|}

=== How to update a firmware ===

{{warning|1=While you can't brick your device permanently (DFU is in ROM); this can make your device inoperable if you flash an invalid firmware.}}

==== With application ====

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# Open it, select operating system you want to flash and click *Flash*. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.

==== Manually ====

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

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

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

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

== Disassembly steps ==

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

== Assembly steps ==

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

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 (5.5mm outer diameter, 1.5mm post) centre-positive jack, or with any USB power supply that supports the QC2, QC3 or USB-PD (Power Delivery) specification. QC2 and 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.

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) or 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)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mah QC2]

Limited usability:
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (Pinecil Firmware: 2.14.2425902)
** Pinecil switches between PD@20V/unpowered at ~ 0.5 Hz => No settings possible, but halfways works with power on setting or regulary pressing the heat up button
** Works fine when using PDC004-20V or ZY12PDN breakout on dc jack (DC@20V)
* 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)

Blacklist / Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)

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

== Community links ==

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

[[Category:Pinecil]]

Pinecil

2021-04-07T04:11:56Z

Ncm: Add introductory usage instructions.

== Overall description ==
[[File:Pinecil-bb2-01_rotate.jpg]] 
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. It's main features are:

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

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

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

== Use ==

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

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

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

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

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

== 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- 24V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, maximum rating at 24V

== Pinecil board information, schematics and certifications ==

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

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

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

== Firmware Image Releases ==

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

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

Links to development firmware and documentation:

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

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

== Batch changes ==

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

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

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Project Source
! Implementations

|-
! Ralimtek
| https://ralimtek.com
| https://www.gitmemory.com/Ralim

|-
! Alvin Wong
|
| https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs
|}

=== How to update a firmware ===

{{warning|1=While you can't brick your device permanently (DFU is in ROM); this can make your device inoperable if you flash an invalid firmware.}}

==== With application ====

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# Open it, select operating system you want to flash and click *Flash*. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.

==== Manually ====

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

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

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

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

== Disassembly steps ==

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

== Assembly steps ==

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

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 centre positive jack, or with USB power supplies that support the QC2/QC3 or USB-PD (Power Delivery) specifications. QC2 and 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.

Known working QC/PD 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 or LN-A0403A3C (PD@20V)
* 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)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mah QC2]

Limited usability:
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (Pinecil Firmware: 2.14.2425902)
** Pinecil switches between PD@20V/unpowered at ~ 0.5 Hz => No settings possible, but halfways works with power on setting or regulary pressing the heat up button
** Works fine when using PDC004-20V or ZY12PDN breakout on dc jack (DC@20V)
* 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)

Blacklist / Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)

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

== Community links ==

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

[[Category:Pinecil]]

Pinecil

2021-04-05T07:05:31Z

Ncm: Note alternative for if dfu-util download fails

== Overall description ==
[[File:Pinecil-bb2-01_rotate.jpg]] 
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. It's main features are:

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

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

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

== 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- 24V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, maximum rating at 24V

== Pinecil board information, schematics and certifications ==

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

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

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

== Firmware Image Releases ==

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

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

Links to development firmware and documentation:

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

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

== Batch changes ==

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

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

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Project Source
! Implementations

|-
! Ralimtek
| https://ralimtek.com
| https://www.gitmemory.com/Ralim

|-
! Alvin Wong
|
| https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs
|}

=== How to update a firmware ===

{{warning|1=While you can't brick your device permanently (DFU is in ROM); this can make your device inoperable if you flash an invalid firmware.}}

==== With application ====

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# Open it, select operating system you want to flash and click *Flash*. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.

==== Manually ====

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

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

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

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

== Disassembly steps ==

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

== Assembly steps ==

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

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 centre positive jack, or with USB power supplies that support the QC2/QC3 or USB-PD (Power Delivery) specifications. QC2 and 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.

Known working QC/PD 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 or LN-A0403A3C (PD@20V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mah QC2]

Limited usability:
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (Pinecil Firmware: 2.14.2425902)
** Pinecil switches between PD@20V/unpowered at ~ 0.5 Hz => No settings possible, but halfways works with power on setting or regulary pressing the heat up button
** Works fine when using PDC004-20V or ZY12PDN breakout on dc jack (DC@20V)
* 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)

Blacklist / Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)

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

== Community links ==

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

[[Category:Pinecil]]

Pinecil

2021-04-03T20:45:42Z

Ncm: Add other Lenovo power adapter found to work

== Overall description ==
[[File:Pinecil-bb2-01_rotate.jpg]] 
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. It's main features are:

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

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

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

== 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- 24V DC5525 Barrel Jack
** USB-C 12-20V PD
** QC3.0
** Recommend operating voltage 12-21V, maximum rating at 24V

== Pinecil board information, schematics and certifications ==

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

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

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

== Firmware Image Releases ==

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

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

Links to development firmware and documentation:

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

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

== Batch changes ==

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

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

== Development efforts ==

{| class="wikitable"
!
! Project Homepage
! Project Source
! Implementations

|-
! Ralimtek
| https://ralimtek.com
| https://www.gitmemory.com/Ralim

|-
! Alvin Wong
|
| https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs
|}

=== How to update a firmware ===

{{warning|1=While you can't brick your device permanently (DFU is in ROM); this can make your device inoperable if you flash an invalid firmware.}}

==== With application ====

# Download Pinecil Firmware Updater for [http://pinecil.pine64.org/updater/get-binaries.php?platform=win64 Windows], [http://pinecil.pine64.org/updater/get-binaries.php?platform=macos64 MacOS], or build by yourself from [https://github.com/pine64/pinecil-firmware-updater sources].
# Open it, select operating system you want to flash and click *Flash*. (Don't connect Pinecil yet)
# Follow application instructions for correct Pinecil connection to your PC.

==== Manually ====

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

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

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

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

== Disassembly steps ==

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

== Assembly steps ==

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

== Power Supply Compatibility ==

The Pinecil can either work with a 12-21V battery or power supply via the 5525 centre positive jack, or with USB power supplies that support the QC2/QC3 or USB-PD (Power Delivery) specifications. QC2 and 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.

Known working QC/PD 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 or LN-A0403A3C (PD@20V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)

Power bank:
* [http://beta.blitzwolf.com/-p-15.html Blitzwolf BW-P1 10400mah QC2]

Limited usability:
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (Pinecil Firmware: 2.14.2425902)
** Pinecil switches between PD@20V/unpowered at ~ 0.5 Hz => No settings possible, but halfways works with power on setting or regulary pressing the heat up button
** Works fine when using PDC004-20V or ZY12PDN breakout on dc jack (DC@20V)
* 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)

Blacklist / Not compatible:
* Smartphone Charger RAVpower 30W Dual USB Turbo Wall Charger (Should provide QC3@9V/12V, but only provides 5 V on both ports)

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

== Community links ==

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

[[Category:Pinecil]]