Skip to main content
https://readthedocs.org/projects/pyhottop/badge/?version=latest https://badge.fury.io/py/pyhottop.svg

pyHottop gives you the power to control your Hottop KN-8828b-2k+ roaster directly through python code. This library is meant to be used within applications and should not be used by itself to conduct a roast. Questions, comments or for support needs, please use the issues page on Github.

Getting Started

In order to interact with your Hottop roaster, you need to ensure your model has a USB-serial port which comes standard with the KN-8828b-2k+.

  1. Install the CP210x USB driver to read from the serial port:

https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers

  1. Install the pyHotop module:

pip install pyhottop or python setup.py install

  1. Plug your Hottop roaster into your laptop.

  2. Test connectivity to the roaster by running the diagnostic utility:

pyhottop-test test

Features

This library provides full control of the Hottop roaster. Built-in callback functionality allows you to build applications that decouple the processing logic from the library from the core of your application.

  • Stream Hottop readings
    • Easy-to-use callbacks that return readings

    • Adjustable polling interval

    • Human-readable settings

    • Flexible collection of data

    • Debugging interface

  • Control the Hottop directly
    • Heater settings

    • Fan speeds

    • Drum motor toggle

    • Cooling motor toggle

    • Solenoid (drum door) toggle

    • Chaff tray (detection) reader

  • Auto-discover roaster connection
    • Loops over USB connections to find the proper serial

Changelog

2017-03-15

  • Bugfix: Capture error when validating byte sequence

2017-03-07

  • Change: Removed non-python3 dict method

  • Bugfix: Error in valid config checking

2017-02-24

  • Change: Added logic to add event code to find a valid configuration before saving

2017-02-10

  • Change: Added logic to turning point logic to avoid setting too soon

2017-12-20

  • Feature: Added a mock service to simulate a roast without being connected to a machine

2017-12-10

  • Bugfix: Removed the reset on start as it clears any properties set by the user

2017-12-06

  • Change: Keep the drum on by default to avoid any stalls

2017-12-03

  • Change: Wrap the buffer read and pull from cache if it continues to fail

  • Change: Adjusted lower bound temperature to 50

  • Feature: Reset all the roast settings when starting a roast

2017-12-02

  • Bugfix: Called the proper logging object on buffer measurement

  • Change: Added raw buffer responses to the event log

  • Feature: Added a validate routine to the buffer read to account for inaccurate responses from the roaster

  • Feature: Automatically derive charge and turning point events based on temperature data

2017-12-01

  • Bugfix: Turned drum motor on when doing a cool-down to push beans out

2017-11-29

  • Bugfix: Replaced existing extenal_temp with environment_temp

  • Bugfix: Fixed issue with buffer retry loop where it was not being called

  • Change: Adjusted default interval to 1 second to avoid buffer issues

  • Change: Toggle serial connection if having trouble reading buffer

2017-11-28

  • Change: Adjusted duration to be of format MM:SS instead of total seconds

  • Change: Return roast state when toggling monitoring

2017-11-24

  • Feature: several new methods for getting additional roast details

  • Change: Refactored code related to tracking roast properties and timing

  • Change: Updated documentation within the code

  • Bugfix: when running with python3 due to queue library

Release files for pyhottop 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyhottop 0.2.6
File Size Uploaded
pyhottop-0.2.6.tar.gz 28.5 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for pyhottop 0.2.6
File Interpreter ABI Platform
pyhottop-0.2.6-py3.6.egg Legacy Egg format - - Details
pyhottop-0.2.6-py2-none-any.whl Python 2 none any Details

Total release size: 116.2 kB

Release files / pyhottop-0.2.6.tar.gz

Download URL pyhottop-0.2.6.tar.gz
Size 28.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3abb46ffd362c468ff1967a2f712ecfbc09e6fdf90a45743df1e49a20d7466ad
BLAKE2b-256 checksum
How to use checksums
d3b6c30f528b58dd8b625888d2b96b3100086640b3122170e3b09b262aea2c37
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pyhottop-0.2.6-py3.6.egg

Download URL pyhottop-0.2.6-py3.6.egg
Size 58.0 kB
Tags Egg
SHA-256 checksum
How to use checksums
f17f227834040466e9cd225dfebed0c7543d2d3c5770b0ca01bc7ca69a0d3339
BLAKE2b-256 checksum
How to use checksums
8f2960b6f251b38bc01fd4265287f9e2a73e269299bca0a00f13ccca995ff8f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pyhottop-0.2.6-py2-none-any.whl

Download URL pyhottop-0.2.6-py2-none-any.whl
Size 29.7 kB
Tags Python 2
SHA-256 checksum
How to use checksums
c24a6e7749c85387f6d63925309a624edde74b738cc9b6c779b22ed7a2fb2dbd
BLAKE2b-256 checksum
How to use checksums
7849686807312baf52d79c6c3a3d314798867ceee32094449f4807671e7a094a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.6 This release

3 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

1 release file

0.2.1

1 release file

0.2.0

4 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

4 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page