PINE64 - User contributions [en]

Pinecil Guides to Soldering

2023-06-21T19:46:22Z

River: /* What temperature should I use? */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]

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

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

Common ranges if the solder label/model melting temperature can not be found:
# Lead solder: range 300°C - 325°C
# No-lead solder: range 350°C - 370°C
{{Info| generaly higher temperatures are needed for no-lead alloys which is why it's a little harder to work with and the higher temperatures wear out tips sooner. This is a trade off to using a safer product. All ROHS certified printed circuit boards (PCB) made since about 2006 use No-Lead solder.}}

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:45:20Z

River: /* What temperature should I use? */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]

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

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

Common ranges if the solder label/model melting temperature can not be found:
# Lead solder: range 300°C - 325°C
# No-lead solder: range 350°C - 370°C
{{Info| generaly higher temperatures are needed for no-lead alloys which is why it's a little harder to work with and the higher temperatures wear out tips sooner. This is a trade off to using a safer product. All ROHS certified printed circuit boards (PCB) made since about 2006 use No-Lead solder.}}

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:43:38Z

River: /* What temperature should I use? */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]

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

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

Common working temperatures if direct data for the solder can not be found:
# Lead solder: range 300°C - 325°C
# No-lead solder: range 350°C - 370°C
{{Info| generaly higher temperatures are needed for no-lead alloys which is why it's a little harder to work with and the higher temperatures wear out tips sooner. This is a trade off to using a safer product. All ROHS certified printed circuit boards (PCB) made since about 2006 use No-Lead solder.}}

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:36:11Z

River: /* What temperature should I use? */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]

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

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

Common working temperatures if direct data for the solder can not be found:
# For Lead solder: range 300°C - 325°C
# For No-lead solder: range 350°C - 370°C

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:34:35Z

River: /* Does solder type and flux matter? */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]

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

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

Common working temperatures if direct data for the solder can not be found:
# For Lead solder: 300°C - 320°C
# For No-lead solder: 350°C - 365°C

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:34:05Z

River: /* General soldering guides */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]

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

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

Common working temperatures if direct data for the solder can not be found:
# For Lead solder: 300°C - 320°C
# For No-lead solder: 350°C - 365°C

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil Guides to Soldering

2023-06-21T19:32:25Z

River: /* General soldering guides */

This article is a list of convenient links to guides on soldering. Although it's not directly related to [[Pinecil]] hardware, many PINE64 members ask for this kind of information in daily live chat. If you don't find something here, then try an Internet search as this is just a starting point for convenience.

== General soldering guides ==
* [https://www.youtube.com/watch?v=DCoY8Ax70rU Why have different tips?]
* [https://www.youtube.com/watch?v=YUryJOAiPa4 Easier method to solder SMD, and a clever pcb cleaning method]
* [https://www.youtube.com/watch?v=EW9Y8rDm4kE How to Solder SMD & Small Components - Mr. Solder]
* [https://www.youtube.com/playlist?list=PL926EC0F1F93C1837 Pace Basic Soldering lesson 1-9]
* [https://youtu.be/dpkPyS5aOA0 How to Desolder/Correct mistakes]
* [https://www.youtube.com/watch?v=D-un9-ZsSQI Mr. Solderfix - Remove Components]
* [https://www.techspray.com/ultimate-guide-to-electronic-soldering Ultimate soldering guide]
* [https://www.reichelt.com/magazin/en/guide/switch-to-lead-free-solders-when-soldering-by-hand/ Should I switch to Lead-free solder?]
* [https://www.youtube.com/watch?v=T8mVvI8YnCc Beginner's Guide to Soldering - Mr. Solder]
* [https://www.youtube.com/watch?v=6PB0u8irn-4 Fine SMD Soldering]
* [https://mightyohm.com/files/soldercomic/FullSolderComic_EN.pdf Comic book - Soldering]

== Does solder type and flux matter? ==
* [https://www.youtube.com/watch?v=5Ku7I3hA3AA%7C Does Solder quality matter?]
* [https://www.youtube.com/watch?v=tfIwHuGzUEk When to use Flux]
* [https://en.wikibooks.org/wiki/Practical_Electronics/Soldering#63/37 63/37 or 60/40 Solder?]

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

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

Common working temperatures if direct data for the solder can not be found:
# For Lead solder: 300°C - 320°C
# For No-lead solder: 350°C - 365°C

2. Another method is an Internet search to find a chart like below for your specific type of solder alloy:
* [https://www.kester.com/Portals/0/Documents/Knowledge%20Base/Alloy%20Temperature%20Chart.pdf Alloy Temperature Chart - Kester]

3. Adding a small amount of solder to your tip before starting increases the thermal mass of the tip and could help instead of cranking the temperature super high (which causes other problems). See the [[#General_soldering_guides|soldering guides]] above for demonstrations of this in several articles and videos.

== Using the Conical tip ==

'''How do I use the conical tip that comes default with Pinecil to get enough heat transfer?'''

1. Use the '''side''' of the tip to heat the pin. Do not hold it vertically like a pen because the very end of the tip has little heat mass. See

https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_1edit.png

2. Correct amount of solder and solder flow. See https://cdn.sparkfun.com/assets/learn_tutorials/5/8/4/SolderingAdvice_2.png

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:30:03Z

River: /* Poor Contact Fix */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X) come and go for a second. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too. Make sure you are using the correct rated charger for Pinecil (some cheap, universal or no-brand DC bricks can damage electronics from spiking voltages).
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers and suggested types is in the article [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue or oils on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:29:08Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X) come and go for a second. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too. Make sure you are using the correct rated charger for Pinecil (some cheap, universal or no-brand DC bricks can damage electronics from spiking voltages).
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers and suggested types is in the article [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:28:15Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X) come and go for a second. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too. Make sure you are using the correct rated charger for Pinecil (some cheap, universal or no-brand DC bricks can damage electronics from spiking voltages).
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:26:50Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X) come and go for a second. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:26:17Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X). See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:25:57Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''Screen shows the symbol (X) randomly on new Pinecil''': tip is installed and it heats up and works fine, but randomly I see the no tip symbol (X). See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.

# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:18:48Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': some laptop ports are not compatible to do updates and show pinecil screen rebooting, change to a different ports on the laptop or different machine (e.g., sometimes the USB-A port works where the usb-C did not). If it is rebooting connected to a power charger, change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-21T19:15:19Z

River: /* FAQ */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, clean the metal contacts on the rear of the cartridge/tip (even if it looks clean, could have residue/oils). Follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil

2023-06-18T22:39:16Z

River: /* Power Notes */

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

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

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

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

== Main features ==

* Portability and Temperature control
* Soldering tips:
# Replaceable and low cost
# Many styles: [https://pine64.com/product-category/pinecil/ currently sold] as 4-packs, one fine set, the other larger.
# Compatible with other ts100 tips.
* Multiple power sources will work for more flexibility:
# USB-C PD (power delivery), minimum 3 Amps, 12V.
# DC 5525 Barrel jack charger, minimum 3 Amps, 12V.
# Battery: connect to 18V-21V Lithium-ion tool batteries or 3S/4S/5S LiPo batteries.
* Pinecil V2 has a BL706 chip, see [[#History_of_Pinecil_Changes|history of changes below]].
** Board [[#Schematics,_Board_Data,_Certifications|schematics]] are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board] lets you use JTAG, GPIO, A2D, SPI, and more.

Additional features (useful for devkit):

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

== Authenticity ==

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

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

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number. This allows people to check if the Pinecil V2 is Authentic.
To be more sure, update to the newest stable Ralim's IronOS and check again, see [[#Firmware_&_Updates| Firmware & Updates]].

{{Note|[https://pinecil.pine64.org/ Authenticity Checker here.]}}

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''

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

'''PINE64 EU'''

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

'''Affiliates'''

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

'''Why buy from a legitimate seller?'''

The PINE64 Mission is to get hardware into the hands of open source developers and tinkerers. Buying authentic Pinecils supports that mission (see [https://www.pine64.org/2019/08/19/its-time-to-start-giving-back/ this article]).

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

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

== Shipping & Tracking ==

See the [[Pinecil_Shipping_and_Tracking| Shipping and Tracking]] article, which includes:

# [[Pinecil Shipping and Tracking#How_does_it_work?|How does it work?]]
# [[Pinecil Shipping and Tracking#Courier_options|Courier options]]
# [[Pinecil Shipping and Tracking#Tracking|Tracking]]
# [[Pinecil_Shipping_and_Tracking#Why_doesn't_Pine_Store_Ship_to_my_country?| Why doesn't Pine store ship to my country?]]

== Usage ==
=== Overview ===

'''Prep Tasks'''

{{Hint|Clean new cartridges/tips with isopropyl alcohol (IPA) to remove factory residue before installing (even if it looks clean). If you have no IPA, at least try a paper towel, especially clean the white end with the two silver electric contacts (do not use water; it could get into the seam line on the white end). This resolves issues with jumping temperatures or random no-tip symbol from poor electric contact.}}

Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).

'''1. Install the tip''': The Pinecil comes with a separate heating element, the tip.

# Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic (see [[:File:Pinecilv2-1.jpg|photo]]).
# Gently tighten or loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
# The bottom front screw should not touch the tip, it only holds the handle together (see [[#Fasteners/Screws|Fasteners]]).
# Always unplug before swapping tips if you have multiple tips.

'''2. Supply power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.

# USB port at 5 volts (i.e., laptop) shows ''DC Low'', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
# See [[#Power_Supplies_and_Watts|Power section]] for details on power options. [[#QC_Chargers|QC 12V phone chargers will not work, too weak]]

'''3. Heat the tip''': plug Pinecil into an appropriate [[Pinecil_Power_Supplies|power supply]].

# Clicking <code>'''[+]'''</code> starts the tip heating.
# The detailed display option shows power draw, current temperature, supply voltage, and time until sleep mode starts.
# Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
# Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
# You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ GitHub IronOS for details on firmware] settings).

'''4. Using the Settings Menu''':

# To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22". This is the firmware number and release date, the date is July 13, 2022 in the example.
# Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see [[#Getting_Started_with_the_Menu|Getting started with menus section]].
# Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
# Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.

'''5. Important notes''':

# The iron will "sleep", switching to a lower temperature, after it has been put down for a short time, and heat up again when it is picked up.
# Calibration of the Tip temperature is usually not necessary and should only be done if the tip is off by +/- 5 °C or temperature is behaving oddly. See instructions to [https://ralim.github.io/IronOS/Menu/#calibrate-tip-cjc calibrate the tip in the firmware on GitHub IronOS.]
# '''For Safety''', unplug the soldering Iron when not in use or left unattended.
# To heat up the tip, we need a [[Pinecil_Power_Supplies|power supply]] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended (see [[Pinecil Power Supplies]]).
## Option 1: a USB-C supply that can negotiate up to such a voltage. For good performance and soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
## Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
## Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adapter, and a cable to plug into the Pinecil DC5525 barrel jack.
## You may have a suitable supply already that could be used, (see [[Pinecil Power Supplies]]).
## While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V USB-C charger or a higher rated DC barrel charger.
## See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started with the Menu ===

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

== Optional Advanced Modifications ==

# [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]]: add a sensor that activates with a magnet to put the Pinecil to sleep when it enters a holder or stand.
# [[#Fasteners/Screws| Thumb Screws]]: switch tiny tip holder screw to an easy to use thumb screw.
# [https://github.com/Herushan/Pinecil_LED_Ring/blob/main/Pinecil_LED_Ring_writeup.pdf LED light ring install]: add a PCB light ring to Pinecil. [https://www.youtube.com/watch?v=LMbjwjDbSew Video of the process]
# [https://forum.pine64.org/showthread.php?tid=16989 LED light install]: add two LEDs to Pinecil.
# [https://www.reddit.com/r/PINE64official/comments/z489qt/customized_pinecil_v2/ RGB internal LED] - pink and blue LEDs.

== Live Community Chat ==

* Need troubleshooting advice for the PINE64 Pinecil soldering iron? Join through one of the community chat links below.
* Protocol Droid bot: the live chat is bridged to Discord, Telegram, Matrix and IRC. Those bridges will not have all the features available within all platforms, but the chat is relayed between all four by a bot named "Protocol Droid".
* Live chat has volunteer members that are not paid PINE64 employees, but occasionally get official information.
* The ''Pinecil channel'' is the most popular for questions and troubleshooting such as help installing Firmware or use of Tips (and where most people discuss Pinecil/soldering). The ''pinecil-dev channel'' is a more limited chat for developers working on software/firmware such as IronOS or the new BLE Bluetooth apps.

# [https://discord.gg/pine64 Discord]
# [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]
# [https://matrix.to/#/#pinecil:matrix.org Matrix]

== Firmware & Updates ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

See the '''[[Pinecil_Firmware|Pinecil Firmware]]''' article for instructions on how to update Pinecil, this includes:

# [[Pinecil_Firmware#Overview|Overview]]
# [[Pinecil_Firmware#Flash_Mode|Flash Mode]]
# [[Pinecil_Firmware#Update_V2:_Windows|Update V2: Windows]]
# [[Pinecil_Firmware#Update_V2:_Linux_and_Mac|Update V2: Linux and Mac]]
# [[Pinecil_Firmware#Bluetooth_(BLE)_Apps| Bluetooth (BLE) for V2]]
# [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshoot V2 Flashing]]
# [[Pinecil_Firmware#Build_the_Blisp_Flasher_from_Code|Build the Blisp Flasher from Code]]
# [[Pinecil_Firmware#Update_V1|Update V1]]
# [[Pinecil_Firmware#General_Firmware_Details|General Firmware Details]]
# [[Pinecil_Firmware#Boot_Logo_Art| Boot Logo Art]]
# Problems with IronOS firmware? Read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Development Projects ==

{| class="wikitable"
! Author !! Project Homepage !! Description !! Supported
|-
| Ben Brown ([https://github.com/Ralim?tab=repositories ralimtek])
| [https://ralim.github.io/IronOS/ Ralim's IronOS]
| Official Pinecil firmware
| BL706, GD32VF103TB, Stm32f103
|-
| Marek Kraus [https://github.com/gamelaster gamiee/gamelaster]
| [https://github.com/pine64/blisp Blisp V2 Flasher]
| CLI Updater for Pinecil V2, BL70x MCU
| Windows, Linux, Mac
|-
| Marek Kraus [https://github.com/gamelaster gamiee/gamelaster]
| [https://github.com/pine64/pine64_updater Pinecil V1 Flasher]
| Pinecil V1 GUI Updater
| Windows, Mac
|-
| Arkaitz Goni Hedger [https://github.com/Spagett1?tab=repositories spagett1]
| [https://github.com/Laar3/PineFlash PineFlash]
| Pinecil V1 GUI Updater
| Linux, Mac
|-style="background-color:Aliceblue"
| [https://github.com/builder555 Builder555]
| [https://github.com/builder555/PineSAM BLE PineSAM]
| Bluetooth LE Settings & temperature control from any browser
| Cross-platform, runs local script to control Pinecil from PC or phone.
|-style="background-color:Aliceblue"
| [https://github.com/joric?tab=repositories Joric] (iamjoric)
| [https://joric.github.io/pinecil/ BLE browser API]
| [https://github.com/joric/pinecil/wiki Bluetooth LE Graph]
| Windows, Linux, Android browsers that support BLE GATT
|-style="background-color:Aliceblue"
| Tom W ([https://github.com/TomW1605 TomW1605]) & [https://github.com/ithinkido?tab=repositories ithinkido]
| [https://github.com/TomW1605/esphome_pinecilv2_ble BLE V2 + ESP32]
| Bluetooth LE V2 data => ESP32 BLE+Wifi => Home Assist display
| Cross Platform
|-
| Bouffalo Lab
| [https://dev.bouffalolab.com/download B-Lab Dev Cube ]
| MCU vendor GUI for Dev
| BL70x, BL60x, others (does not work for Pinecil V2)
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs Rust code on GD32VF103]
| Rust code demos for Pinecil V1
| GD32VF103TB
|}

{{Hint| Note: Bluetooth (BLE) apps require upgrading Pinecil V2 to IronOS '''2.21''' or newer [https://github.com/Ralim/IronOS/releases/ firmware here].}}

== Power Supplies and Watts ==
Generally, a higher power charger is better; a 20V power supply will give better performance than a 15V charger. The Pinecil needs a minimum of 3 amps and will work with higher amps charger. However, do not exceed the volts rating for V1 and V2 models or damage to components could occur (see the side of the Pinecil handle for the maximum volts).

=== Power Chart ===

{| class="wikitable" style="text-align:center;"
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

=== Power Notes ===

* PINE64 officially states the Pinecil V2 will support up to 24V-88W. Tentatively, the V2 also ''unofficially'' supports 28V-140W EPR/PD3.1 USB-C chargers with certified EPR 240W USB-C cables.
* Maximum recommended DC barrel power is 24V-5A on V2 (21v on V1). This allows headroom for higher spikes that happen in DC bricks or off-brand bench supplies. It is ''not a smart charger'' like a USB-C charger which uses chips to negotiate with devices like the Pinecil. People have blown MOSFET and buck converters experimenting with higher than 24V DC barrel bricks (especially the cheap "universal" no-name types).
* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] includes the PD3.1 protocol (which allows the use of EPR 28V-140W chargers) on Pinecil V2.
* EPR 28V USB-C is new to the market in 2022. The first wave of these smart chargers are 28V/140W, are more expensive, and require a PD 3.1/240W cable to fully allow the 28V power to V2 (28V seen on screen if correct cable is used).
* EPR is backwards compatible for all USB-C devices. EPR chargers/cables can be used for everything else USB-C as well.
* Pinecil is not a USB-C tester: when the ''detailed screen'' is enabled on Pinecil, note it shows estimates and are at best +-10%. The watts shown on ''detailed'' mode are a big picture number for convenience and debugging various chargers used. It is not going to be as accurate as an external tester. Use external metering for comparisons or testing (external testers also cause a small reduction in Watts).

=== QC Chargers ===

Many Quick Charge or QC3 phone chargers are '''not recommended''' as Pinecil V2 is rated for a ''minimum of 3 Amps'' or more to work properly (see [https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to <code>Thermal Runaway</code> or <code>Undervoltage</code> messages because of weak power (older QC2 type is not supported in the IronOS firmware at all).

== Compatible Power Supplies ==

Go to the '''[[Pinecil Power Supplies]]''' article for details on how to select a charger, hook up a battery, and a list of compatible power supplies and cables.

== Checklist ==

Prep tasks:

# '''Clean new cartridges/tips with 99% isopropyl alcohol (IPA)''' to remove factory residue before installing (avoid strange behavior from poor electric contact). If you have none, try to at least wipe down the new cartridge with a clean towel especially the 2 contacts at the rear white end (do not use water, as it could get into the small white seam line).
# Do not bend the two tiny [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are thin spring metal and may break.
# Only use one port, USB-C or the DC barrel, but Never both at the same time. Damage will occur to PC/ Laptop/ Pinecil!
# If using a DC barrel brick for power, do not use more than 24V for Pinecil V2 and not more than 21V for Pinecil V1 (a [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1,_24V_Mod|special end-user modification]] is possible for V1 which allows it to use up to 24V safely.

Upon receipt, or buying a used Pinecil, one may want to check the following:

# The display turns on when 5-21V is supplied (V2 models can do 24V).
#* Use a USB type C cable or a DC 5525 ''center positive'' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Use the video linked to make sure the DC barrel charger is ''Center Positive'' before plugging it into Pinecil. Several users have accidentally plugged incorrect center-negative chargers into Pinecil which immediately breaks it because it is the wrong type of charger (this is sometimes repairable, see [[#Live_Community_Chat| live community chat]]).
#* Note that 5v shows ''DC low'' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the USB-C cable (try to flip it if one way doesn't work).
# Check for new firmware updates, see the [[#Firmware_&_Updates |Firmware section]].
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in at a time. You could damage/break the PC and Pinecil doing this.
#* V1 and V2 used different flasher apps to load firmware onto the Pinecil, see the [[#Firmware & Updates|Firmware section]].
#* Updating firmware requires a ''data'' capable USB cable connected to a PC/laptop.
# Check that both buttons work
#* <code>[-]</code> to enter menu or decrease temperature, long press <code>[-]</code> to get the software version info or to turn off heating
#* <code>[+]</code> to turn on heating or select a menu item
# The displayed text rotates according to gravity when orientation is set to ''Automatic''
#* User interface -> Display orientation -> Automatic
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS documents]
# Check that all 3 external screws are present
## One near the back of the screen (ground screw for optional ground wire)
## One at the front on top (to hold the tip in)
## One at the front on the bottom (to hold the case together, does not touch the tip)
# Check that the tip is clean & wipe it down with a dry towel or IPA (uniformly silver at the front, with no pitting or texture).
#* Some tips come pre-dipped in solder for protection and may look odd. Heat them up then wipe clean on a soldering sponge or brass wool and inspect.
#* Heat up the tips a few times to 350°C for a couple minutes to check that they are working and melting solder.
#* See [[#Pinecil Tips|Pinecil Tips]] and [[#Guides to Soldering & Maintenance|Guides to Soldering & Maintenance]] for soldering advice.
#* Re-tin the tip before storing is advised to prevent oxidation.
# Check that it heats up with an installed tip, and stops increasing when it reaches the set point.
#* This may draw up to ~3A, make sure the [[Pinecil Power Supplies|power supply]] can provide a minimum of 3amps or more.
#* Minor overshoot may occur, but, disconnect power if the temperature keeps going up higher without user input and check with the [[#Live_Community_Chat|live volunteer Pinecil channel]].
# Do a simple test is to see if the iron will melt solder at approximately the expected temperature for the alloy of solder being tested.
#* If no direct measurement is possible, set it to ~230°C and see if it just about melts SAC (lead-free) solder (~190°C for leaded). This may be more if the room is cold.
# If there are multiple tips, wipe all of them with isopropyl alcohol (IPA) or a dry clean towel and check that they all heat up.
# If the tip moves a little while using it, try to hold Pinecil with the screen facing the side or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel instead of wobbling on the stub of the small screw.

== Specifications ==

=== Pinecil V2 ===

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

=== Pinecil V1 ===

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

=== Fasteners/Screws ===

[[File:Pinecil-Thumb-Screws-02.png|200px|thumb|right| Thumb Screws]]

* Originals screws are Phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]): two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button.
* The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter m2x 3mm.
* ''Thumb screws'' are popular upgrades: an ''M2 x 4mm'' thumb screw could replace both the front screen-side Tip holder screw and the ground screw in the rear of the handle.
* It was found that an M2x3mm thumb screw for the tip is a hair ''too short'', and just grazes the Tip and the longer ''m2 x 4mm is better on top''.
* [https://www.aliexpress.com/item/3256803069568247.html Stainless Steel, smaller thumb screw, get M2x4mm]
* [https://www.aliexpress.us/item/3256804077282767.html Black, smaller thumb screw get M2x4mm]
* Wider head [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.aliexpress.com/item/2255799966445780.html (2) Thumb screw]
* Many Assorted [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm M2x4mm screw Options]

{{Info| If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used lightly to shorten it a small amount. Stainless steel is recommended as the softer aluminum screws could mushroom as you tighten down the tip screw too much or over time.}}

* If you just want to swap out the stock Phillips screws for Hex key/Allen type get (2) m2x4mm & (1) m2x3mm:
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw] and [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw]

== Manuals ==

* Navigate the Pinecil menus: [https://ralim.github.io/IronOS/GettingStarted/ Guide here].
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]

== Pictures ==

Pre-release:

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

Production:

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

Cartridge/Tips:

<gallery>
File:Pinecil-Short-Tip-SetFine-1.jpeg| [https://pine64.com/product/pinecil-soldering-short-tip-set-fine/ Short Tips, Fine Set] |alt=alt language
File:Pinecil-Short-Tip-SetGross-1.jpeg| [https://pine64.com/product/pinecil-soldering-short-tip-set-gross/ Short Tips, Gross Set] |alt=alt language
File:Pinecil-Tip-SetFine-1.jpg| [https://pine64.com/product/pinecil-soldering-tip-set-fine/ Normal Tips, Fine Set] |alt=alt language
File:Pinecil-Tip-SetGross-1.jpg| [https://pine64.com/product/pinecil-soldering-tip-set-gross/ Normal Tips, Gross Set] |alt=alt language
</gallery>

PCB:

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

Accessories:

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

== Pinecil Breakout board ==

The Pinecil Break out board has these features:

* Connect to JTAG port or ADC/DAC, I2C, UART, SPI
* Independent power regulator circuit
* Allows pass through power from USB-C charger to Pinecil.
* Get the [https://pine64.com/product/pinecil-break-out-board/ Breakout Board here].
* [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_Schematic_v1.0_20201005.pdf Pinecil breakout board schematic ver 1.0 20201005]
* [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_PCB_layout_v1.0_20201005.pdf Pinecil breakout board PCB layout ver 1.0]

Photos:

<gallery>
File:Pinecil breakout top.jpg|Top view
File:Pinecil breakout bottom.jpg|Bottom view
File:UART-pinecil-breakout-board-testing30.png| UART Debugging
</gallery>

== Pinecil Tips ==
See the [[Pinecil Tips]] article which includes these topics:

# [[Pinecil_Tips#What_kind_of_tips_work?|What kind of tips work?]]
# [[Pinecil_Tips#How_to_increase_tip_life?|How to increase tip life?]]
# [[Pinecil_Tips#How_to_check_new_tips? | How to check new tips?]]
# [[Pinecil_Tips#How_does_the_tip_work?|How does the tip work?]]
# [[Pinecil_Tips#I._Short_tips|PINE64 Short tips]]
# [[Pinecil_Tips#II._Normal_tips|PINE64 Normal tips]]

== Guides to Soldering & Maintenance ==

Check out the [[Pinecil Guides to Soldering]] article which includes the following topics:

# [[Pinecil Guides to Soldering#General_soldering_guides|General soldering guides]]
# [[Pinecil Guides to Soldering#Does_solder_type_and_flux_matter?|Does solder type and flux matter?]]
# [[Pinecil_Guides_to_Soldering#How_to_keep_the_tip_clean?|How to keep the tip clean?]]
# [[Pinecil Guides to Soldering#What_temperature_should_I_use?|What temperature should I use?]]

== Cases, Stands, 3D models, Supplies ==

See the article on [[Pinecil Cases, Stands, Supplies]] which includes:

# [[Pinecil Cases, Stands, Supplies#Cases and bags|Cases and bags]]
# [[Pinecil Cases, Stands, Supplies#Holders and stands|Holders and stands]]
# [[Pinecil Cases, Stands, Supplies#3D models|3D models]]
# [[Pinecil Cases, Stands, Supplies#3D models|Soldering supplies]]

== Test, Repair, Issues ==

* Most Pinecils work fine for years, but sometimes things happen and a little help is needed.
* Just want to open it to change to a shiny new handle?
* See the '''[[Pinecil:_Test,_Repair,_Issues| Test & Repair]]''' article which includes:

# [[Pinecil:_Test,_Repair,_Issues#Cautions|Cautions]] and [[Pinecil:_Test,_Repair,_Issues#Tools_needed|Tools needed]].
# [[Pinecil:_Test,_Repair,_Issues#Easy_trick_to_open_Pinecil|Easy trick to open Pinecil]], [https://www.youtube.com/watch?v=aK01V5DrrVk video here].
# How to [[Pinecil:_Test,_Repair,_Issues#Dismantle_steps|Dismantle]] and [[Pinecil:_Test,_Repair,_Issues#Assemble_steps|Assemble]].
# [[Pinecil:_Test,_Repair,_Issues#FAQ| FAQ]]
#* [[Pinecil:_Test,_Repair,_Issues#Common_Fixes|Common Fixes]]
#* [[Pinecil:_Test,_Repair,_Issues#Common_Questions| Common Questions]]
# [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data| Schematics]] and [[Pinecil:_Test,_Repair,_Issues#Datasheets_for_Components| Datasheets]] with links to parts.
# [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1,_24V_Mod|Older Pinecil V1, 24V mod]]

== Schematics and Board Data ==

Go to the section on [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data| Schematics and Board Data here]].

== Datasheets for Components ==

Go to the [[Pinecil:_Test,_Repair,_Issues#Datasheets_for_Components|Datasheets section here]] which includes:

# Pinecil [[Pinecil:_Test,_Repair,_Issues#Pinecil_V2_datasheets| V2 datasheets]].
# Pinecil [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1_datasheets| V1 datasheets]].

== Pinecil Certifications ==

Pinecil V2 Certifications:

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

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

== History of Pinecil Changes ==

'''Pinecil V2'''

* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accessories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing handles, cases, and tips. It comes with a green color silicone grip versus the light blue finger grip from Pinecil V1. It also includes one of PINE64's newly designed shorter 6.2 ohm tips. By reducing the tip length and resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (short tips are potentially 64W @ 20V compared to 8ohm normal tips which allow a max of 50W to Pinecil). Pinecil V2 is ''officially'' rated for 12V-24V.
* Key changes in V2: new processor (BL706), higher maximum input voltage (24V versus V1's 21V rating), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will expose features over BLE. This is not trivial work, but as people contribute to the opensource code of GitHub/IronOS, BLE options will expand. There is also tentative support for USB-PD3.1 EPR (28V, 140W chargers), Ralim's IronOS supports V2 running with USB-C EPR-28V. EPR/PD3.1 is not officially acknowledged yet by the Pine Store. Many brands of EPR USB-C chargers are confirmed by members to work on Pinecil V2 at 28V and this results in faster heating performance over PD 20V chargers [https://www.youtube.com/watch?v=nTC-ah4f0hg see short test here].
* Things staying the same in V2: it still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, and compatibility with existing clear or black handles.
* In the V2 handle's side label, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

'''Pinecil V1'''

* For the first manufacture batch (October 2020, order number 158xxx) of the Pinecil, the copper ring connecting the earth screw to the tip was omitted as the engineering team found the TS100 design lacking. For the second round onward, an improved design copper ring has been included as standard, and is also included with the replacement clear and black handles. For normal operation of the iron, omission of the ring does not impact it's operation. '''If you are working with ESD components, you will need it in order to ground the iron tip via the earth screw at the back of the iron.'''
* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]
* The first batch of Pinecils were rated 12-24v @ 65W. After some heated discussion on the discussion group, it was decided that it would be downgraded to 12-21V @ 60W, due to concern over the connection of the DC jack to the USB-PD chip, which has a recommended maximum of 21v, and absolute maximum of 28v.

== Pinecil in the Media ==
=== Humor ===

* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Most interesting man]
* Science Pinecil

<gallery>
File:Science-pinecil-v2-01.png
</gallery>

=== Videos ===

* [https://www.youtube.com/watch?v=0IZMUOik2dI V2 review, Aditya Mukherjee]
* [https://www.youtube.com/watch?v=YeKv0fwshFQ V2 review, Platima Tinkers]
* [https://youtu.be/k-wo_al9QJU?t=61 V1 review, Adrian's Basement]
* [https://www.youtube.com/watch?v=eme_AUayLp8 V1 review, Adam Welch]
* [https://www.youtube.com/watch?v=KQBL4aZkzo0 Custom made wood box]
* [https://www.youtube.com/watch?v=LEKx0nGIrIA Aluminum carry box]

=== Pinecil V2 Articles ===

* [https://thepotato.tech/posts/smarthome-soldering-iron-pinecil-homeassistant-esphome/ Smart Soldering Iron, Got Bluetooth?]
* [https://hackaday.com/2023/01/31/all-about-usb-c-pinecil-soldering-iron How Pinecil Integrates newest USB-C protocols]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]
* [https://www.cnx-software.com/2022/07/29/pinecil-v2-soldering-iron-gets-bl706-bluetooth-le-risc-v-mcu-usb-pd-epr-support/ CNX Software Review]

=== Pinecil V1 Reviews ===

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

=== Pinecils in the Field ===

* [https://www.thedrive.com/the-war-zone/task-force-99-is-small-agile-and-laser-focused-on-its-own-backyard Pinecils in the field]

[[Category:Pinecil]]

Pinecil

2023-06-18T22:37:01Z

River: /* Power Notes */

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

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

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

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

== Main features ==

* Portability and Temperature control
* Soldering tips:
# Replaceable and low cost
# Many styles: [https://pine64.com/product-category/pinecil/ currently sold] as 4-packs, one fine set, the other larger.
# Compatible with other ts100 tips.
* Multiple power sources will work for more flexibility:
# USB-C PD (power delivery), minimum 3 Amps, 12V.
# DC 5525 Barrel jack charger, minimum 3 Amps, 12V.
# Battery: connect to 18V-21V Lithium-ion tool batteries or 3S/4S/5S LiPo batteries.
* Pinecil V2 has a BL706 chip, see [[#History_of_Pinecil_Changes|history of changes below]].
** Board [[#Schematics,_Board_Data,_Certifications|schematics]] are open. Software is open. Create your own!
** [https://pine64.com/product/pinecil-break-out-board/ Pinecil breakout board] lets you use JTAG, GPIO, A2D, SPI, and more.

Additional features (useful for devkit):

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

== Authenticity ==

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

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

=== Pinecil V2 Authenticity Checker ===
Pinecil V2 comes with a unique internal ID/Serial number. This allows people to check if the Pinecil V2 is Authentic.
To be more sure, update to the newest stable Ralim's IronOS and check again, see [[#Firmware_&_Updates| Firmware & Updates]].

{{Note|[https://pinecil.pine64.org/ Authenticity Checker here.]}}

== Where to buy a Pinecil ==

'''PINE64 Official Stores'''

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

'''PINE64 EU'''

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

'''Affiliates'''

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

'''Why buy from a legitimate seller?'''

The PINE64 Mission is to get hardware into the hands of open source developers and tinkerers. Buying authentic Pinecils supports that mission (see [https://www.pine64.org/2019/08/19/its-time-to-start-giving-back/ this article]).

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

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

== Shipping & Tracking ==

See the [[Pinecil_Shipping_and_Tracking| Shipping and Tracking]] article, which includes:

# [[Pinecil Shipping and Tracking#How_does_it_work?|How does it work?]]
# [[Pinecil Shipping and Tracking#Courier_options|Courier options]]
# [[Pinecil Shipping and Tracking#Tracking|Tracking]]
# [[Pinecil_Shipping_and_Tracking#Why_doesn't_Pine_Store_Ship_to_my_country?| Why doesn't Pine store ship to my country?]]

== Usage ==
=== Overview ===

'''Prep Tasks'''

{{Hint|Clean new cartridges/tips with isopropyl alcohol (IPA) to remove factory residue before installing (even if it looks clean). If you have no IPA, at least try a paper towel, especially clean the white end with the two silver electric contacts (do not use water; it could get into the seam line on the white end). This resolves issues with jumping temperatures or random no-tip symbol from poor electric contact.}}

Do not try to bend the two [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are made of a thin stiff spring metal and could break (not soft copper), but you could wipe them with IPA (including the small PCB pad below the contacts).

'''1. Install the tip''': The Pinecil comes with a separate heating element, the tip.

# Remove the screw from the front top-side of handle. Then, gently push the tip all the way back until the wide collar/guard is touching the front of the plastic (see [[:File:Pinecilv2-1.jpg|photo]]).
# Gently tighten or loosen this screw to install or swap the tip. (careful, tiny screws break easy, if tip does not fall out, it's tight enough)
# The bottom front screw should not touch the tip, it only holds the handle together (see [[#Fasteners/Screws|Fasteners]]).
# Always unplug before swapping tips if you have multiple tips.

'''2. Supply power''': the USB-C port, connected to any supply, is enough power to show the display screen, but not necessarily enough to heat the tip.

# USB port at 5 volts (i.e., laptop) shows ''DC Low'', this is enough for [https://ralim.github.io/IronOS/#getting-started firmware updates] and to view the menu, but not to run the soldering iron.
# See [[#Power_Supplies_and_Watts|Power section]] for details on power options. [[#QC_Chargers|QC 12V phone chargers will not work, too weak]]

'''3. Heat the tip''': plug Pinecil into an appropriate [[Pinecil_Power_Supplies|power supply]].

# Clicking <code>'''[+]'''</code> starts the tip heating.
# The detailed display option shows power draw, current temperature, supply voltage, and time until sleep mode starts.
# Adjust the target temperature with further clicks of <code>'''[+]'''</code> and <code>'''[-]'''</code> buttons.
# Wait a few seconds for the regular display to return, then hold down <code>'''[-]'''</code> for a moment to turn the heat off.
# You can observe the temperature measurement go up and down. Certain settings involve holding down both buttons (see [https://ralim.github.io/IronOS/ GitHub IronOS for details on firmware] settings).

'''4. Using the Settings Menu''':

# To check the firmware version, hold down the <code>'''[-]'''</code> button. It will display something like "v2.19.A3BBABC 13-07-22". This is the firmware number and release date, the date is July 13, 2022 in the example.
# Clicking <code>'''[-]'''</code> when heat is off steps through main categories menus to control a variety of settings, see [[#Getting_Started_with_the_Menu|Getting started with menus section]].
# Clicking <code>'''[-]'''</code> also returns to the regular display of temperature and supply voltage (this view varies if you activate detailed idle). At other times it may show power draw.
# Click <code>'''[-]'''</code> to scroll to the the main menu section desired (i.e., User Interface). Then click <code>'''[+]'''</code> button to change various internal settings. Then click <code>'''[-]'''</code> again to go to the next item in the sub-menu.

'''5. Important notes''':

# The iron will "sleep", switching to a lower temperature, after it has been put down for a short time, and heat up again when it is picked up.
# Calibration of the Tip temperature is usually not necessary and should only be done if the tip is off by +/- 5 °C or temperature is behaving oddly. See instructions to [https://ralim.github.io/IronOS/Menu/#calibrate-tip-cjc calibrate the tip in the firmware on GitHub IronOS.]
# '''For Safety''', unplug the soldering Iron when not in use or left unattended.
# To heat up the tip, we need a [[Pinecil_Power_Supplies|power supply]] that can provide at least 12V 3A to run. This is the bare minimum. Pinecil will heat slowly at only 12V/3A. To maximize performance, higher Volts/Amps/Watts is recommended (see [[Pinecil Power Supplies]]).
## Option 1: a USB-C supply that can negotiate up to such a voltage. For good performance and soldering experience, a USB-C '''PD65W, 20V, 3+ A''' charger is recommended (suitable for most users).
## Option 2: a supply with a DC 5525 barrel connector [https://www.youtube.com/watch?v=5DBTNplNTfA (+ pos center, - neg outside)] that supplies anywhere from 12V-21V, 3+ amps (V1 Pinecil) or 12V-24V, 3+ amps (V2 Pinecil).
## Option 3: use a battery, i.e., an 18V-21V tool Battery with a Power Wheels adapter, and a cable to plug into the Pinecil DC5525 barrel jack.
## You may have a suitable supply already that could be used, (see [[Pinecil Power Supplies]]).
## While 12V-3A will work, it will not heat the tip as quickly and efficiently as a PD65W-20V USB-C charger or a higher rated DC barrel charger.
## See warnings about using random DC barrel chargers, not all of them have the correct polarity or DC 5525 style plug and some may be too high of voltage which could damage the Pinecil.

=== Getting Started with the Menu ===

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

== Optional Advanced Modifications ==

# [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]]: add a sensor that activates with a magnet to put the Pinecil to sleep when it enters a holder or stand.
# [[#Fasteners/Screws| Thumb Screws]]: switch tiny tip holder screw to an easy to use thumb screw.
# [https://github.com/Herushan/Pinecil_LED_Ring/blob/main/Pinecil_LED_Ring_writeup.pdf LED light ring install]: add a PCB light ring to Pinecil. [https://www.youtube.com/watch?v=LMbjwjDbSew Video of the process]
# [https://forum.pine64.org/showthread.php?tid=16989 LED light install]: add two LEDs to Pinecil.
# [https://www.reddit.com/r/PINE64official/comments/z489qt/customized_pinecil_v2/ RGB internal LED] - pink and blue LEDs.

== Live Community Chat ==

* Need troubleshooting advice for the PINE64 Pinecil soldering iron? Join through one of the community chat links below.
* Protocol Droid bot: the live chat is bridged to Discord, Telegram, Matrix and IRC. Those bridges will not have all the features available within all platforms, but the chat is relayed between all four by a bot named "Protocol Droid".
* Live chat has volunteer members that are not paid PINE64 employees, but occasionally get official information.
* The ''Pinecil channel'' is the most popular for questions and troubleshooting such as help installing Firmware or use of Tips (and where most people discuss Pinecil/soldering). The ''pinecil-dev channel'' is a more limited chat for developers working on software/firmware such as IronOS or the new BLE Bluetooth apps.

# [https://discord.gg/pine64 Discord]
# [https://t.me/joinchat/Kmi2S1iej-_4DgrVf3jjnQ Telegram]
# [https://matrix.to/#/#pinecil:matrix.org Matrix]

== Firmware & Updates ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

See the '''[[Pinecil_Firmware|Pinecil Firmware]]''' article for instructions on how to update Pinecil, this includes:

# [[Pinecil_Firmware#Overview|Overview]]
# [[Pinecil_Firmware#Flash_Mode|Flash Mode]]
# [[Pinecil_Firmware#Update_V2:_Windows|Update V2: Windows]]
# [[Pinecil_Firmware#Update_V2:_Linux_and_Mac|Update V2: Linux and Mac]]
# [[Pinecil_Firmware#Bluetooth_(BLE)_Apps| Bluetooth (BLE) for V2]]
# [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshoot V2 Flashing]]
# [[Pinecil_Firmware#Build_the_Blisp_Flasher_from_Code|Build the Blisp Flasher from Code]]
# [[Pinecil_Firmware#Update_V1|Update V1]]
# [[Pinecil_Firmware#General_Firmware_Details|General Firmware Details]]
# [[Pinecil_Firmware#Boot_Logo_Art| Boot Logo Art]]
# Problems with IronOS firmware? Read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Development Projects ==

{| class="wikitable"
! Author !! Project Homepage !! Description !! Supported
|-
| Ben Brown ([https://github.com/Ralim?tab=repositories ralimtek])
| [https://ralim.github.io/IronOS/ Ralim's IronOS]
| Official Pinecil firmware
| BL706, GD32VF103TB, Stm32f103
|-
| Marek Kraus [https://github.com/gamelaster gamiee/gamelaster]
| [https://github.com/pine64/blisp Blisp V2 Flasher]
| CLI Updater for Pinecil V2, BL70x MCU
| Windows, Linux, Mac
|-
| Marek Kraus [https://github.com/gamelaster gamiee/gamelaster]
| [https://github.com/pine64/pine64_updater Pinecil V1 Flasher]
| Pinecil V1 GUI Updater
| Windows, Mac
|-
| Arkaitz Goni Hedger [https://github.com/Spagett1?tab=repositories spagett1]
| [https://github.com/Laar3/PineFlash PineFlash]
| Pinecil V1 GUI Updater
| Linux, Mac
|-style="background-color:Aliceblue"
| [https://github.com/builder555 Builder555]
| [https://github.com/builder555/PineSAM BLE PineSAM]
| Bluetooth LE Settings & temperature control from any browser
| Cross-platform, runs local script to control Pinecil from PC or phone.
|-style="background-color:Aliceblue"
| [https://github.com/joric?tab=repositories Joric] (iamjoric)
| [https://joric.github.io/pinecil/ BLE browser API]
| [https://github.com/joric/pinecil/wiki Bluetooth LE Graph]
| Windows, Linux, Android browsers that support BLE GATT
|-style="background-color:Aliceblue"
| Tom W ([https://github.com/TomW1605 TomW1605]) & [https://github.com/ithinkido?tab=repositories ithinkido]
| [https://github.com/TomW1605/esphome_pinecilv2_ble BLE V2 + ESP32]
| Bluetooth LE V2 data => ESP32 BLE+Wifi => Home Assist display
| Cross Platform
|-
| Bouffalo Lab
| [https://dev.bouffalolab.com/download B-Lab Dev Cube ]
| MCU vendor GUI for Dev
| BL70x, BL60x, others (does not work for Pinecil V2)
|-
| Alvin Wong
| [https://github.com/alvinhochun/gd32vf103-pinecil-demo-rs Rust code on GD32VF103]
| Rust code demos for Pinecil V1
| GD32VF103TB
|}

{{Hint| Note: Bluetooth (BLE) apps require upgrading Pinecil V2 to IronOS '''2.21''' or newer [https://github.com/Ralim/IronOS/releases/ firmware here].}}

== Power Supplies and Watts ==
Generally, a higher power charger is better; a 20V power supply will give better performance than a 15V charger. The Pinecil needs a minimum of 3 amps and will work with higher amps charger. However, do not exceed the volts rating for V1 and V2 models or damage to components could occur (see the side of the Pinecil handle for the maximum volts).

=== Power Chart ===

{| class="wikitable" style="text-align:center;"
! Type !! Volts !! / !! Tip Ω !! = !! Amps !! * !! Volts !! = !! Watts
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 8.0 Ω || = || 2.5A || * || 20V || = || '''50W'''
|-style="background-color:Aliceblue"
| USB-C PD3.0 || 20V || / || 6.2 Ω || = || 3.2A || * || 20V || = || '''64W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 8.0 Ω || = || 3.0A || * || 24V || = || '''72W'''
|-style="background-color:LavenderBlush"
| DC Barrel || 24V || / || 6.2 Ω || = || 3.8A || * || 24V || = || '''92W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 8.0 Ω || = || 3.5A || * || 28V || = || '''98W'''
|-style="background-color:Honeydew"
| *EPR PD3.1 || 28V || / || 6.2 Ω || = || 4.5A || * || 28V || = || '''126W'''
|-
|}

=== Power Notes ===

* PINE64 officially states the Pinecil V2 will support up to 24V-88W. Tentatively, the V2 also ''unofficially'' supports 28V-140W EPR/PD3.1 USB-C chargers with certified EPR 240W USB-C cables.
* Maximum recommended DC barrel power is 24V-5A on V2 (21v on V1). This allows headroom for higher spikes that happen in DC bricks or off-brand bench supplies. It is ''not a smart charger'' like a USB-C charger which uses chips to negotiate with devices like the Pinecil. People have blown MOSFET and buck converters experimenting with higher than 24V DC barrel bricks (especially the cheap "universal" no-name types).
* [https://ralim.github.io/IronOS/#getting-started Ralim's IronOS firmware] works with the PD3.1 protocol (EPR 28V-140W chargers) on Pinecil V2.
* EPR USB-C is new to the market in 2022. The first wave of these smart chargers are 28V/140W, are more expensive, and require a PD 3.1/240W cable to fully allow the 28V power to V2.
* EPR is backwards compatible for all USB-C devices. EPR chargers/cables can be used for everything else USB-C as well.
* Pinecil is not a USB-C tester: when the ''detailed screen'' is enabled on Pinecil, note it shows estimates and are at best +-10%. The watts shown on ''detailed'' mode are a big picture number for convenience and debugging various chargers used. It is not going to be as accurate as an external tester. Use external metering for comparisons or testing (external testers also cause a small reduction in Watts).

=== QC Chargers ===

Many Quick Charge or QC3 phone chargers are '''not recommended''' as Pinecil V2 is rated for a ''minimum of 3 Amps'' or more to work properly (see [https://pine64.com/product/pinecil-smart-mini-portable-soldering-iron/ Pine Store Official rating] on power ports). Most QC 12V phone chargers are only 1.5 Amps, this will lead to <code>Thermal Runaway</code> or <code>Undervoltage</code> messages because of weak power (older QC2 type is not supported in the IronOS firmware at all).

== Compatible Power Supplies ==

Go to the '''[[Pinecil Power Supplies]]''' article for details on how to select a charger, hook up a battery, and a list of compatible power supplies and cables.

== Checklist ==

Prep tasks:

# '''Clean new cartridges/tips with 99% isopropyl alcohol (IPA)''' to remove factory residue before installing (avoid strange behavior from poor electric contact). If you have none, try to at least wipe down the new cartridge with a clean towel especially the 2 contacts at the rear white end (do not use water, as it could get into the small white seam line).
# Do not bend the two tiny [https://pine64.com/product/pinecil-copper-clips/ internal contacts], they are thin spring metal and may break.
# Only use one port, USB-C or the DC barrel, but Never both at the same time. Damage will occur to PC/ Laptop/ Pinecil!
# If using a DC barrel brick for power, do not use more than 24V for Pinecil V2 and not more than 21V for Pinecil V1 (a [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1,_24V_Mod|special end-user modification]] is possible for V1 which allows it to use up to 24V safely.

Upon receipt, or buying a used Pinecil, one may want to check the following:

# The display turns on when 5-21V is supplied (V2 models can do 24V).
#* Use a USB type C cable or a DC 5525 ''center positive'' barrel [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]
#* Use the video linked to make sure the DC barrel charger is ''Center Positive'' before plugging it into Pinecil. Several users have accidentally plugged incorrect center-negative chargers into Pinecil which immediately breaks it because it is the wrong type of charger (this is sometimes repairable, see [[#Live_Community_Chat| live community chat]]).
#* Note that 5v shows ''DC low'' and is not high enough to run Pinecil. 5V is only enough for firmware update and to see the menu.
# It gets full power.
#* 20V from a 20V capable USB-C PD charger or power from DC barrel charger that is the appropriate specifications. The screen displays the voltage from the charger.
#* Check both orientations of the USB-C cable (try to flip it if one way doesn't work).
# Check for new firmware updates, see the [[#Firmware_&_Updates |Firmware section]].
#* Note: do not connect the DC barrel at the same time as a USB-C cable. Pinecil was designed to only have one cable plugged in at a time. You could damage/break the PC and Pinecil doing this.
#* V1 and V2 used different flasher apps to load firmware onto the Pinecil, see the [[#Firmware & Updates|Firmware section]].
#* Updating firmware requires a ''data'' capable USB cable connected to a PC/laptop.
# Check that both buttons work
#* <code>[-]</code> to enter menu or decrease temperature, long press <code>[-]</code> to get the software version info or to turn off heating
#* <code>[+]</code> to turn on heating or select a menu item
# The displayed text rotates according to gravity when orientation is set to ''Automatic''
#* User interface -> Display orientation -> Automatic
#* [https://ralim.github.io/IronOS/Settings/ More menu options listed on IronOS documents]
# Check that all 3 external screws are present
## One near the back of the screen (ground screw for optional ground wire)
## One at the front on top (to hold the tip in)
## One at the front on the bottom (to hold the case together, does not touch the tip)
# Check that the tip is clean & wipe it down with a dry towel or IPA (uniformly silver at the front, with no pitting or texture).
#* Some tips come pre-dipped in solder for protection and may look odd. Heat them up then wipe clean on a soldering sponge or brass wool and inspect.
#* Heat up the tips a few times to 350°C for a couple minutes to check that they are working and melting solder.
#* See [[#Pinecil Tips|Pinecil Tips]] and [[#Guides to Soldering & Maintenance|Guides to Soldering & Maintenance]] for soldering advice.
#* Re-tin the tip before storing is advised to prevent oxidation.
# Check that it heats up with an installed tip, and stops increasing when it reaches the set point.
#* This may draw up to ~3A, make sure the [[Pinecil Power Supplies|power supply]] can provide a minimum of 3amps or more.
#* Minor overshoot may occur, but, disconnect power if the temperature keeps going up higher without user input and check with the [[#Live_Community_Chat|live volunteer Pinecil channel]].
# Do a simple test is to see if the iron will melt solder at approximately the expected temperature for the alloy of solder being tested.
#* If no direct measurement is possible, set it to ~230°C and see if it just about melts SAC (lead-free) solder (~190°C for leaded). This may be more if the room is cold.
# If there are multiple tips, wipe all of them with isopropyl alcohol (IPA) or a dry clean towel and check that they all heat up.
# If the tip moves a little while using it, try to hold Pinecil with the screen facing the side or screen downwards. Members found that if the screen is up and the screw loosens during use, then the tip wobbles a little. Changing holding angles helps the tip press against the solid barrel instead of wobbling on the stub of the small screw.

== Specifications ==

=== Pinecil V2 ===

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

=== Pinecil V1 ===

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

=== Fasteners/Screws ===

[[File:Pinecil-Thumb-Screws-02.png|200px|thumb|right| Thumb Screws]]

* Originals screws are Phillips ([https://www.reddit.com/r/PINE64official/comments/tatf5l/comment/ig4r92v/?context=3 source]): two M2x3mm at the front, and one M2x4mm is the ground screw near the <code>'''[-]'''</code> minus button.
* The bottom-front screw only holds the handle together and does not touch the tip, hence is a shorter m2x 3mm.
* ''Thumb screws'' are popular upgrades: an ''M2 x 4mm'' thumb screw could replace both the front screen-side Tip holder screw and the ground screw in the rear of the handle.
* It was found that an M2x3mm thumb screw for the tip is a hair ''too short'', and just grazes the Tip and the longer ''m2 x 4mm is better on top''.
* [https://www.aliexpress.com/item/3256803069568247.html Stainless Steel, smaller thumb screw, get M2x4mm]
* [https://www.aliexpress.us/item/3256804077282767.html Black, smaller thumb screw get M2x4mm]
* Wider head [https://www.aliexpress.com/item/3256801293488521.html (1) Thumb screw], [https://www.aliexpress.com/item/2255799966445780.html (2) Thumb screw]
* Many Assorted [https://www.aliexpress.com/wholesale?catId=0&initiative_id=SB_20220817084841&isPremium=y&SearchText=thumb+screw+m2+stainless+steel+4mm M2x4mm screw Options]

{{Info| If the screw is too long ([https://www.aliexpress.com/item/3256804364574103.html i.e., 5mm]) a metal file can be used lightly to shorten it a small amount. Stainless steel is recommended as the softer aluminum screws could mushroom as you tighten down the tip screw too much or over time.}}

* If you just want to swap out the stock Phillips screws for Hex key/Allen type get (2) m2x4mm & (1) m2x3mm:
** [https://www.aliexpress.com/item/2261799962114486.html (1) Hex socket screw], [https://www.aliexpress.com/item/2255800794906149.html (2) Hex socket screw] and [https://www.aliexpress.us/item/2261799953187569.html (3) Hex cap screw]

== Manuals ==

* Navigate the Pinecil menus: [https://ralim.github.io/IronOS/GettingStarted/ Guide here].
* [[:File:USER MANUAL - QUICK START PINECIL multi lang EU+DE+FR.pdf|Pinecil V1 Quick Start Guide]]

== Pictures ==

Pre-release:

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

Production:

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

Cartridge/Tips:

<gallery>
File:Pinecil-Short-Tip-SetFine-1.jpeg| [https://pine64.com/product/pinecil-soldering-short-tip-set-fine/ Short Tips, Fine Set] |alt=alt language
File:Pinecil-Short-Tip-SetGross-1.jpeg| [https://pine64.com/product/pinecil-soldering-short-tip-set-gross/ Short Tips, Gross Set] |alt=alt language
File:Pinecil-Tip-SetFine-1.jpg| [https://pine64.com/product/pinecil-soldering-tip-set-fine/ Normal Tips, Fine Set] |alt=alt language
File:Pinecil-Tip-SetGross-1.jpg| [https://pine64.com/product/pinecil-soldering-tip-set-gross/ Normal Tips, Gross Set] |alt=alt language
</gallery>

PCB:

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

Accessories:

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

== Pinecil Breakout board ==

The Pinecil Break out board has these features:

* Connect to JTAG port or ADC/DAC, I2C, UART, SPI
* Independent power regulator circuit
* Allows pass through power from USB-C charger to Pinecil.
* Get the [https://pine64.com/product/pinecil-break-out-board/ Breakout Board here].
* [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_Schematic_v1.0_20201005.pdf Pinecil breakout board schematic ver 1.0 20201005]
* [https://files.pine64.org/doc/Pinecil/Pinecil_Breakout_Board_PCB_layout_v1.0_20201005.pdf Pinecil breakout board PCB layout ver 1.0]

Photos:

<gallery>
File:Pinecil breakout top.jpg|Top view
File:Pinecil breakout bottom.jpg|Bottom view
File:UART-pinecil-breakout-board-testing30.png| UART Debugging
</gallery>

== Pinecil Tips ==
See the [[Pinecil Tips]] article which includes these topics:

# [[Pinecil_Tips#What_kind_of_tips_work?|What kind of tips work?]]
# [[Pinecil_Tips#How_to_increase_tip_life?|How to increase tip life?]]
# [[Pinecil_Tips#How_to_check_new_tips? | How to check new tips?]]
# [[Pinecil_Tips#How_does_the_tip_work?|How does the tip work?]]
# [[Pinecil_Tips#I._Short_tips|PINE64 Short tips]]
# [[Pinecil_Tips#II._Normal_tips|PINE64 Normal tips]]

== Guides to Soldering & Maintenance ==

Check out the [[Pinecil Guides to Soldering]] article which includes the following topics:

# [[Pinecil Guides to Soldering#General_soldering_guides|General soldering guides]]
# [[Pinecil Guides to Soldering#Does_solder_type_and_flux_matter?|Does solder type and flux matter?]]
# [[Pinecil_Guides_to_Soldering#How_to_keep_the_tip_clean?|How to keep the tip clean?]]
# [[Pinecil Guides to Soldering#What_temperature_should_I_use?|What temperature should I use?]]

== Cases, Stands, 3D models, Supplies ==

See the article on [[Pinecil Cases, Stands, Supplies]] which includes:

# [[Pinecil Cases, Stands, Supplies#Cases and bags|Cases and bags]]
# [[Pinecil Cases, Stands, Supplies#Holders and stands|Holders and stands]]
# [[Pinecil Cases, Stands, Supplies#3D models|3D models]]
# [[Pinecil Cases, Stands, Supplies#3D models|Soldering supplies]]

== Test, Repair, Issues ==

* Most Pinecils work fine for years, but sometimes things happen and a little help is needed.
* Just want to open it to change to a shiny new handle?
* See the '''[[Pinecil:_Test,_Repair,_Issues| Test & Repair]]''' article which includes:

# [[Pinecil:_Test,_Repair,_Issues#Cautions|Cautions]] and [[Pinecil:_Test,_Repair,_Issues#Tools_needed|Tools needed]].
# [[Pinecil:_Test,_Repair,_Issues#Easy_trick_to_open_Pinecil|Easy trick to open Pinecil]], [https://www.youtube.com/watch?v=aK01V5DrrVk video here].
# How to [[Pinecil:_Test,_Repair,_Issues#Dismantle_steps|Dismantle]] and [[Pinecil:_Test,_Repair,_Issues#Assemble_steps|Assemble]].
# [[Pinecil:_Test,_Repair,_Issues#FAQ| FAQ]]
#* [[Pinecil:_Test,_Repair,_Issues#Common_Fixes|Common Fixes]]
#* [[Pinecil:_Test,_Repair,_Issues#Common_Questions| Common Questions]]
# [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data| Schematics]] and [[Pinecil:_Test,_Repair,_Issues#Datasheets_for_Components| Datasheets]] with links to parts.
# [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1,_24V_Mod|Older Pinecil V1, 24V mod]]

== Schematics and Board Data ==

Go to the section on [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data| Schematics and Board Data here]].

== Datasheets for Components ==

Go to the [[Pinecil:_Test,_Repair,_Issues#Datasheets_for_Components|Datasheets section here]] which includes:

# Pinecil [[Pinecil:_Test,_Repair,_Issues#Pinecil_V2_datasheets| V2 datasheets]].
# Pinecil [[Pinecil:_Test,_Repair,_Issues#Pinecil_V1_datasheets| V1 datasheets]].

== Pinecil Certifications ==

Pinecil V2 Certifications:

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

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

== History of Pinecil Changes ==

'''Pinecil V2'''

* On Aug. 2, 2022, Pinecil V2 was released with improved hardware & accessories. It retains the same ergonomics and design as the original Pinecil, and will work with any accessories you already have including existing handles, cases, and tips. It comes with a green color silicone grip versus the light blue finger grip from Pinecil V1. It also includes one of PINE64's newly designed shorter 6.2 ohm tips. By reducing the tip length and resistance from 8 to 6.2 ohms, it allows greater performance and and faster heating (short tips are potentially 64W @ 20V compared to 8ohm normal tips which allow a max of 50W to Pinecil). Pinecil V2 is ''officially'' rated for 12V-24V.
* Key changes in V2: new processor (BL706), higher maximum input voltage (24V versus V1's 21V rating), support for measuring tip resistance, allows automatic detection of 6.2 vs 8 ohm tips. A notable improvement is the new BL706 RISC-V processor from Bouffalo. It is similar to the BL602 in the Pinenut. The BL706 features Bluetooth Low Energy (BLE / Zigbee); future IronOS firmware releases will expose features over BLE. This is not trivial work, but as people contribute to the opensource code of GitHub/IronOS, BLE options will expand. There is also tentative support for USB-PD3.1 EPR (28V, 140W chargers), Ralim's IronOS supports V2 running with USB-C EPR-28V. EPR/PD3.1 is not officially acknowledged yet by the Pine Store. Many brands of EPR USB-C chargers are confirmed by members to work on Pinecil V2 at 28V and this results in faster heating performance over PD 20V chargers [https://www.youtube.com/watch?v=nTC-ah4f0hg see short test here].
* Things staying the same in V2: it still uses a RISC-V processor, but adds noticeable upgrades to the hardware. GPIO is broken out on USB-C for creating your own projects, same pinout as Pinecil V1, same great feel, including the rubber grip, works with all existing tips, same DC input + USB-C input connections, and compatibility with existing clear or black handles.
* In the V2 handle's side label, the 88W figure comes from a 6.5ohm tip calculation. The reason for using 6.5 instead of 6.2 for the new short tips calculation is due to tolerance during manufacturing, and leaving a conservative margin of error (actual tips appear to be 6.2 ohms). V2 set max voltage is listed as 24V because this was the value used during design and component selection.

'''Pinecil V1'''

* For the first manufacture batch (October 2020, order number 158xxx) of the Pinecil, the copper ring connecting the earth screw to the tip was omitted as the engineering team found the TS100 design lacking. For the second round onward, an improved design copper ring has been included as standard, and is also included with the replacement clear and black handles. For normal operation of the iron, omission of the ring does not impact it's operation. '''If you are working with ESD components, you will need it in order to ground the iron tip via the earth screw at the back of the iron.'''
* Programmable with [https://doc.nucleisys.com/nuclei_sdk/design/soc/gd32vf103.html tools from Gigadevice]
* The first batch of Pinecils were rated 12-24v @ 65W. After some heated discussion on the discussion group, it was decided that it would be downgraded to 12-21V @ 60W, due to concern over the connection of the DC jack to the USB-PD chip, which has a recommended maximum of 21v, and absolute maximum of 28v.

== Pinecil in the Media ==
=== Humor ===

* [https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/ Most interesting man]
* Science Pinecil

<gallery>
File:Science-pinecil-v2-01.png
</gallery>

=== Videos ===

* [https://www.youtube.com/watch?v=0IZMUOik2dI V2 review, Aditya Mukherjee]
* [https://www.youtube.com/watch?v=YeKv0fwshFQ V2 review, Platima Tinkers]
* [https://youtu.be/k-wo_al9QJU?t=61 V1 review, Adrian's Basement]
* [https://www.youtube.com/watch?v=eme_AUayLp8 V1 review, Adam Welch]
* [https://www.youtube.com/watch?v=KQBL4aZkzo0 Custom made wood box]
* [https://www.youtube.com/watch?v=LEKx0nGIrIA Aluminum carry box]

=== Pinecil V2 Articles ===

* [https://thepotato.tech/posts/smarthome-soldering-iron-pinecil-homeassistant-esphome/ Smart Soldering Iron, Got Bluetooth?]
* [https://hackaday.com/2023/01/31/all-about-usb-c-pinecil-soldering-iron How Pinecil Integrates newest USB-C protocols]
* [https://www.tomshardware.com/reviews/pinecil-v2 Tomshardware Review]
* [https://www.cnx-software.com/2022/07/29/pinecil-v2-soldering-iron-gets-bl706-bluetooth-le-risc-v-mcu-usb-pd-epr-support/ CNX Software Review]

=== Pinecil V1 Reviews ===

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

=== Pinecils in the Field ===

* [https://www.thedrive.com/the-war-zone/task-force-99-is-small-agile-and-laser-focused-on-its-own-backyard Pinecils in the field]

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T22:25:05Z

River: /* Hissing Crackle Sound */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. First, clean the tip contacts (at the white end of the cartridge) with IPA (isopropyl alcohol), heat it up a few times to 350 °C to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T22:23:25Z

River: /* Hissing Crackle Sound */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After cleaning the tip contacts with IPA, heat it up a few times to 350 °C for a couple minutes to break it in (add solder to the tip to protect it).
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T22:20:00Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Ensure the cartridge/tip is properly installed: remove the front Tip screw, check that the cartridge/tip is pushed all the way in and the round metal collar is pressed against the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here]. Reinstall the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T22:16:29Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, check that the cartridge is pushing all the way back and the larger collar is flush with the black handle [https://wiki.pine64.org/wiki/File:Pinecilv2-1.jpg see photo here], reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil Hall Effect Sensor

2023-06-18T22:13:25Z

River: /* Images */

Instructions to install a hall effect sensor (HES) on the [[Pinecil]] V1 and V2.

The Hall Effect Sensor (HES) is an optional end user installed sensor that activates to put Pinecil to sleep when it enters a holder or stand. This requires a neodymium magnet attached to the stand. The closer the HES in the Pinecil is to the magnet, the more likely the HES will activate to enter sleep mode. This adds a feature to Pinecil that is often seen in high end pro irons.

== Tools and Supplies ==
# Order a Hall Effect Sensor [https://www.lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html (SI7210-B-00 here)], also at Digikey and Mouser.
# Ordering 2-3 might be a good idea in case the first one is damaged during install (if all goes well, one could mail the extras to a friend or another Pine64 member in the community chat ;).
# Jeweler's magnifying glasses or magnifying lamp or a microscope is recommended as the [https://madpcb.com/glossary/sot-23/ SOT23] chip is very small.
# Borrow a second soldering iron (this is when 2x Pinecils is a good idea).
# Get some [https://a.co/d/0jU8zic neodymium magnets], just two 8x2.7mm at 8:00PM and 12:00PM on the stand could be enough. Experimentation is needed. Start with just one small magnet and increase the number placed around the stand until 360° sleep is activated when the Pinecil hits the stand.
# Reference [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data | Schematics are here]] (search for U14).

== Videos ==
# Easy trick to [https://www.youtube.com/watch?v=aK01V5DrrVk Open Pinecil].
# How to install [https://www.youtube.com/watch?v=vU-fhELpI8Y Hall Sensor video].

== Installation ==
# Updating to the newest firmware before installing is recommended, see the [[Pinecil#Firmware & Updates|Firmware article]]. These instructions are for 2.18 or newer firmware.
# The HES is located at the very front of the Pinecil, where the cartridge enters, see [[#Images|pcb images here]].
# Once it is soldered, cleaned, and assembled, check the sleep menu, a new hall sensitivity option appears.
# See this article on how to set up the [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md sensitivity settings] on the firmware menu (Ralim's IronOS).
# Once you change the Sleep menu > Hall sensitivity to what you like, then scroll back to the main screen in order for the setting to be saved and persist on reboot.
# Note: IronOS firmware does not flash a setting change until one scrolls out of the sub-menu back to the main screen. This is to reduce the total number of flashes done as several settings might be changed in one section (number of flashes is not unlimited; most users will not encounter the maximum allowed flashes on normal use over years).

== Hints ==
# Try not to overheat the sensor while soldering as that could damage it and even cause a leg to fall off.
# This is a small SOT23 chip. Tacking one pin on the 2-pin side helps to hold it in place before soldering the rest of the sensor.
# It is recommended to solder this with an iron with a small tip instead of using hot air (depends on your experience with hot air). See photos below, use kapton tape to protect nearby components: the 3 via holes above the 3-pin side, and the NTC temperature sensor on the other side. If too much heat is applied, it could damage the pcb, and/or affect the I2C and cause screen corruption.
# Apply generous flux to the area. If lead solder is being used, it is recommended to remove some of the existing no-lead solder that is already on the U14 pads.
# After the HES is soldered, clean the area completely with 99% isopropyl alcohol (IPA) and a soft toothbrush or small paint brush and dry before [[Pinecil:_Test,_Repair,_Issues#Assembly steps|assembly]]. Air/hair dryer could be used to blow out some of the wet IPA. Not cleaning it well enough could cause some I2C noise on the screen. Try to keep IPA/alcohol away from OLED screens.
# If the stand/holder is not metal, tape magnets near where the Pinecil enters the hole in the holder to test out good locations. Hot glue is another option.
# When closing the handle, inspect that the the seam line is fully snaped closed; avoid pressing the screen.

== Images ==
<gallery mode="packed" heights=200px>
Image:Hall-Effect-Sensor01.jpg|Before install, empty location at U14
Image:Hall-effect-sensor02.jpg|After install

File:Hall-effect-sensor01.jpg| Only needs small amount of solder
File:Hall-effect-sensor03.jpg| Kapton tape/protect the 3 Via holes above 3-pin side before soldering.
File:NTC-temp-Sensor.jpg| Kapton tape/protect the NTC sensor on opposite side of V2 (V1 does not have this)
</gallery>

== Go back to Pinecil article ==

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

[[Category:Pinecil]]

Pinecil Hall Effect Sensor

2023-06-18T22:12:35Z

River:

Instructions to install a hall effect sensor (HES) on the [[Pinecil]] V1 and V2.

The Hall Effect Sensor (HES) is an optional end user installed sensor that activates to put Pinecil to sleep when it enters a holder or stand. This requires a neodymium magnet attached to the stand. The closer the HES in the Pinecil is to the magnet, the more likely the HES will activate to enter sleep mode. This adds a feature to Pinecil that is often seen in high end pro irons.

== Tools and Supplies ==
# Order a Hall Effect Sensor [https://www.lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html (SI7210-B-00 here)], also at Digikey and Mouser.
# Ordering 2-3 might be a good idea in case the first one is damaged during install (if all goes well, one could mail the extras to a friend or another Pine64 member in the community chat ;).
# Jeweler's magnifying glasses or magnifying lamp or a microscope is recommended as the [https://madpcb.com/glossary/sot-23/ SOT23] chip is very small.
# Borrow a second soldering iron (this is when 2x Pinecils is a good idea).
# Get some [https://a.co/d/0jU8zic neodymium magnets], just two 8x2.7mm at 8:00PM and 12:00PM on the stand could be enough. Experimentation is needed. Start with just one small magnet and increase the number placed around the stand until 360° sleep is activated when the Pinecil hits the stand.
# Reference [[Pinecil:_Test,_Repair,_Issues#Schematics_and_Board_Data | Schematics are here]] (search for U14).

== Videos ==
# Easy trick to [https://www.youtube.com/watch?v=aK01V5DrrVk Open Pinecil].
# How to install [https://www.youtube.com/watch?v=vU-fhELpI8Y Hall Sensor video].

== Installation ==
# Updating to the newest firmware before installing is recommended, see the [[Pinecil#Firmware & Updates|Firmware article]]. These instructions are for 2.18 or newer firmware.
# The HES is located at the very front of the Pinecil, where the cartridge enters, see [[#Images|pcb images here]].
# Once it is soldered, cleaned, and assembled, check the sleep menu, a new hall sensitivity option appears.
# See this article on how to set up the [https://github.com/Ralim/IronOS/blob/dev/Documentation/HallSensor.md sensitivity settings] on the firmware menu (Ralim's IronOS).
# Once you change the Sleep menu > Hall sensitivity to what you like, then scroll back to the main screen in order for the setting to be saved and persist on reboot.
# Note: IronOS firmware does not flash a setting change until one scrolls out of the sub-menu back to the main screen. This is to reduce the total number of flashes done as several settings might be changed in one section (number of flashes is not unlimited; most users will not encounter the maximum allowed flashes on normal use over years).

== Hints ==
# Try not to overheat the sensor while soldering as that could damage it and even cause a leg to fall off.
# This is a small SOT23 chip. Tacking one pin on the 2-pin side helps to hold it in place before soldering the rest of the sensor.
# It is recommended to solder this with an iron with a small tip instead of using hot air (depends on your experience with hot air). See photos below, use kapton tape to protect nearby components: the 3 via holes above the 3-pin side, and the NTC temperature sensor on the other side. If too much heat is applied, it could damage the pcb, and/or affect the I2C and cause screen corruption.
# Apply generous flux to the area. If lead solder is being used, it is recommended to remove some of the existing no-lead solder that is already on the U14 pads.
# After the HES is soldered, clean the area completely with 99% isopropyl alcohol (IPA) and a soft toothbrush or small paint brush and dry before [[Pinecil:_Test,_Repair,_Issues#Assembly steps|assembly]]. Air/hair dryer could be used to blow out some of the wet IPA. Not cleaning it well enough could cause some I2C noise on the screen. Try to keep IPA/alcohol away from OLED screens.
# If the stand/holder is not metal, tape magnets near where the Pinecil enters the hole in the holder to test out good locations. Hot glue is another option.
# When closing the handle, inspect that the the seam line is fully snaped closed; avoid pressing the screen.

== Images ==
<gallery mode="packed" heights=200px>
Image:Hall-Effect-Sensor01.jpg|Before install, location at U14
Image:Hall-effect-sensor02.jpg|After install

File:Hall-effect-sensor01.jpg| Only needs small amount of solder
File:Hall-effect-sensor03.jpg| Kapton tape/protect the 3 Via holes above 3-pin side before soldering.
File:NTC-temp-Sensor.jpg| Kapton tape/protect the NTC sensor on opposite side of V2 (V1 does not have this)
</gallery>

== Go back to Pinecil article ==

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

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T22:11:40Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, check that the cartridge is pushing all the way back and the larger collar is flush with the black handle (see photo), reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T21:31:21Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], especially about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, seat the tip all the way back, reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-18T21:30:03Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Depending on your version of IronOS, the debug menu will show as HAN C or C Han. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], esp. about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, seat the tip all the way back, reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil Firmware

2023-06-06T18:56:14Z

River: /* Boot Logo Art */ add link

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try [https://github.com/pine64/blisp blisp terminal app].

'''Option 2: Blisp''', the rest of the instructions below are for [https://github.com/pine64/blisp Blisp].
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator). Inside command, move/change to the blisp folder (cd command); [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1> blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower COM number, say between COM1 to COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from [https://github.com/Ralim/IronOS-Meta IronOS Meta]. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-06-06T18:52:45Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try [https://github.com/pine64/blisp blisp terminal app].

'''Option 2: Blisp''', the rest of the instructions below are for [https://github.com/pine64/blisp Blisp].
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator). Inside command, move/change to the blisp folder (cd command); [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1> blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower COM number, say between COM1 to COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-06-06T18:51:34Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try [https://github.com/pine64/blisp blisp terminal app].

'''Option 2: Blisp''', the rest of the instructions below are for [https://github.com/pine64/blisp Blisp].
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator). Inside command, move/change to the blisp folder (cd command); [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower COM number, say between COM1 to COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Power Supplies

2023-06-04T20:04:25Z

River: /* Tool Batteries 18V-21V */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3.
* USB-C to C cables have two important ratings: one rating is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer (USB4.0 or USB2.0). Faster USB4 is 40G and slower USB2 is 480 mb/s = 0.48G. Pinecil does not need high data speed which is more useful for data transfer between devices or quality laptop to monitor connections. The lower USB2 (480mb/s) is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least minimum USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but will be a thicker cable which may make soldering and hand movement a little harder. There is a noticeable difference in the thickness of cables due to the extra wires and specs for 20G or 40G type cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

* Easy way: just get a Power Wheels adapter. They are made for different tool brands and get a DC5525 Pigtail wire.
* [https://www.amazon.com/Hobbypark-Connector-Soldering-Outdoor-Repairing/dp/B08LKY5DBX DC5525 pigtail] (keep the XT60 connector or cut it off)
* Get a Power Wheels Adapter [https://smile.amazon.com/gp/product/B09GXBJMNF like this for Ryobi], then splice/connect it to a DC5525 Pigtail to complete connection to Pinecil.
** Other kinds of [https://smile.amazon.com/stores/page/F3CF7FFA-3021-4014-AA81-E214F6F7CEDC?ingress=0&visitId=485f97ee-6a92-43e8-aaef-479873fccd6f Power-Wheels Adapters here] (Ridgid, Milwaukee, Makita, etc).
** [https://www.amazon.com/Adapter-Battery-terminals-Connector-Robotics/dp/B09GY21VXL Adapter for Ridgid batteries]
** Some people print their own 3D adapters for tool batteries (if they don't want to pay the $11-$13 for "Power Wheels" adaptor).
** Must use a 5.5mm x 2.5 mm DC barrel Plug. Forcing an an incorrect size, i.e., DC 5521 will break [https://forum.pine64.org/showthread.php?tid=13237 the connector as seen here] (if it doesn't go in, it doesn't fit).
* If you use a random DC barrel charger, first Check the Polarity of the plug to make sure it is Center Positive before using it. [https://www.youtube.com/watch?v=5DBTNplNTfA (how to check polarity)]. Using reverse polarity DC plug will destroy the Pinecil.

* To prevent battery overdrain, add this Pinecil setting which works for all the 18-21V tool batteries typical for Dewalt, etc.. Some tool brands have the overdrain protection already; it doesn't hurt to also set this in Pinecil or in case you don't know if your brand/type has it or not. <code> Power source = 5S, Minimum Voltage = 3.3V </code>
* Hint: only if you change to a different size battery do you need to alter this. If you only ever switch between a USB-C charger and the tool battery, you could just leave the 5S/3.3V setting. Overdrain means using the battery past the point where you can charge it again. Many tool batteries have internal protection to prevents this, but some brands don't have it (unfortunately, unlike most brands, Dewalt puts it into the tool & not the battery). Setting it in Pinecil is an extra safety setting in case you are not sure and want to preserve batteries.

'''Limited usability:'''

* Nintendo Switch AC Adapter USB-C (PD@15V). Does not work well on V2 (needs 3+amps). Works on V1, but slower heat speed because it's low amps and only 15V. Not all Nintendo brand chargers are USB-C type. Some have a DC barrel plug with an incorrect center pin positive, see notes/photo above for checking any DC barrel power supply before plugging it into Pinecil. Reverse polarity chargers will break electronics as they were made to only be used with specific equipment they were sold with. This is one added danger of using unknown/untested DC barrel jack charger over a USB-C charger.
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V) (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB (1.7x 4.8mm need adapter, tip is not DC5525)
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W) (tip is 1.7mmx5.5mm would need adapter for DC5525)
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Firmware

2023-06-04T19:22:45Z

River: /* Update V2: Windows */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try [https://github.com/pine64/blisp blisp terminal app].

'''Option 2: Blisp''', the rest of the instructions below are for [https://github.com/pine64/blisp Blisp].
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower COM number, say between COM1 to COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-06-01T19:06:59Z

River: /* Cartridge/Tip Problems */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Check the hidden debug menu for HAN C or C Han depending on your version of IronOS. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], esp. about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, seat the tip all the way back, reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear (white end).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil: Test, Repair, Issues

2023-05-30T22:01:12Z

River: /* Common Questions */

This article explains some common issues and fixes which includes how to dismantle, test and do some repairs.

== Cautions ==

{{warning| while opening your Pinecil will not necessarily void your warranty, all self-repairs are '''done at your own risk'''. Read everything in this section and related or linked articles to get a good idea of the procedure, and go to the Pinecil community chat if you desire advice/support from experienced volunteers. Self-repairs or modifications might void your warranty so proceed if this is not a concern. This information is for educational purposes only.}}

Pinecil V1 and V2 have slightly different schematics and have different MCU chips. Doing repairs often requires referencing the correct schematics or photos. The datasheets are also important to get information about the chips, and to order replacement parts. The schematics and known datasheets are all at the bottom of this article and linked in the contents table at the top. Chatting with other owners of Pinecil is encouraged as they have experience - already broke things so you don't have to (see Pinecil volunteer [[Pinecil#Live_Community_Chat |chat link here]]).

{{Info|This is a new work in progress (WIP) started Feb. 18, 2023 which may be updated over time as volunteers have time to write up information. For sections that are missing, try asking in the live chat as a volunteer may have some clues to get you headed in the right path.}}

== Tools needed ==

# Digital multimeter (DMM)
# Philips screwdriver
# All schematics, datasheets for known common parts, and links to where to buy replacement parts are all in this article under [[#Schematics_and_Board_Data| Schematics and board data]].
#* Refer to the correct section for V1 or V2 parts.
#* Which model do I have? The older V1 model has an all black handle with a blue silicone grip and was discontinued in July 2022. The new V2 model has a black handle with a green thumb grip and is the only model PINE64 and authorized resellers started selling after August 1, 2022.
# Magnifying lamp or jeweler's glasses with led light and good room light.
# Photos/videos will help to chat with volunteers in the [[Pinecil#Live_Community_Chat|live Pinecil chat channel]] if getting clarification or troubleshooting.
# Optional: mobile phone to take macro photos or video. A macro lens to take phone photos is helpful; there are cheap ones that simply clip on.
# Possibly another soldering iron to do the repair, some flux, solder, and isopropyl alcohol (IPA) for cleaning the PCB. See [[Pinecil_Cases,_Stands,_Supplies#Soldering_supplies| this guide]] for some basic supply options.
# Optional: better needle size probe leads for DMM makes things easier and are nice for electronic work.
# Reference photos are in the [[#Images| Images section below]].

== Dismantle steps ==

=== Easy trick to open Pinecil ===

* Video of easy trick: https://www.youtube.com/watch?v=aK01V5DrrVk

* Handle replacement [https://wiki.pine64.org/wiki/File:Pinecil_Shell_Replacement_Guide.pdf graphic]

* Step-by-step

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

== Assemble steps ==

# Place the two round buttons into the two holes in the top half of the case.
# Install the round copper ground ring at the tip end '''before installing the PCB'''.
# Place the PCB board into handle at an angle, DC barrel end goes in first.
## Lower the rest of the board into the case and align the PCB with the 2 contact screw holes.
# Install the two copper tip contacts (note the small tab on the contact and the small hole in the PCB for it).
## Orient the contact to align the alignment pin with the alignment hole next to the big hole on one of the big gold pads.
## Install and gently tighten the PH000 screw until the clip is no longer loose.
# Place the bottom half of the case into the top half by sliding the lip on the port side (side without the feet) of the bottom half under the arch of the port side of the top half.
# Gently close the case by bringing the two halves together, paying attention to each clip's alignment and ensuring the case edges align.
# Install the short PH1 screw at the bottom of the tip side of the case.
# Install the longer PH1 screw at the ground connection point at the top side of the case (between the display and the ports).
# Slide the rubber sleeve on (larger ridge first).
# Gently insert tip.
# Gently tighten the top PH1 screw to retain the tip.
{{Info| For normal operation of the iron, omission of the copper ring in step #2 does not impact operation. If you are working with ESD components, you need it in order to ground the iron tip via the earth screw at the back of the iron. It is recommended to keep this installed.}}

== FAQ ==

=== Common Fixes ===

# Sometimes, just updating to the newest firmware fixes issues as Ralim and team are very active in adding features and <s>bug fixes</s> enhancements (see [[Pinecil#Firmware_&_Updates| Firmware]]).
# Some [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting information] is also on GitHub Ralim's IronOS (which is the firmware that is on the Pinecil). There are several hidden Debug tools in the firmware that also help with diagnosis.
# Clean all new Tips (Cartridges) with 90%-99% IPA (Isopropyl Alcohol) especially the white end with the 2 silver contacts.
# If you can't find the information here or it hasn't been written yet; simply join the volunteer run [[Pinecil#Live_Community_Chat| live Pinecil chat channel]]. Sometimes you can get a clue to the right path.

=== Common Questions ===

# '''Temperature is flickering wildly''':
#* Most likely just need to clean whole cartridge/tip with IPA ([https://github.com/Ralim/IronOS/issues/1601 reference issue]). See [[#Poor_Contact_Fix|Poor Contact Fix here]].
#* If it's jumping wildly after reaching set temperature, this is also caused by using a low amp/volt charger that is below the 3amp minimum required for pinecil (per manufacturer rating), upgrading to a 3.25amp/20V USB-C charger often fixes this ([https://github.com/Ralim/IronOS/issues/1644 reference issue]).
#* Some people might see a random spike while idle. Solution: update firmware, there are some ADC timing adjustments in IronOS 2.21+; it's a good idea to keep your firmware updated to newest stable release ([https://github.com/Ralim/IronOS/issues/1485 reference issue]). This fix is included in 2.21+ release.
# '''I see No Tip connected symbol (X) randomly on new Pinecil''': tip is installed and it heats up, but randomly I get no tip symbol. See #1 above, it is most likely the same reason, dirty contacts on the back of the cartridge/tip. follow the same instructions for [[#Poor_Contact_Fix|Poor Contact Fix here]]. [https://github.com/Ralim/IronOS/issues/1601 Reference ticket on Github].
# '''How do I install the optional Hall Effect Sensor?''' See the [[Pinecil_Hall_Effect_Sensor| Hall Effect Sensor]] article for installation; location is U14 on the PCB & in the Schematics. Reference schematics section [[#Schematics_and_Board_Data| here]] also.
# '''Help, I think I bricked Pinecil doing an update''': no worries, it's very hard to brick a Pinecil because of the way the firmware is loaded in ROM. Usually just flashing again with a newer or different version brings it back to life ([[Pinecil#Firmware_&_Updates|see Firmware]]). This can be done even if you can't see your screen anymore.
# '''My Pinecil keeps rebooting''': change to a different charger or add a ground wire to your Pinecil ground screw (search for ''ts100 ground wire'' on a search engine). Also see the [[Pinecil#Power_Supplies_and_Watts|Power Supplies article]]. This could happen because of the way 2-prong no-ground chargers are made with no ground path for small current leakage. Also try to plug the charger into a surge protector strip (type that have 3-prong ground and plug the surge protector into a 3-prong grounded wall outlet). Try a different cable or flipping the cable over also.
# '''Tip is glowing red hot'''. Unplug immediately, you have most likely a blown MOSFET, check that out, replacement parts in Datasheets below. Tip is probably damaged too.
# '''My temperature display is way off and Pinecil is at room temerature''': first, check [[#Poor_Contact_Fix| poor contact fix here]]. Then enter the hidden debug menu and look for HAN C which is the internal handle temperature. This should normally be close to or slightly higher than the room temperature if the pinecil tip is also at room temperature. Under load, the HAN C can go up a bit, otherwise when the tip is cold, the HAN C should be close to ambient. Check the hidden debug menu for HAN C or C Han depending on your version of IronOS. See IronOS [https://ralim.github.io/IronOS/Troubleshooting/ Troubleshooting here], esp. about CHan and the Temperature sensor. If the reading is out of spec (very low/high), and reflowing/resoldering the Temperature sensor does not work, replacement might be needed.
# '''Screen shows X symbol''' (no tip installed) and I have a tip installed. Remove the Tip screw, seat the tip all the way back, reinstalled the screw. See [[#Tip_Problems|Tip Problems]] and [[#Poor_Contact_repair|Poor Contact repair]].
# '''I see <code>Thermal Runaway</code> or <code>Undervoltage</code> messages on the screen'''. This is often caused by using a weak power supply that does not have a minimum of 12V-3amps and is not rated to work with Pinecil. Pinecil will stop heat to the tip and display <code>Thermal Runaway</code>.
#* TL;DR get a USB-C charger 20V 3.25 amps, PD 65W (best bang for the buck for good Pinecil performance) many available between $15-$25.
#* Detailed information on chargers can be found under [[Pinecil Power Supplies]].
# '''I plugged in the wrong kind of DC barrel charger, it was a not Center-positive pin and now the Pinecil won't turn on''': see [[#Reverse_polarity_damage| Reverse polarity damage]]. Usually requires replacing the MOSFET (U13) and Buck Converter/Step-down (U8). See the datasheets for links to parts.
# '''I hear a sizzling/crackle sound from my new Pinecil''': this small noise is usually fine and may disappear after a few days of use, see [[#Hissing_Crackle_Sound| Hissing Crackle Sound]].
# '''Screen is black''': first try to update firmware. Check out the IronOS troubleshooting [https://ralim.github.io/IronOS/Troubleshooting/#no-display-or-dots-on-the-display guide here] for possible issues. See the [[#Datasheets_for_Components|datasheets here]] at the bottom of this article for links to replacement parts. Repair method would be similar to ts100 screens of which there are many guides like [https://www.youtube.com/watch?v=HlWAY0oYPFI this video]. If the tip heats up, but screen is black, the OLED may have failed/burned out. If tip does not heat up, it may be something else. Sometimes just reflow/reheat the solder for the OLED screen fixes issues. Using OLED screen at lower brightness extends the life.

== Solutions ==

=== Hissing Crackle Sound ===

# The sizzle sound will usually go away after a few days of use and heating up the iron. After wiping the tip contacts with IPA, heat it up a few times to 350 °C.
# Ralim said, "there is usually a bit of noise when you first use it, and a slight hiss/pop noise from the handle and that is normal. depends a bit on exactly what batch of caps are in your unit. The Tip drive signal is AC coupled through a capacitor for safety, downside is that it means the firmware is hitting that cap with a square wave the whole time the tip is on. Once you have heated up the duty cycle, it drops off so it's not as noticeable."
# Some members reported that after they opened their new Pinecil, wiped the PCB and tips gently with IPA, let it dry, all the sizzling noise went away. They also did a break-in of the new tips, bringing the temperature to 350 C a few times.
# Video of similar [https://www.reddit.com/r/soldering/comments/qv66a6/weird_crackling_noise_from_ts100_not_from_the_hot/ crackle sound] on the ts100 iron (don't have example of Pinecil, but it's similar sound).

=== Cartridge/Tip Problems ===

# Wipe entire tip (cartridge) clean, details in [[#Poor_Contact_test_and_repair|Poor Contact]] section
# Using a multimeter, switch it to ohms to measure resistance. Measure the two silver bands at the rear end (white).
# If it measures OL or infinity, or extremely out of the spec range below, it might be bad.
# Note, only measure when cartridge/tip is cold and unused for a couple hours (a warm tip will have much higher resistance/ohm reading).
#* Normal ts100 style tips should measure ~7.8 ohms - 8.3 ohms (when cold)
#* PINE64 brand Short tips should measure ~6.1-6.5 ohms (when cold).
#* See the [[Pinecil Tips]] for more details.

=== Poor Contact Fix ===

[[File:CleanTip-Cartridge-Contacts.jpg|none|300px|thumb| Clean contacts with IPA]]

# Most likely the tip (cartridge) is not making good contact (at the silver bands on the rear white end). Usually this issue goes away after a few days of use as the cartridge rubs against the internal contacts more. New cartridges could have factory residue on them that interferes with the R-tip reading.
# To fix this issue quicker, wipe all new tips (cartridges) with a dry towel or 90-99% IPA (isopropyl alcohol) especially the two silver contacts at the white end (do not use water to wipe as it could get into the seam line on the white end).
# With the Pinecil unplugged, remove and reinsert the tip a couple times and spin it a little inside against the contacts. Then plug it in and heat it up to 350 °C a few times for a couple minutes. These steps tend to resolve most new Pinecil or new cartridges causing flickering temperatures or "no-tip" icon displays randomly.
# Always unplug Pinecil before swapping tips. Hot swapping is not a good idea, and for the V2 this could cause strange behavior as the V2 auto-detects tip resistance only on power-up or reboot.
# Sometimes just disassembling and reassembling all parts back correctly and installing the 2 internal contacts with screws correctly also helps.
# Poor contact could happen if the tips are not clean or brand new with factory residue or not making good contact with the internal clips inside the Pinecil. The two contacts inside might need to also be removed, wiped and reinstalled with the two screws (ensure the small metal tab on the clip sits into the small hole in the PCB).
# See '''[[Pinecil_Tips#How_to_check_new_tips?| Pinecil Tips]]''' article for more details on testing.

=== Reverse Polarity Damage ===

Pinecil requires a center-positive DC power supply which most are, but some are reverse polarity and will destroy the electronics if used. If you plugged in a "center-negative" DC power supply, most likely the MOSFET and the buck converter are broken. This usually requires replacing the MOSFET (U13) and buck converter / step-down (U8). See the datasheets for links to replacement parts which is at the bottom of this article [[#Datasheets_for_Components| here]].

{{Note|1='''Check the polarity''' of the DC barrel plug before plugging in a random charger. Incorrect polarity will break the Pinecil. The [https://www.youtube.com/watch?v=5DBTNplNTfA video here] shows how to check.}}

[[File:AC adaptor polarity.png|400px]]

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

Reference the article on [[Pinecil_Power_Supplies#DC_Barrel_Power| DC barrel chargers here]], (i.e., laptop bricks) for appropriate USB-C and DC chargers that will work with the Pinecil.

== Images ==

<gallery mode="packed">
Image:PCP-Top-side-screen.jpg|Screen side: V2 on top, V1 below
Image:PCP-Bottom-Side.jpg|Pinecone side: V2 on top, V1 below
File:Pinecil v2 MOSFET.JPG | MOSFET V2 |alt=alt language
File:FUSB302-V2-02.JPG | FUSB302 V2 |alt=alt language
File:Pinecil LDOandOP-Amp.png| LDO and OP-Amp|alt=alt language
File:Under OLED screen01.png| Under the OLED screen, V2|alt=alt language
</gallery>

== Schematics and Board Data ==

=== Pinecil V2 mainboard schematic ===

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

=== Pinecil V1 mainboard schematic ===

V1 was only sold until July 2022, and then discontinued for newer V2 model

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

== Datasheets for Components ==

=== Pinecil V2 datasheets ===

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

* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], Ultra-low noise, location U5 (Replacement [https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html LP 3986-33]).

* Buck Converter: [https://datasheet.lcsc.com/lcsc/2108072230_TECH-PUBLIC-TP6841S6_C2844736.pdf TP6841S6 40V], Step-Down, location U8, (Replacement [https://www.lcsc.com/product-detail/DC-DC-Converters_TECH-PUBLIC-TP6841S6-A_C2844924.html TP6841S6-A]).

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

* Acceleration/Gyroscope: [https://lcsc.com/product-detail/Attitude-Sensor-Gyroscope_Hangzhou-Silan-Microelectronics-SC7A20TR_C5126709.html SC7A20 sensor], Silan, location U9 (replacement unknown).

* NTC Temperature Sensor: [https://media.digikey.com/pdf/Data%20Sheets/TDK%20PDFs/NTCG163JF103FTDS_Spec.pdf NTCG163JF103FTDS], location NTC1 (Replacement [https://lcsc.com/product-detail/span-style-background-color-ff0-NTC-span-Thermistors_TDK-NTCG163JF103FTDS_C435270.html NTC here]). Note that U10 is empty if NTC type thermistor is used.

* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) ]by Silicon Labs, location U14. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html Replacement Si7210-B-00-IV], also at Digikey and Mouser)

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

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

MCU: Bouffalo Labs, BL-706_QFN48, RISC-V + 2.4 GHz RF SoC
* [https://lupyuen.github.io/articles/bl706 BL706 Analysis], by Lupyuen, includes datasheet, location U15.
* [https://dev.bouffalolab.com/media/doc/702/open/datasheet/en/html/index.html BL706 datasheet]
* [https://dev.bouffalolab.com/media/doc/702/open/reference_manual/en/html/index.html BL706 Reference Manual]
* [https://github.com/bouffalolab/bl_mcu_sdk SDK and Bouffalo documents]
* [https://datasheet.lcsc.com/lcsc/1912111437_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.pdf SMD Resonator] for Bluetooth BLE, 32MHZ/12PF-10PPM, SMD2016-4P, location UX1 (Replacement [https://lcsc.com/product-detail/Crystals_TAE-Zhejiang-Abel-Elec-TAXM32M4ZFBCCT2T_C388797.html SMD Resonator]).

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

=== Pinecil V1 datasheets ===

* Buck converter: [https://files.pine64.org/doc/datasheet/pinecil/RT7272B-05.pdf RT7272B 3A Datasheet], Ricktek, Step-Down converter, location U8
* LDO Regulator: [https://datasheet.lcsc.com/lcsc/1912111437_LOWPOWER-LP3986-33B3F_C387689.pdf LP 3986-33], location U5, ([https://www.lcsc.com/product-detail/Linear-Voltage-Regulators-LDO_LOWPOWER-LP3986-33B3F_C387689.html Replacement here]).
* MOSFET Switch: [https://files.pine64.org/doc/datasheet/pinecil/Changjiang-Electronics-Tech-CJ-CJQ7328.pdf CJQ7328 8A datasheet], Chang Jiang.
** Hint: people have replaced V1 mosfet using the better rated one from the newer V2 datasheets (HSM4313 has same footprint and higher rating), see V2 section for MOSFET.
* Acceleration [https://files.pine64.org/doc/datasheet/pinecil/BMA223-Bosch.pdf Bosch BMA223 Sensor Datasheet]
* Temperature Sensor: [https://files.pine64.org/doc/datasheet/pinecil/TMP35_36_37.pdf Analog Device TMP36 Datasheet], location U10, (possible [https://www.lcsc.com/product-detail/Temperature-Sensors_Analog-Devices-TMP36GRTZ-REEL7_C129489.html replacement here]).
* Optional Hall Effect Sensor: [https://files.pine64.org/doc/datasheet/pinecil/si7210-datasheet.pdf Si7210-B-00-IV(R) by Silicon Labs, location U14]. This is a user add-on and does not come installed on the pcb.
** ([https://www.silabs.com/documents/public/application-notes/an1018-si72xx-sensors.pdf How magnets work near Hall Sensor Si7210])
** ([https://lcsc.com/product-detail/Position-Sensor_SILICON-LABS-SI7210-B-00-IVR_C2654956.html One place to buy it], also at Digikey and Mouser)
* OLED Display screen: [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: [https://files.pine64.org/doc/datasheet/pinecil/FUSB302-D.PDF FUSB302 USB PD Datasheet]
* OP Amp information: [https://files.pine64.org/doc/datasheet/pinecil/SGM8557.pdf SGMicro SGM8557-1 Low Noise OP Amp Datasheet (U11)]
* Capacitors: [https://lcsc.com/product-detail/Multilayer-Ceramic-Capacitors-MLCC-SMD-SMT_YAGEO-CC0603KRX7R9BB105_C559769.html possible replacement part for C5, 1uF/50V]
* USB-C port: possible part, has not been verified: [https://www.lcsc.com/product-detail/span-style-background-color-ff0-USB-span-Connectors_SHOU-HAN-TYPE-C-24P-QT_C2681555.html Replacement]

GigaDevice RISC-V SoC data:

* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_Datasheet_Rev%201.1.pdf GigaDevice RISC-V GD32VF103TB SoC Datasheet V1.1]
* [https://files.pine64.org/doc/datasheet/pinecil/GD32VF103_User_Manual_EN_V1.2.pdf GigaDevice RISC-V GD32VF103TB SoC Usermanual V1.2]

Breakout Board Datasheet: [https://files.pine64.org/doc/datasheet/pinecil/LP6498B6F.pdf LP6498B6F 1.2A Switching Power Regulator]

== Pinecil V1, 24V Mod ==

{{warning|Do this at your own risk, read everything in this section and related/linked articles, and go to the Pinecil community chat if you desire advice. An incorrect cut of the trace could render the Pinecil non-working.}}

[[File:Pinecil-V1andV2.png|350px|thumb|right| Pinecil V1 has blue rubber. Newer Pinecil V2 has green rubber & Bluetooth LE chip]]

# This modification is '''Not''' for the V2 (sold after Aug 1, 2022 with green thumb grip) as the V2 '''already''' has 24V DC barrel charger capability.
# If you have an older V1 model, then first upgrade to the newest [[Pinecil#Firmware_&_Updates|firmware here]] before starting this modification. The PD debug menu was added to the firmware in 2.17 and other important fixes came later. Access to the hidden PD debug menu is necessary to assist with this mod.
# See Ralim's IronOS for how to use the hidden [https://ralim.github.io/IronOS/DebugMenu/#pd-debug-menu PD Debug here] and check if your version of Pinecil V1 could benefit from the modification.
# If PD-Debug menu says "No VBUS", then stop here, you do not need the modification or any cut of the trace line, it will not benefit you because there is no connection to the VBUS already. If it says "w. Vbus" then continue. If you don't have a PD-Debug menu, then upgrade to the newest firmware first, see instructions above.
# Some models of V1 came with the PCB already capable of 24V as the Pine Store made modifications to the PCB (not all batches of V1 were the same). Do the PD debug test first to see if the mod is not required.
# See the February 2022 [https://www.pine64.org/2022/02/15/february-update-chat-with-the-machine/ Community update here]. The photo is incorrect in the article. It is ''not'' a before and after photo.
#* Photo shows two separate PCBs of Pinecil V1 made at different times; therefore, the trace is cut in a slightly different location depending on which one it looks like.
#* The PCB with 2 small via holes and is harder to cut in the correct location to avoid damaging the holes. This is called the "whalecil" in community chat (looks like a whale).

[[File:Pinecil V1 24V Mod.png|400px]]

PCB 1 style (left photo) is easier to cut the trace. Cut all the way across the trace and deep enough to cut the copper contact. PCB 2 style (right photo) is harder because the trace has to be cut without damaging the 2 via holes.

7. Don't plug in 24V until you first check with a USB-C PD charger that PD debug says '''No VBUS''' which means the mod is complete. If it still says '''W. Vbus''', then the connection still exist. Cut a little deeper and clean the cut with some IPA (isopropyl alcohol) to remove any copper dust, dry it and check again. Taking a macro photo with a phone helps to examine the cut.
If a USB-C charger is not available, often a phone with a USB-C port is a PD type, and can be used like a charger to plug in and check the PD debug messages (unfortunately, a PC port is not normally "PD" and won't give proper PD Debug).

8. If you want another set of eyes on it before you cut, post a photo of your PCB (near the Pinecone) on the Pine64 > [[Pinecil#Live_Community_Chat|live Pinecil chat channel]]. Ask for a volunteer who has ''completed'' the 24V mod on a Pinecil V1 to assist. Not all chat people own a Pinecil even if they are in the Pinecil channel.

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T22:58:39Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower COM number, say between COM1 to COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T22:56:45Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices/software that are already claiming COM ports but might not be connected presently. You can also watch pinecil V2 connect and disconnect live on Device manager to see the COM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues in windows if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible com ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T22:54:12Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil V2 is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming COM ports but might not even be connected presently. You can also watch pinecil connect and disconnect live on Device manager to see the COMM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible comm ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T22:53:23Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden devices" will show all hidden Ports(COM & LPT) even when pinecil is not connected. This may help as some unknown devices may be claiming COM ports or in conflict. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming COM ports but might not even be connected presently. You can also watch pinecil connect and disconnect live on Device manager to see the COMM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible comm ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T22:52:16Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden" Ports(COM & LPT) even when pinecil is not connected may help as some unknown devices may be claiming COM ports. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming COM ports but might not even be connected presently. You can also watch pinecil connect and disconnect live on Device manager to see the COMM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible comm ports for devices/software installed long ago.

[[File:Show-hidden.png |none|550px|left|thumb| Windows Device Manager, Show all hidden COMM Ports]]
[[File:Windows-Device-Manager.png|none|550px|left|thumb| Device manager, example Pinecil V2]]

#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

File:Show-hidden.png

2023-05-27T22:50:31Z

River: Windows Device Manager, to show hidden Ports serial COMM that Windows may have already assigned to unknown devices/software that may be causing conflicts or no longer used or needed.

== Summary ==
Windows Device Manager, to show hidden Ports serial COMM that Windows may have already assigned to unknown devices/software that may be causing conflicts or no longer used or needed.

Pinecil Firmware

2023-05-27T21:43:48Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view "hidden" Ports(COM & LPT) even when pinecil is not connected may help as some unknown devices may be claiming COM ports. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming COM ports but might not even be connected presently. You can also watch pinecil connect and disconnect live on Device manager to see the COMM it is assigned. The COM number can even be changed in Device manager by going to the Port properties, Port Settings, Advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]). You might discover several assigned invisible comm ports for devices/software installed long ago.

[[File:Windows-Device-Manager.png|none|550px|left|thumb| Windows Device Manager, Pinecil V2]]
#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

File:Windows-Device-Manager.png

2023-05-27T21:37:18Z

River: Pinecil V2 connects to Windows using Ports COMM which is different than how original older V1 connected to windows for firmware updates.

== Summary ==
Pinecil V2 connects to Windows using Ports COMM which is different than how original older V1 connected to windows for firmware updates.

Pinecil Firmware

2023-05-27T21:20:41Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> In Windows, view hidden Ports(COM & LPT) even when pinecil is not connected may help as some unknown devices may be claiming COM ports. Open Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming COM ports but might not even be connected presently. You can watch pinecil connect and disconnect from Device manager and even change the COM number in Device manager ports properties, Port Settings, Advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]).
#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Firmware

2023-05-27T19:22:06Z

River: /* Troubleshoot V2 Flashing */

This article is about updating/flashing the [[Pinecil]] firmware.

== Overview ==

{{Hint|Pinecil is designed to use '''only 1 power port''' at any time. Only the USB-C cable should be plugged in during firmware updates. Never attempt to use both rear ports at the same time or the PC and Pinecil will be damaged.}}

[[File:Pinecil-V1andV2.png|400px|thumb|right]]

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

Depending on whether you have a Pinecil V1 or V2, they are updated using different flashers since they have completely different MCU chip (brains). The V1 is any Pinecil sold up to July 2022 (has a blue thumb grip). The V2 is any Pinecil sold after Aug 1, 2022 (has a green thumb grip). If you don't have the two models mentioned, then you might not have an [[Pinecil#Authenticity|authentic Pinecil]]. This article is designed and tested on authentic Pinecils only.

* Go to the appropriate section below depending on if you have a V1 or V2 model.
* Long hold down <code>'''[-]'''</code> to see the current firmware version installed.
* It is very hard to brick a Pinecil doing a firmware update because of the firmware is in ROM. Usually, just re-flashing it fixes it. Even if the other firmware caused the screen to go black, one could connect, put the Pinecil into flash mode, and flash again to an older or newer version of firmware or a beta version.
* Pinecil V1 only uses *.hex files for both firmware and boot logo art.
* Pinecil V2 uses only *.bin files for firmware.

{{Info|Loading boot logo art onto the V2 (BL706 MCU chip) is not yet possible. Volunteers are looking into this on both GitHub Blisp and GitHub IronOS. If you would like to see the progress or help with the code see [https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 Boot Logo Art ticket]}}

== Flash Mode ==
{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

Both V1 and V2 connect to the PC/laptop and enter the Flash mode the same way for updating purposes:

# Plug one end of the USB cable to the PC/laptop.
# Long hold the <code>'''[-]'''</code> button ''before plugging'' the USB-C cable into the back of the Pinecil. Keep holding down the <code>'''[-]'''</code> for ~10-15 seconds after plugging in the cable, then release the button.
# Screen should be black/empty which means Pinecil is in Flashing Mode. If you have issues, try again, do not plug the USB-C cable into Pinecil until you first press & hold the <code>'''[-]'''</code> button. Flip the cable over or try another port/cable/PC if you still have issues.
# Unlike irons from other brands, Pinecil will '''not''' show in the PC as a USB data drive. On Windows, you will hear a single beep when connected in flash mode.
# Then use one of the flasher methods below based on the OS you have in order to flash new firmware ([[#Update_V1|older V1 instructions are lower down here]]).

== Update V2: Windows ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' GUI updater it's an all-in one app that downloads firmware and flashes.
# Download the easy premade binary installer [https://github.com/Spagett1/PineFlash for Windows here].
# If PineFlash doesn't work, then try blisp terminal app.

'''Option 2: Blisp''', the rest of the instructions below are for Blisp.
# It is a CLI (command line interface or terminal) and needs a tool like Powershell 7 which is already installed on most Windows PCs. For using BLISP only a couple basic terminal commands are needed such as <code>cd</code> to change directories (folders).
# If you prefer to use "command" terminal over Powershell, see instructions for Command in [[Pinecil_Firmware#Troubleshoot_V2_Flashing|Troubleshooting and then skip to #8 here]]
# Can install newest Powershell [https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.3 from here].
# Rick click and run Powershell as administrator.
# Enter this command <code>C:\> Set-ExecutionPolicy RemoteSigned</code> to enable powershell permissions. It only needs to be done one time and should persist on reboots.
# Check that Powershell has correct permissions,enter <code>Get-ExecutionPolicy -list</code>
# LocalMachine should be RemoteSigned.
# For V2, download the [https://github.com/pine64/blisp#how-to-update-pinecil-v2 Blisp Flasher here].
# Next download the newest firmware, [https://github.com/Ralim/IronOS/releases/ release here]. Scroll down to the bottom of the page, under Assets, get the Pinecilv2.zip.
# Right click on all zip files > properties, and check "Unblock" if present to unblock them, then extract the Blisp zip and the Pinecilv2 zip [https://github.com/builder555/PineSAM/discussions/106#discussion-4960445 screenshot of Unblock here]. If you don't see "Unblock" then keep going.
# From the Pinecilv2 folder you extracted above, copy the <code>Pinecilv2_EN.bin</code> (English) file into the Blisp folder (same place as the Blisp.exe). Other languages are available, substitute the <code>Pinecil_EN.bin</code> file for the language file desired (follow 2-letter international language code). The Pinecil Zip can now be deleted, only the single BIN file in the language you want is used.
# Run powershell as administrator.
# Now, connect the Pinecil V2 to the PC: hold down the [-] '''Before''' plugging the cable to the back of Pinecil. See ([[#Flash Mode|Flash Mode section for details]]).
# Screen on pinecil should be black/empty before proceeding; it means you are in the correct Flash mode. If you are curious, it will connect as a PORT COM device in Device Manager. If your screen is not black, then repeat the connect to PC above. If necessary, change cables or ports, or try a different PC/laptop.
# Use <code>cd</code> to change to the Blisp folder (location of blisp.exe and Pinecil_EN.bin).
#: <code>#example change to location of blisp folder</code>
#: <code>PS C:\> cd G:\Users\name\Downloads\blisp\</code>
# Execute this line (can replace the '''EN''' file name with the language bin selected).
#: <code> #Type the .\ (dot and slash) or it will fail to find the files!</code>
#: <code>.\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin</code>
# After update, unplug and reboot it, then hold down <code>'''[-]'''</code> for ~3 seconds to see the new version.
# See [[#Troubleshoot_V2_Flashing|troubleshooting]] down below if it does not flash.

== Bluetooth (BLE) Apps ==

* Must have newer Pinecil V2 model (green thumb grip).
* First, update firmware to '''Ralim's IronOS 2.21''' or higher. 2.21 is the first stable release that has BLE support built-in for Pinecil V2.
* Get the [https://github.com/builder555/PineSAM PineSAM app here] or try [https://joric.github.io/pinecil/ Joric's BLE website here]. These BLE apps are also listed in [[Pinecil#Development_Projects| Development Projects]]
* [https://joric.github.io/pinecil/ Joric's BLE API] may be the easiest to get started with as it does not require anything to be installed. It runs off Chromium based browsers (since they are capable of BLE GATT) and shows a graph of Temperature/Watts (MacOS/iPhone and firefox don't work bc they do not have BLE GATT). Hint: some Chromium browsers like Vivaldi, may need to check <code>chrome://flags/ </code> and enable bluetooth options.
* [https://github.com/builder555/PineSAM PineSAM] is BLE Settings and Menus and will run on any major OS. It allows change of all settings, and can be controlled from Mac, Linux, Windows, iPhone, Android and more; needs python script running as back end. For easy phone connection just open a browser address http://<ipaddress of PC running script>:8080/ (see PineSAM website for details)

== Update V2: Linux and Mac ==

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

'''Option 1: PineFlash''' is a GUI updater that downloads firmware and flashes. Download the easy premade binary for [https://github.com/Spagett1/PineFlash#desktop_computer-install-options Linux here].
# For MacOS, currently there is a 2-step script that will build PineFlash.
# If you have issues with Pineflash, then use Blisp below.
 

'''Option 2: Blisp Flasher''' [https://github.com/pine64/blisp#how-to-update-pinecil-v2 from here]. This is a CLI that runs in a terminal console; get the latest zip file for Linux or Mac. The main page has background info and there are instructions if you want to [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2 build it from code] instead of using the easier premade executable.
# Extract the Blisp zip, and using a terminal, <code>cd</code> to the blisp folder.
# Download the latest [https://github.com/Ralim/IronOS/releases/ stable Pinecilv2.zip release] (scroll down to the Assets section, get the Pinecilv2.zip).
# Extract the zip file and put <code>Pinecilv2_EN.bin</code> (for English) into the Blisp folder (same place as the Blisp executable). Other languages are available, substitute the *EN.bin file for the language file desired (use the 2-digit international language code). If you have the Pinecil Zip, the rest could be deleted, only the single BIN file is needed. Select the appropriate two-letter code for your language. If you accidentally flash *.dfu file on your Pinecil, it will not boot or work - be sure to only use the BIN file.
# Connect the V2 to the PC and enter Flash mode: hold down the [-] before plugging the cable to the back of Pinecil. See ([[#Flash_Mode| Flash Mode section for details]]). If you are curious on Linux, it will connect as a serial ''ttyACM'' USB ACM type device.
# Screen on pinecil should be black/empty before proceeding or you are not in Flash mode.
# '''Blisp must have executable permission set.'''
# '''<code>cd </code>''' to the Blisp folder and '''<code>ls -l</code>''' to check permissions of blisp.
# Make blisp executable: '''<code>chmod +x ./blisp</code>'''
# Then execute:

'''sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin'''

11. After a successful update, unplug and reboot it, then hold down '''<code>[-]</code>''' for ~2 seconds to see the new version.

12. See [[#Troubleshooting_V2_Flashing|troubleshooting]] down below if it does not flash.

13. To use V2 with BLE Apps, see [[#Bluetooth_(BLE)_Apps |'''BLE Bluetooth''' here]].

== Troubleshoot V2 Flashing ==

# Double check that the command is typed exactly, e.g., in Windows, the dot\slash <code> .\ </code> can not be skipped in Powershell.
# For Windows, instead of powershell, try '''command''' app (right click, run as administrator) and move into the blisp folder; [https://www3.ntu.edu.sg/home/ehchua/programming/howto/CMD_Survival.html#zz-2.1 example commands to move to folders].
# Two different samples work when Command (cmd) terminal is run as administrator. First move into the folder you have both blisp.exe and Pinecil_EN.bin. Then execute one of the following:

C:\Users\yourName\Downloads\blisp1>blisp.exe write -c bl70x --reset Pinecilv2_EN.bin
C:\Users\yourName\Downloads\blisp1> .\blisp.exe write -c bl70x --reset .\Pinecilv2_EN.bin

[[File:Win-device-manager.png|right|500px|thumb| Pinecil V2 shows as Serial COM port]]
# <li value="4"> If blisp output is "Device not found", but it shows in Windows device manager as a COM port, then it could be a failure of auto find.
#* For Linux it would be similar but use ttyACM number from dmesg and not COM.
#* Use the port argument to specify it manually. First get the COM number from device manager. These examples use COM3, but it's not always COM3 (you need to check).

.\blisp.exe write -p COM3 -c bl70x --reset .\Pinecilv2_EN.bin

.\blisp.exe write --port=COM3 --chip=bl70x --reset .\Pinecilv2_EN.bin

[[File:BlispArguments.png|none|550px|left|thumb| Blisp arguments]] </li>

# <li value="5"> To see hidden Ports(COM & LPT) even when pinecil is not connected, open the Device Manager, click View in the menu bar, and choose “Show hidden devices”. This shows devices that are already claiming com ports but might not be connected. You can watch pinecil connect and disconnect from here and even change the COM number in advanced. Some devices have issues if they are not connected as a lower range, say between COM1 and COM4 ([https://www.virtual-serial-port.org/articles/com-port-on-windows-10/ reference]).
#Often, updating issues are related to the USB cable, or the port on the PC does not support a connection to Pinecil, try:
#* flipping the cable over, different cables. Try both usb-C to C cables and also USB-C to USB-A cables (your cable may be power-only and not able to do firmware data transfers). All working usb-C to usb-C cables are designed to do at least low speed data transfer but some USB-A cables can only do power and will not work for firmware updates because they were not made to support data transfer.
#* Try other ports on the PC/laptop, or a different machine. There have been issues with some laptop USB-C ports not negotiating correctly, but the flashing worked using the USB-A port. Try a different OS if you can access one, some people who had issues on Linux for example were able to flash on Windows. Note that some virtual environments might have an issue with flashing to USB ports.
#* Don't use a hub, connect directly to a port, ports on the back of a PC may sometimes be better as they are directly connected to the motherboard. </li>
# Follow the Flash mode instructions and make sure the [-] button is held down BEFORE plugging in the cable to the back of the Pinecil. And don't release for ~10 seconds.
# If that doesn't work try holding down the <code>[-]</code> the whole time (don't let go of the button).
# Blisp flashers are from Gamiee's open source [https://github.com/pine64/blisp Blisp code here]. It is only an updater for the BL706 MCU on the Pinecil V2. It is separate from the firmware files needed which are in located in GitHub Ralim's IronOS. The firmware contains all the menus, functions, and languages, and the flasher is the tool to push the firmware onto the MCU chip (the brain). Different MCU's need different flasher tools.
# If you have issues completing the update, try joining the live [[Pinecil#Live_Community_Chat| Pinecil community chat]] to get tips from volunteers.
# If there was any special work-around you had to do to get the Blisp Flasher to work, or could not get it to work at all, post an [https://github.com/pine64/blisp/issues Issue in Github Blisp].
# If you are running Windows in a virtual machine and the process fails, make sure you have ''Microsoft Visual C++ 2015-2022'' installed.
# All firmware releases and betas are located in the GitHub [https://github.com/Ralim/IronOS Ralim's IronOS here]. If you would like to add enhancements/features to the IronOS (firmware that runs the Pinecil) or have an issue, please look at the GitHub documents or submit an issue ticket. It is recommended to read through all the GitHub [https://ralim.github.io/IronOS/ IronOS documents] first as they may have the answers. Screen menus and troubleshooting is documented as well on IronOS and maintained by volunteers.

== Build the Blisp Flasher from Code ==

# If there is a problem with the Blisp flasher, or you have a different Linux architecture like ARM, the Blisp can be built from code.
# See directions at [https://github.com/pine64/blisp/wiki/Update-Pinecil-V2#-build-blisp-flasher-from-code GitHub Blisp Wiki page].
# Blisp will only work on Pinecil V2 or devices with Bouffalo BL70x MCU chips and does not work for older Pinecil V1 that was sold before Aug. 1, 2022.

== Update V1 ==

[[File:Pinecil-V1andV2.png|400px|thumb|right]]
# Pinecil V1 uses a *.dfu file type for firmware. The newer Pinecil V2 only uses *.bin firmware type files.
# Pinecil V1 models were sold until July 2022 and then discontinued.
# Boot logo art: the same flashers used to install IronOS firmware can be used to install the art. Boot logo art will not overwrite the firmware, it resides in a separate space on the chip.

{{Note|Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil.}}

=== V1 Windows or Mac ===

# Follow these instructions on GitHub and download the easy GUI updater app [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/ Pine64 Updater].
# Install the app, and follow the screen prompts which requires connecting the Pinecil to the PC.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. Repeat the steps if needed. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# The app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# The app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.
# If multiple firmware flashing is done, the app must be closed and reopened.

=== V1 Linux or Mac ===

# Option 1 for Linux, the simple command line DFU-Util can be used per [https://ralim.github.io/IronOS/Flashing/Pinecil%20V1/#bleeding-edge-latest IronOS instructions]. Make sure to update to the newest DFU-Util to prevent issues that some members reported with older versions of DFU-util.
# Option 2 works for both Linux or Mac. Download the alternative [https://github.com/Laar3/PineFlash Pineflash GUI App] for Linux and Mac.
# Connect the Pinecil to the PC by holding down the [-] '''before''' plugging the cable into the back of Pinecil. Keep holding down the [-] button for about ~10 seconds even after plugging in the cable.
# Screen on Pinecil should be black/empty before proceeding or you are not in Flash mode. If that does not work, flip the cable, try a new cable, or port or different PC, then see the Troubleshooting section.
# PineFlash app will automatically fetch the latest stable Ralim's IronOS firmware, pick the language desired from the drop down list.
# Pineflash app also allows browsing to a local folder to install a specific beta firmware file or a boot logo that you may have downloaded or created.

== General Firmware Details ==

* Do not use the DC barrel jack while updating firmware or you may destroy your PC and Pinecil. Pinecil is designed to only use one power port at a time and never both at the same time.
* [https://ralim.github.io/IronOS/GettingStarted/ Get the beta and release firmware from GitHub with update instructions]
* To submit a feature request, or help Ralim enhance the code, create a ticket or start a discussion at [https://github.com/Ralim/IronOS/issues Ralim's IronOS]
* Ben (ralimtek) supports IronOS out of love for the IronOS creative open community. He volunteers countless hours coding, debugging, and enhancing IronOS with all the feature requests submitted.
** To give some love back, donate to IronOS; [https://ko-fi.com/ralim buy Ralim a coffee/kofi] or [https://www.paypal.com/paypalme/RalimTek donate here].
* One advantage of Pinecil (V1/V2) over other irons (i.e., Miniware) is you can not really brick them since Pinecil's bootloader is in ROM. If there is a problem, just flash the firmware again or a different version. This empowers people to experiment and do forks of the main IronOS firmware without as much risk.
* Problems with IronOS firmware? - read [https://ralim.github.io/IronOS/ documents here]. If the answer is not found, open a [https://github.com/Ralim/IronOS/issues ticket here] or join the [[#Live_Community_Chat|live Pinecil community chat]].

== Boot Logo Art ==

[[File:Boot-logo-dogbone.jpg|none|400px|thumb| dog bone by River M., pinecil v1]] [[File:PinecilV2-boot-logo-art.jpg|none|400px|thumb| animated IronOS logo, pinecil v2]]

=== Get Art ===

* Boot logo art is art that you custom make or download from IronOS Meta. It displays when you initially power on the Pinecil (boot up).
* Currently '''only''' older Pinecil V1 models which use DFU files can flash boot logo art.
* Download and extract all the premade Boot logo art from this [https://github.com/Ralim/IronOS-Meta/releases pinecil.zip file here].
* Note that for Pinecil V1, only the images with filename "dfu" will work, you can delete all other formats from the extracted zip.
* Sample images of [https://github.com/Ralim/IronOS-Meta/tree/main/Bootup%20Logos#logos-preview premade free art].
* To make custom art, [https://github.com/Ralim/IronOS-Meta follow instructions here].
* Some art is animated: the very small file size limit for boot logos prevents too many frames from being possible.
[[File:IronOS.gif]]

=== Install ===
* If you have Windows or Mac, you can use this GUI [https://github.com/pine64/pine64_updater/releases/ Pine64 flasher] (only works with V1 model).
* If you have Linux or Windows or Mac, use this GUI [https://github.com/Spagett1/PineFlash/releases/ Pineflash] (works with V1 or V2).

=== Pinecil V2 model ===

* Ralim has started work on this ([https://github.com/Ralim/IronOS/issues/1373#issuecomment-1414925011 reference]). Please watch this ticket, give Ralim support and encouragement as this is all volunteer. He is trying to change the Blisp flasher so it allows people to upload art files directly to V2 easily and without needing to do the more complex custom build of the firmware with an embedded art file.

* If you are not comfortable converting the image file into BIN and building a custom version of IronOS firmware and just want the "IronOS" animated boot logo. Then use the 2.21-animated.zip file in this link made by PowerWiesel to share with the community. Just download the zip, get the Pinecil_EN.BIN (or other language) file from it, and and update Pinecil V2 like normal.
** [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1517068391 IronOS animated logo zip here]
** Use [https://github.com/Spagett1/PineFlash#clamp-premade-binaries PineFlash app] or blisp flasher (command line).

* Custom Art: wbokslag devised a temporary work-around to convert any custom image and embed into IronOS, which is then compiled as a custom build. This is a little advanced, requires some knowledge of Github and comfort with copying code files. wbokslag wrote [https://github.com/Ralim/IronOS-Meta/issues/32#issuecomment-1505172982 detailed steps here].

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T19:03:08Z

River: /* Tool Batteries 18V-21V */ typo

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3.
* USB-C to C cables have two important ratings: one rating is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer (USB4.0 or USB2.0). Faster USB4 is 40G and slower USB2 is 480 mb/s = 0.48G. Pinecil does not need high data speed which is more useful for data transfer between devices or quality laptop to monitor connections. The lower USB2 (480mb/s) is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least minimum USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but will be a thicker cable which may make soldering and hand movement a little harder. There is a noticeable difference in the thickness of cables due to the extra wires and specs for 20G or 40G type cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

* Nintendo Switch AC Adapter USB-C (PD@15V). Does not work well on V2 (needs 3+amps). Works on V1, but slower heat speed because it's low amps and only 15V. Not all Nintendo brand chargers are USB-C type. Some have a DC barrel plug with an incorrect center pin positive, see notes/photo above for checking any DC barrel power supply before plugging it into Pinecil. Reverse polarity chargers will break electronics as they were made to only be used with specific equipment they were sold with. This is one added danger of using unknown/untested DC barrel jack charger over a USB-C charger.
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V) (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB (1.7x 4.8mm need adapter, tip is not DC5525)
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W) (tip is 1.7mmx5.5mm would need adapter for DC5525)
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T19:02:28Z

River: /* Tool Batteries 18V-21V */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3.
* USB-C to C cables have two important ratings: one rating is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer (USB4.0 or USB2.0). Faster USB4 is 40G and slower USB2 is 480 mb/s = 0.48G. Pinecil does not need high data speed which is more useful for data transfer between devices or quality laptop to monitor connections. The lower USB2 (480mb/s) is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least minimum USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but will be a thicker cable which may make soldering and hand movement a little harder. There is a noticeable difference in the thickness of cables due to the extra wires and specs for 20G or 40G type cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

* Center-Positive Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V). Does not work well on V2 (needs 3+amps). Works on V1, but slower heat speed because it's low amps and only 15V. Not all Nintendo brand chargers are USB-C type. Some have a DC barrel plug with an incorrect center pin positive, see notes/photo above for checking any DC barrel power supply before plugging it into Pinecil. Reverse polarity chargers will break electronics as they were made to only be used with specific equipment they were sold with. This is one added danger of using unknown/untested DC barrel jack charger over a USB-C charger.
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V) (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB (1.7x 4.8mm need adapter, tip is not DC5525)
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W) (tip is 1.7mmx5.5mm would need adapter for DC5525)
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T19:00:21Z

River: /* Tool Batteries 18V-21V */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3.
* USB-C to C cables have two important ratings: one rating is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer (USB4.0 or USB2.0). Faster USB4 is 40G and slower USB2 is 480 mb/s = 0.48G. Pinecil does not need high data speed which is more useful for data transfer between devices or quality laptop to monitor connections. The lower USB2 (480mb/s) is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least minimum USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but will be a thicker cable which may make soldering and hand movement a little harder. There is a noticeable difference in the thickness of cables due to the extra wires and specs for 20G or 40G type cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

* Center-Positive Nintendo Switch AC Adapter (USB-C wall-wart) (PD@15V). Does not work well on V2 (needs 3+amps). Works on V1, but slower heat speed because it's low amps and only 15V. Not all Nintendo brand chargers have a plug with center pin positive, see notes/photo above for checking any DC barrel power supply before plugging it into Pinecil as reverse polarity chargers will break electronics as they were made to only be used with specific equipment they were sold with. This is one added danger of using unknown/untested DC barrel jack charger over a USB-C charger.
* Notebook Docking Station HP Thunderbolt Dock 230W G2 (PD@20V) (had problems with lower firmware versions, but works fine Pinecil firmware: 2.15 and DockingStation firmware: 1.0.69.1)
* Smartphone Charger Samsung EP-TA20EWE (QC2@9V)
* Smartphone Charger Google Pixel G1000-US (PD@9V)
* Notebook AC Adapter Delta Electronics ADP-65JH BB (DC@19V) and ADP-90CD DB (1.7x 4.8mm need adapter, tip is not DC5525)
* Notebook AC Adapter LITEON PA-1700-02 (DC@18.5V, 65W) (tip is 1.7mmx5.5mm would need adapter for DC5525)
* Nillkin 63W USB Car Charger Quick Charge 3.0 PD (Pinecil Firmware: 2.14.2425902)
** QC3@9V/12V and PD@15V work, PD@20V doesn't
** PD@20V works fine when using PDC004-20V or ZY12PDN on dc jack (DC@20V, limit: 45W)

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T18:41:30Z

River: /* Cables, Chargers, Batteries */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3.
* USB-C to C cables have two important ratings: one rating is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer (USB4.0 or USB2.0). Faster USB4 is 40G and slower USB2 is 480 mb/s = 0.48G. Pinecil does not need high data speed which is more useful for data transfer between devices or quality laptop to monitor connections. The lower USB2 (480mb/s) is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least minimum USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but will be a thicker cable which may make soldering and hand movement a little harder. There is a noticeable difference in the thickness of cables due to the extra wires and specs for 20G or 40G type cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

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

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T18:31:47Z

River: /* Power Options for Pinecil */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3. Pinecil does not need high data speed which is more useful for data transfer and quality laptop to monitor connections. The lowest USB2 (480mb/s) data speed is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but it will be a thicker cable which may make soldering and hand movement a little harder. USB-C to C cables have two important ratings, one is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer such as USB4 (40G) or lower USB2 (480 mb/s = 0.48G). There is a noticeable difference in the thickness of cables due to the many extra wires needed for 20G or 40G cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

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

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T18:30:27Z

River: /* USB-C Cables */

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** [https://www.aliexpress.us/item/3256804967583894.html PD3.1 240W cable] (not tested yet, says it is silicone).
** The below cables have been tested to work, but are not silicone:
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], highest USB-IF data speed, 40Gbps, USB 4 Gen3. Pinecil does not need high data speed which is more useful for data transfer and quality laptop to monitor connections. The lowest USB2 (480mb/s) data speed is enough for Pinecil Firmware updates (all USB-C to C cables typically come with at least USB2 = 480mb/s data speed). Higher data speed cables work great for firmware updates, but it will be a thicker cable which may make soldering and hand movement a little harder. USB-C to C cables have two important ratings, one is for the power, e.g. 240w/48V/5amps (PD 3.1) and the other rating is not related to power at all and refers to data speed for data transfer such as USB4 (40G) or lower USB2 (480 mb/s = 0.48G). There is a noticeable difference in the thickness of cables due to the many extra wires needed for 20G or 40G cables.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

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

==== Not compatible ====

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

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

[[Category:Pinecil]]

Pinecil Power Supplies

2023-05-27T17:57:46Z

River: /* Power Options for Pinecil */ typo

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

== Power Options for Pinecil ==

=== Overview ===

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

=== Troubleshooting QC chargers ===

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

=== How to Test if my charger will work? ===

As long as you do the following you should be fine:

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

== Cables, Chargers, Batteries ==

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

=== USB-C Cables ===

* Silicone USB-C cables are recommended if possible, they are more flexible and heat resistance. They do not melt or smoke if touched briefly with an iron compared with most other cords.
* These work with USB-C 20V chargers and have been tested with Pinecil.
** [https://pine64.com/product/usb-type-c-to-usb-type-c-silicone-power-charging-cable-1-5-meter-length/ silicone, 1-cable, PINE64]
** [https://www.amazon.com/dp/B096XWD2HG/ silicone, 2-pack cables, Inter9er]
** [https://www.aliexpress.us/item/3256803495408504.html silicone, Baseus]
** [https://www.amazon.com/dp/B093GFBD2M silicone, Anker]
* EPR PD 3.1 USB-C cables (240W, 48V, 5A), needed for 28V, 140W PD3.1 chargers. Backwards compatible for all lower USB-C devices/chargers.
** There are no silicone 240W cables available yet. The below cables have been tested to work, but are not silicone.
** [https://www.amazon.com/dp/B0B18R4T14 certified 240W+Low speed data] Club 3D (slower USB 2.0 480mb/ps data speed = 0.48G speed)
** [https://www.inter9ers.com/promotions certified 240W/40Gbps], coupon $25 off, highest USB-IF data speed, 40Gbps, USB 4 Gen3
** Note: if the Amazon promo is expired, or if from the EU or another country outside the US, scroll all the way to the bottom of page, and click on PayPal to buy directly.

=== USB-C Charger ===
==== Should I get a GaN type Charger? ====

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

==== EPR PD3.1, 140W Chargers ====

# [https://www.aliexpress.us/item/3256804615629078.html Voltme 140W, 28V max]
# [https://www.aliexpress.us/item/3256804637111674.html Rocoren 140W, 28V max]
# [https://www.apple.com/shop/product/MLYU3AM/A/140w-usb-c-power-adapter Apple 140W 28V]
# [https://a.co/d/bEeltLE Anker 737 Power Bank] (only EPR battery on the market presently).

{{Info| a PD3.1 240W cable needs to be purchased if you want the full 28V performance. EPR PD3.1 chargers are backwards compatible and work for all USB-C devices. They do up to 28V on PD3.1 devices,e.g, Pinecil V2, and will do 20V and less for older USB-C devices that don't need as much power. Lower cables will also work but then the charger will only deliver a max of 20V.}}

==== PD3.0 65w 20V Chargers ====

[[File:USB C PD shared watts charger.jpg|400px|right]]

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

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

=== DC Barrel Power ===
{{Note|'''Check the polarity''' of the DC Barrel plug before plugging in a random charger or it could break the Pinecil.}}

[[File:AC adaptor polarity.png|350px]]

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

=== DC Laptop Brick ===

# Generally a center-positive laptop charger with more than 3 Amps and 19V-24V will work on Pinecil V2 ([https://www.youtube.com/watch?v=5DBTNplNTfA '''video to check polarity''']). Plugging in a DC barrel charger with the wrong polarity symbol on the back will break the Pinecil.
# '''Avoid Universal power supplies and cheap off-brand ones''' with low quality control. <tl_lim> said "try to avoid such universal power ...The output contains sharp voltage spike and can kill the Pinecil. There are already several cases reported by support team that Pinecils are damaged by such power supply."
# Read the 2 answers in [https://community.element14.com/products/manufacturers/keysight/f/forum/39013/what-is-the-effect-of-switching-noise this link] that give an idea of why using cheap DC power supplies could damage electronics due to switching noise/voltage spikes. Cheap DC bricks don't have all the extra protections needed, go through little quality control, and most have no certification stamps related to industry testing.
# DC5525 barrel plug will plug in directly (5.5mmm x 2.5mm) but if you have a different plug, there are many adapters to convert it to 5.5mm, 2.5mm (don't force a different plug into Pinecil, [https://forum.pine64.org/showthread.php?tid=13237 it will Break the barrel port]), and possibly push back and break the positive pin connection inside Pinecil where the DC barrel attaches to the PCB.
# DC barrel 24V is supported on V2 (most V1 can only do a max of 21V unless a modification is performed to cut the trace to the Vbus and enable 24V safely (see [https://github.com/Ralim/IronOS/blob/dev/Documentation/DebugMenu.md#pd-debug-menu Ralim's IronOS DebugMenu for details])
# It is recommended to use a quality brand DC barrel charger. Often a used name-brand laptop charger (Dell, HP, Toshiba, etc..) that gets some QC testing is a better option than a no-name cheap DC barrel charger. The cheap ones might have large voltage spikes that are out of the 21V range for Pinecil V1 and 24V range of Pinecil V2 causing the Mosfet and Buck regulator to break.
#* These two parts are low cost and not too hard to replace if your Pinecil breaks from a poor quality DC charger (see [[Pinecil#Datasheets_for_Components| Datasheets section of the Wiki]] for links to get replacement chips]].
#* Members have experienced broken Pinecils after using low quality off-brand DC barrel chargers and had to replace both the Mosfet and Buck Converter. Sometimes it's just one part, but it's best to order a couple of both as they are usually under $0.35 each.

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

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

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

'''Limited usability:'''

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

==== Not compatible ====

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

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

[[Category:Pinecil]]