PineSAM = (pinecil settings and menus)

Why focus on soldering when you can play with the settings instead? With this app you will have full control over your new shiny Pinecil V2 from your computer using bluetooth.

NB: No special browser permissions required

NB: This app needs the python backend to run on a computer, it CANNOT run entirely in the browser unlike Joric's UI.

• Automatically detect Pinecil V2 over BLE
• Get all setting values
• Modify settings
• Adjust temperature ranges based on C/F selection
• Hide Minimum Voltage (per cell) when source is DC
• Validate setting values before sending to device

• python 3 (tested with 3.10)
• pipenv
• a browser

git clone https://github.com/builder555/PineSAM
cd PineSAM/backend
pipenv install
chmod +x start.sh

# from inside the PineSAM/backend directory:
./start.sh

On a Mac http://localhost:8080/settings.html will open in your browser automatically. On linux you need to do it manually (for now).

For Debian 12 instructions, see this post (thanks @scythefwd)

If you already have python installed, you can skip to step 2.

1. Install Python: https://www.python.org/downloads
   • Check "Add python.exe to PATH" and select "Customize Installation"
   • Check "Add Python to environment variables" option
   • See a reference screen here Thanks to River-b
2. Download this repo: https://github.com/builder555/PineSAM/archive/master.zip
3. Unzip it
4. Run start.bat file inside the backend directory

You can access the settings remotely once the app is running

• Find the local IP address of the device running the app
• open http://<ip-address>:8080/settings.html on another device on the same network

• bleak causes Python to crash on Mac: hbldh/bleak#768
  • possible solution: give access to iTerm (or whichever terminal you use) to Bluetooth in Settings
• Pinecil not detected
  • possible solution: need to flash BLE firmware
• Setting change is not reflected on the soldering iron
  • some changes require entering the menu on the device itself (or power cycle after saving to flash) before appearing. Example

Make sure you have pipenv installed.

# run inside 'backend' directory:
pipenv install --dev
pipenv run test

• Pinecil - The Pinecil Wiki page
• IronOS - The OS running on this soldering iron
• Pinecil Web UI - A neat web-based UI, requires bluetooth browser support
• Pinecil Authenticity Checker - Almost all AliExpress Pinecils are fake, check your V2!