Skip to main content

Interface for interacting with Hottop KN-8828b-2k+ roasters

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyhottop-0.2.6.tar.gz (28.5 kB view details)

Uploaded Source

Built Distributions

pyhottop-0.2.6-py3.6.egg (58.0 kB view details)

Uploaded Egg

pyhottop-0.2.6-py2-none-any.whl (29.7 kB view details)

Uploaded Python 2

File details

Details for the file pyhottop-0.2.6.tar.gz.

File metadata

  • Download URL: pyhottop-0.2.6.tar.gz
  • Upload date:
  • Size: 28.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyhottop-0.2.6.tar.gz
Algorithm Hash digest
SHA256 3abb46ffd362c468ff1967a2f712ecfbc09e6fdf90a45743df1e49a20d7466ad
MD5 e357612072049a5c560235e5dbdc6d82
BLAKE2b-256 d3b6c30f528b58dd8b625888d2b96b3100086640b3122170e3b09b262aea2c37

See more details on using hashes here.

File details

Details for the file pyhottop-0.2.6-py3.6.egg.

File metadata

  • Download URL: pyhottop-0.2.6-py3.6.egg
  • Upload date:
  • Size: 58.0 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyhottop-0.2.6-py3.6.egg
Algorithm Hash digest
SHA256 f17f227834040466e9cd225dfebed0c7543d2d3c5770b0ca01bc7ca69a0d3339
MD5 78da62f853c045a8da6ec1083f5ec934
BLAKE2b-256 8f2960b6f251b38bc01fd4265287f9e2a73e269299bca0a00f13ccca995ff8f6

See more details on using hashes here.

File details

Details for the file pyhottop-0.2.6-py2-none-any.whl.

File metadata

File hashes

Hashes for pyhottop-0.2.6-py2-none-any.whl
Algorithm Hash digest
SHA256 c24a6e7749c85387f6d63925309a624edde74b738cc9b6c779b22ed7a2fb2dbd
MD5 1cf847e3a78f6e12c3763d3f49a693cc
BLAKE2b-256 7849686807312baf52d79c6c3a3d314798867ceee32094449f4807671e7a094a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page