Repository files navigation

A customHome Assistant integration to connect and control theStorz & Bickel Volcano Hybrid Vaporizer viaBluetooth. This integration enables precise control over the vaporizer's heat and pump functions, real-time monitoring of temperature, and seamless automation into the Home Assistant scripting and automation systems.

🚀Volcano Integration is now published in the HACS Default Store!
If you previously added it as a custom repository, you can remove that entry underHACS → Integrations → ⋮ → Custom Repositories to avoid duplicates.

One of the main features of the official Volcano app includes workflows; these are the real-time Bluetooth instructions usually sent from your mobile device to the vaporizer when using it. But, because these instructions are sent in real-time, it means that closing or sometimes even minimizing the app actually stops the workflow prematurely. This integration fixes that by using Home Assistant as the Bluetooth client instead of your mobile device; the connection is persistent and asynchronous. This allows us to utilize Home Assistant scripts and automations in the same way we would create a workflow.

Home Assistant WebUI - Volcano Device Page

The default workflow in the official app is as follows:

- Turn heat on.- Set temperature to 170C.- Wait until temperature reaches target.- Turn on pump for 5 seconds.- Set heat to 175C.- Wait until temperature reaches target.- Turn on pump for 5 seconds. Set heat to 180C.- Wait until temperature reaches target. Turn on pump for 5 seconds.- Repeats until temperature reaches 200C.

To translate this into a Home Assistant script:

alias: Volcano Workflow 1sequence:  - action: volcano_integration.connect    data:      wait_until_connected: true  - action: volcano_integration.heat_on    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 170      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 175      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 180      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 185      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 190      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      hours: 0      minutes: 0      seconds: 5      milliseconds: 0  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 195      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.set_temperature    data:      temperature: 200      wait_until_reached: true  - action: volcano_integration.pump_on    data: {}  - delay:      seconds: 5  - action: volcano_integration.pump_off    data: {}  - action: volcano_integration.heat_off    data: {}description: "A full workflow from 170C to 200C, with 5 second pumps between every 5C."mode: restart

I also strongly recommend creating another script, which allows you to stop any Volcano workflow at will. It should also turn the heat and pump off:

alias: Volcano Stop All Scriptssequence:  - action: volcano_integration.heat_off  - action: volcano_integration.pump_off  - action: script.turn_off    target:      entity_id:        - script.volcano_workflow_1description: "Stops all Volcano scripts and turns off the heat/pump."mode: restart

Now you're set to create your own scripts and automations for the Volcano Vaporizer.

⚠️ WARNING: For safety reasons, do not leave your Volcano Vaporizer running while unattended. This is an experimental integration, subject to changes in functionality at any time, and should not be considered reliable. The Volcano poses a fire hazard and must be used with caution.

• Temperature Control: Set the heater temperature between 40°C and 230°C with 1°C precision.
• Pump Control: Turn the pumpON orOFF to start or stop air circulation.
• Heat Control: Turn the heaterON orOFF.
• LED Brightness Control: Adjust the LED brightness between 0% and 100%.
• Auto Shutoff Setting: Configure how long until the Volcano automatically turns off, in minutes.
• Real-Time Temperature Monitoring: Monitor the current heater temperature in real time.
• Bluetooth Status: View the current Bluetooth connection status (Connected, Disconnected, etc.).
• Firmware and Serial Information: Access BLE firmware version, device firmware version, and serial number.
• Operational Hours Monitoring: Track hours and minutes of operation.
• Connection Control: Manage Bluetooth connection via a dedicated service.
• Full Automation Support: Automate heat, pump, LED brightness, auto shutoff setting, and connection logic using Home Assistant scripts or automations.
• User-Friendly Services: Use built-in Home Assistant services to control various aspects of the vaporizer (temperature, brightness, auto shutoff setting, etc.).

• Bluetooth Hardware: The host system must have Bluetooth hardware or a compatible USB Bluetooth adapter.
• Python Dependency: Requires thebleak library (>= 0.20.0).

1. Prerequisites

   • Ensure you haveHACS installed in your Home Assistant.

2. Install the Integration

   • In Home Assistant, go toHACS → Integrations.
   • Click the“+” button and search forVolcano Integration.
   • ClickInstall.

4. Restart Home Assistant

   • After installation completes, restart Home Assistant to activate the integration.

5. Configure the Integration

   • Navigate toSettings → Devices & Services, clickAdd Integration, and selectVolcano Integration.
   • Follow the on-screen prompts to scan for Bluetooth devices and pick your Volcano Vaporizer.

1. Download the Integration

   • Clone or download from GitHub:
     https://github.com/Chuffnugget/volcano_integration

2. Place in Custom Components

   • Copy thevolcano_integration folder into your Home Assistant’scustom_components/ directory.

3. Restart Home Assistant

   • Restart Home Assistant so it picks up the new component.

4. Add & Configure

   • Go toSettings → Devices & Services → Add Integration, chooseVolcano Integration, and complete setup.

• Sensors

  • Current Temperature: Displays the current temperature of the vaporizer.
  • Heat Status: Shows whether the heater isON,OFF, or in an unknown state.
  • Pump Status: Indicates if the pump isON,OFF, or in an unknown state.
  • Bluetooth Status: Displays the current Bluetooth connection status.
  • BLE Firmware Version: Shows the BLE firmware version of the device.
  • Serial Number: Displays the device's serial number.
  • Firmware Version: Shows the device's firmware version.
  • LED Brightness: Displays the current LED brightness level.
  • Hours of Operation: Tracks the total hours the device has been in operation.
  • Minutes of Operation: Tracks the total minutes the device has been in operation.

• Numbers

  • Heater Temperature Setpoint: Allows setting the desired temperature between 40°C and 230°C.
  • LED Brightness: Adjusts the LED brightness between 0% and 100%.
  • Auto Shutoff Setting: Sets the auto shutoff duration in minutes (e.g., 30–360).

• volcano_integration.connect
  Connect to the vaporizer.

  • Parameters
    • wait_until_connected (optional, default: true): Whether to block until the device is fully connected.

• volcano_integration.disconnect
  Disconnect from the vaporizer.

• volcano_integration.set_temperature
  Set the heater temperature.

  • Parameters
    • temperature (required): The target temperature in °C (40–230).
    • wait_until_reached (required, default: true): Whether to block until the target temperature is reached.

• volcano_integration.set_led_brightness
  Set the LED brightness.

  • Parameters
    • brightness (required): The LED brightness percentage (0–100).

• volcano_integration.set_auto_shutoff_setting
  Set the auto shutoff time in minutes.

  • Parameters
    • minutes (required): The duration in minutes before auto shutoff is triggered (e.g., 30–360).

• Bluetooth Adapter
  Ensure your system recognizes and can use the Bluetooth adapter. If the adapter isn’t detected, the integration won’t be able to connect.

• Proximity
  Keep the Volcano within a reasonable range of the Bluetooth adapter to prevent connectivity issues.

• Logs
  Check Home Assistant’s logs for debug messages. Increasing the log level forcustom_components.volcano_integration can help diagnose connection problems.

All contributions, including bug reports, new features, and documentation improvements are welcome. Please file issues on GitHub and/or submit PRs with your proposed changes.

Enjoy creating your own custom workflows and happy vaping!