| Name | hcli-hak11 JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | None |
| Summary | HCLI hak11 is a python package wrapper that contains an HCLI sample application (hak11); hak11 is intended to run on a rapsberry pi setup to trigger relays via GPIO. 12 GPIO triggered relays are intended to be setup to interact with a Linear AK-11 keypad to enable remote administration. |
| upload_time | 2024-09-25 01:53:56 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | None |
| license | MIT |
| keywords |
cli
client
server
connector
hypermedia
rest
generic
development
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
gpiozero
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
|pypi| |build status| |pyver|
HCLI hak11
==========
HCLI hak11 is a python package wrapper that contains an HCLI sample application (hak11); hak11 is intended to run on a rapsberry pi setup to trigger relays via GPIO. 12 GPIO triggered relays are intended to be setup to interact with a Linear AK-11 keypad to enable remote administration.
----
HCLI hak11 wraps hak11 (an HCLI) and is intended to be used with an HCLI Client [1] as presented via an HCLI Connector [2].
You can find out more about HCLI on hcli.io [3]
[1] https://github.com/cometaj2/huckle
[2] https://github.com/cometaj2/hcli_core
[3] http://hcli.io
Installation
------------
HCLI hak11 requires a supported version of Python and pip.
You'll need an HCLI Connector to run hak11. For example, you can use HCLI Core (https://github.com/cometaj2/hcli_core), a WSGI server such as Green Unicorn (https://gunicorn.org/), and an HCLI Client like Huckle (https://github.com/cometaj2/huckle).
.. code-block:: console
pip install hcli-hak11
pip install hcli-core
pip install huckle
pip install gunicorn
gunicorn --workers=1 --threads=1 -b 0.0.0.0:8000 "hcli_core:connector(\"`hcli_hak11 path`\")"
Usage
-----
Open a different shell window.
Setup the huckle env eval in your .bash_profile (or other bash configuration) to avoid having to execute eval everytime you want to invoke HCLIs by name (e.g. hc).
Note that no CLI is actually installed by Huckle. Huckle reads the HCLI semantics exposed by the API via HCLI Connector and ends up behaving *like* the CLI it targets.
.. code-block:: console
huckle cli install http://127.0.0.1:8000
eval $(huckle env)
hak11 help
Versioning
----------
This project makes use of semantic versioning (http://semver.org) and may make use of the "devx",
"prealphax", "alphax" "betax", and "rcx" extensions where x is a number (e.g. 0.3.0-prealpha1)
on github.
Supports
--------
- Interacting with raspberry pi GPIO setup to trigger a properly configured relay connected to a Linear AK-11 keypad's 7 circuit pins.
Materials Used
--------------
* Raspberry pi zero with 40pin header & wifi
* SainSmart 16-Channel 12V Relay Module Board for Arduino DSP AVR PIC ARM
* ELEGOO 120pcs Multicolored Dupont Wire 40pin Male to Female, 40pin Male to Male, 40pin Female to Female Breadboard Jumper Ribbon Cables Kit Compatible with Arduino Projects
* Dupont 2.54mm Wire Female to Female Dupont Connector & 22AWG Pre-Crimped Cable, Single Row
* 18 AWG Wire Electrical Wires 18 Gauge Tinned Copper Wire, PVC (OD: 1.85 mm) 6 Different Colored 16.4ft / 5m Each,Stranded Wire Hookup Wires for DIY DC/AC
* 2.54mm Male Pin Header Single Row DIP Connector Kit，1 * 2/3/4/5/6/7/8/9/10/12Pin Straight Header Pin Breakaway PCB Board Pin Header Strip for Prototype Shield (Male-Pin-Single)
* GKEEMARS 50 Pcs Wire Connector, 1 Conductor Compact Wire Connectors Splicing Connectors for Circuit Inline 24-12 AWG (Orange)
AK-11 Circuit
-------------
The AK-11 keypad uses a matrix circuit design.
Each button connects a unique combination of row and column pins when pressed.
The circuit remains open until a button is pressed, closing the circuit for that specific pin combination.
* Digit 1, Pins 2,3
* Digit 2, Pins 3,4
* Digit 3, Pins 3,5
* Digit 4, Pins 2,6
* Digit 5, Pins 4,6
* Digit 6, Pins 5,6
* Digit 7, Pins 2,7
* Digit 8, Pins 4,7
* Digit 9, Pins 5,7
* Digit \*, Pins 1,2
* Digit 0, Pins 1,4
* Digit #, Pins 1,5
Relay Function
--------------
When activated, a relay closes the circuit between two specific pins of the keypad's 7 pins. This is accomplished by setting up a simple demultiplexer that links each relay circuit close to 2 unique output wires corresponding to the correct 2 pins of the digipad circuitboard.
Demultiplexing Strategy
-----------------------
The relay board correlates the necessary pin combinations for each digit, just as the keypad's internal circuitry does, to emulate digit presses as triggered via GPIO from the raspberry pi.
Pin correlation (both at the keypad and at the relays):
* Pin 1, 3 connections: "\*0#", Red
* Pin 2, 4 connections: "147\*", Black
* Pin 3, 3 connections: "123", Yellow
* Pin 4, 4 connections: "2580", White
* Pin 5, 4 connections: "369#", Blue
* Pin 6, 3 connections: "456", Teal
* Pin 7, 3 connections: "789", Orange
Relay Configuration
-------------------
By convention, and for simplicity's sake, the relays are setup such that they numerically align to digits.
* Relay 1, Digit 1
* Relay 2, Digit 2
* Relay 3, Digit 3
* Relay 4, Digit 4
* Relay 5, Digit 5
* Relay 6, Digit 6
* Relay 7, Digit 7
* Relay 8, Digit 8
* Relay 9, Digit 9
* Relay 10, Digit \*
* Relay 11, Digit 0
* Relay 12, Digit #
GPIO 40 pin Schema
------------------
Also by convention, we follow a path of least relay connectivity complexity for a wire ribon relative to both the 40 pin raspberry pi header and the relay's pin header.
Looking at a diagram of a raspberry pi zero's 40 pin header, we assume pin 1 in a top left position and
we connect the relays in the convention order from top to bottom, starting from the top left, and then briefly back up on the right from the bottom.
5v power is connected to the 5v power pins on the relay board (SainSmart 16-Channel 12V Relay Module Board for Arduino DSP AVR PIC ARM) so that the raspberry pi zero can be powered by the relay's 5v output.
* 5v (2), Relay 5v
* 5v (4), Relay 5v
* GPIO2, Relay 1
* GPIO3, Relay 2
* GPIO4, Relay 3
* GPIO17, Relay 4
* GPIO27, Relay 5
* GPIO22, Relay 6
* GPIO10, Relay 7
* GPIO9, Relay 8
* GPIO11, Relay 9
* GPIO5, Relay 10
* GPIO6, Relay 11
* GPIO13, Relay 12
* GPIO19, Relay 13 (unused)
* GPIO26, Relay 14 (unused)
* GPIO21, Relay 15 (unused)
* GPIO20, Relay 16 (unused)
* Ground (34), Relay Ground
* Ground (30), Relay Ground
To Do
-----
- TBD
Bugs
----
- TBD
.. |build status| image:: https://circleci.com/gh/cometaj2/hcli_hak11.svg?style=shield
:target: https://circleci.com/gh/cometaj2/hcli_hak11
.. |pypi| image:: https://img.shields.io/pypi/v/hcli-hak11?label=hcli-hak11
:target: https://pypi.org/project/hcli-hak11
.. |pyver| image:: https://img.shields.io/pypi/pyversions/hcli-hak11.svg
:target: https://pypi.org/project/hcli-hak11
Raw data
{
"_id": null,
"home_page": null,
"name": "hcli-hak11",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "cli, client, server, connector, hypermedia, rest, generic, development",
"author": null,
"author_email": "Jeff Michaud <cometaj2@comcast.net>",
"download_url": "https://files.pythonhosted.org/packages/98/19/a6cf423e6b590a8d9520867d3096e25ef21c2fce1973ccaf77ddfec141ae/hcli_hak11-0.1.2.tar.gz",
"platform": null,
"description": "|pypi| |build status| |pyver|\n\nHCLI hak11\n==========\n\nHCLI hak11 is a python package wrapper that contains an HCLI sample application (hak11); hak11 is intended to run on a rapsberry pi setup to trigger relays via GPIO. 12 GPIO triggered relays are intended to be setup to interact with a Linear AK-11 keypad to enable remote administration.\n\n----\n\nHCLI hak11 wraps hak11 (an HCLI) and is intended to be used with an HCLI Client [1] as presented via an HCLI Connector [2].\n\nYou can find out more about HCLI on hcli.io [3]\n\n[1] https://github.com/cometaj2/huckle\n\n[2] https://github.com/cometaj2/hcli_core\n\n[3] http://hcli.io\n\nInstallation\n------------\n\nHCLI hak11 requires a supported version of Python and pip.\n\nYou'll need an HCLI Connector to run hak11. For example, you can use HCLI Core (https://github.com/cometaj2/hcli_core), a WSGI server such as Green Unicorn (https://gunicorn.org/), and an HCLI Client like Huckle (https://github.com/cometaj2/huckle).\n\n\n.. code-block:: console\n\n pip install hcli-hak11\n pip install hcli-core\n pip install huckle\n pip install gunicorn\n gunicorn --workers=1 --threads=1 -b 0.0.0.0:8000 \"hcli_core:connector(\\\"`hcli_hak11 path`\\\")\"\n\nUsage\n-----\n\nOpen a different shell window.\n\nSetup the huckle env eval in your .bash_profile (or other bash configuration) to avoid having to execute eval everytime you want to invoke HCLIs by name (e.g. hc).\n\nNote that no CLI is actually installed by Huckle. Huckle reads the HCLI semantics exposed by the API via HCLI Connector and ends up behaving *like* the CLI it targets.\n\n\n.. code-block:: console\n\n huckle cli install http://127.0.0.1:8000\n eval $(huckle env)\n hak11 help\n\nVersioning\n----------\n \nThis project makes use of semantic versioning (http://semver.org) and may make use of the \"devx\",\n\"prealphax\", \"alphax\" \"betax\", and \"rcx\" extensions where x is a number (e.g. 0.3.0-prealpha1)\non github.\n\nSupports\n--------\n\n- Interacting with raspberry pi GPIO setup to trigger a properly configured relay connected to a Linear AK-11 keypad's 7 circuit pins.\n\nMaterials Used\n--------------\n\n* Raspberry pi zero with 40pin header & wifi\n* SainSmart 16-Channel 12V Relay Module Board for Arduino DSP AVR PIC ARM\n* ELEGOO 120pcs Multicolored Dupont Wire 40pin Male to Female, 40pin Male to Male, 40pin Female to Female Breadboard Jumper Ribbon Cables Kit Compatible with Arduino Projects\n* Dupont 2.54mm Wire Female to Female Dupont Connector & 22AWG Pre-Crimped Cable, Single Row\n* 18 AWG Wire Electrical Wires 18 Gauge Tinned Copper Wire, PVC (OD: 1.85 mm) 6 Different Colored 16.4ft / 5m Each,Stranded Wire Hookup Wires for DIY DC/AC\n* 2.54mm Male Pin Header Single Row DIP Connector Kit\uff0c1 * 2/3/4/5/6/7/8/9/10/12Pin Straight Header Pin Breakaway PCB Board Pin Header Strip for Prototype Shield (Male-Pin-Single)\n* GKEEMARS 50 Pcs Wire Connector, 1 Conductor Compact Wire Connectors Splicing Connectors for Circuit Inline 24-12 AWG (Orange)\n\nAK-11 Circuit\n-------------\n\nThe AK-11 keypad uses a matrix circuit design.\n\nEach button connects a unique combination of row and column pins when pressed.\nThe circuit remains open until a button is pressed, closing the circuit for that specific pin combination.\n\n* Digit 1, Pins 2,3\n* Digit 2, Pins 3,4\n* Digit 3, Pins 3,5\n* Digit 4, Pins 2,6\n* Digit 5, Pins 4,6\n* Digit 6, Pins 5,6\n* Digit 7, Pins 2,7\n* Digit 8, Pins 4,7\n* Digit 9, Pins 5,7\n* Digit \\*, Pins 1,2\n* Digit 0, Pins 1,4\n* Digit #, Pins 1,5\n\nRelay Function\n--------------\n\nWhen activated, a relay closes the circuit between two specific pins of the keypad's 7 pins. This is accomplished by setting up a simple demultiplexer that links each relay circuit close to 2 unique output wires corresponding to the correct 2 pins of the digipad circuitboard.\n\nDemultiplexing Strategy\n-----------------------\n\nThe relay board correlates the necessary pin combinations for each digit, just as the keypad's internal circuitry does, to emulate digit presses as triggered via GPIO from the raspberry pi.\n\nPin correlation (both at the keypad and at the relays):\n\n* Pin 1, 3 connections: \"\\*0#\", Red\n* Pin 2, 4 connections: \"147\\*\", Black\n* Pin 3, 3 connections: \"123\", Yellow\n* Pin 4, 4 connections: \"2580\", White\n* Pin 5, 4 connections: \"369#\", Blue\n* Pin 6, 3 connections: \"456\", Teal\n* Pin 7, 3 connections: \"789\", Orange\n\nRelay Configuration\n-------------------\n\nBy convention, and for simplicity's sake, the relays are setup such that they numerically align to digits.\n\n* Relay 1, Digit 1\n* Relay 2, Digit 2\n* Relay 3, Digit 3\n* Relay 4, Digit 4\n* Relay 5, Digit 5\n* Relay 6, Digit 6\n* Relay 7, Digit 7\n* Relay 8, Digit 8\n* Relay 9, Digit 9\n* Relay 10, Digit \\*\n* Relay 11, Digit 0\n* Relay 12, Digit #\n\nGPIO 40 pin Schema\n------------------\n\nAlso by convention, we follow a path of least relay connectivity complexity for a wire ribon relative to both the 40 pin raspberry pi header and the relay's pin header.\n\nLooking at a diagram of a raspberry pi zero's 40 pin header, we assume pin 1 in a top left position and\nwe connect the relays in the convention order from top to bottom, starting from the top left, and then briefly back up on the right from the bottom.\n\n5v power is connected to the 5v power pins on the relay board (SainSmart 16-Channel 12V Relay Module Board for Arduino DSP AVR PIC ARM) so that the raspberry pi zero can be powered by the relay's 5v output.\n\n* 5v (2), Relay 5v\n* 5v (4), Relay 5v\n* GPIO2, Relay 1\n* GPIO3, Relay 2\n* GPIO4, Relay 3\n* GPIO17, Relay 4\n* GPIO27, Relay 5\n* GPIO22, Relay 6\n* GPIO10, Relay 7\n* GPIO9, Relay 8\n* GPIO11, Relay 9\n* GPIO5, Relay 10\n* GPIO6, Relay 11\n* GPIO13, Relay 12\n* GPIO19, Relay 13 (unused)\n* GPIO26, Relay 14 (unused)\n* GPIO21, Relay 15 (unused)\n* GPIO20, Relay 16 (unused)\n* Ground (34), Relay Ground\n* Ground (30), Relay Ground\n\nTo Do\n-----\n\n- TBD\n\nBugs\n----\n\n- TBD\n\n.. |build status| image:: https://circleci.com/gh/cometaj2/hcli_hak11.svg?style=shield\n :target: https://circleci.com/gh/cometaj2/hcli_hak11\n.. |pypi| image:: https://img.shields.io/pypi/v/hcli-hak11?label=hcli-hak11\n :target: https://pypi.org/project/hcli-hak11\n.. |pyver| image:: https://img.shields.io/pypi/pyversions/hcli-hak11.svg\n :target: https://pypi.org/project/hcli-hak11\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "HCLI hak11 is a python package wrapper that contains an HCLI sample application (hak11); hak11 is intended to run on a rapsberry pi setup to trigger relays via GPIO. 12 GPIO triggered relays are intended to be setup to interact with a Linear AK-11 keypad to enable remote administration.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/cometaj2/hcli_hak11"
},
"split_keywords": [
"cli",
" client",
" server",
" connector",
" hypermedia",
" rest",
" generic",
" development"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d635b8473311701e810e8adb9d466eae0d8244842317fbc028daba049a82020e",
"md5": "3e2a4c52a8b08554eafced61ebf4814f",
"sha256": "3fa5dfa35694fe44ca354b0e64b3cf3740f35c473fa8bd66587ca11e4a9ee450"
},
"downloads": -1,
"filename": "hcli_hak11-0.1.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "3e2a4c52a8b08554eafced61ebf4814f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 13452,
"upload_time": "2024-09-25T01:53:54",
"upload_time_iso_8601": "2024-09-25T01:53:54.608931Z",
"url": "https://files.pythonhosted.org/packages/d6/35/b8473311701e810e8adb9d466eae0d8244842317fbc028daba049a82020e/hcli_hak11-0.1.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9819a6cf423e6b590a8d9520867d3096e25ef21c2fce1973ccaf77ddfec141ae",
"md5": "a3219b4b7d215e1f0a7cec60cca9aaa5",
"sha256": "cd3ae622bd98b464074bd84d56dd2e143aede54127ec2d7906626535a30a4a6d"
},
"downloads": -1,
"filename": "hcli_hak11-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "a3219b4b7d215e1f0a7cec60cca9aaa5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13741,
"upload_time": "2024-09-25T01:53:56",
"upload_time_iso_8601": "2024-09-25T01:53:56.031166Z",
"url": "https://files.pythonhosted.org/packages/98/19/a6cf423e6b590a8d9520867d3096e25ef21c2fce1973ccaf77ddfec141ae/hcli_hak11-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-25 01:53:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cometaj2",
"github_project": "hcli_hak11",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"requirements": [
{
"name": "gpiozero",
"specs": [
[
"==",
"2.0.1"
]
]
}
],
"lcname": "hcli-hak11"
}
