.. contents::
LCD2USB's Python Library
home: http://github.com/xyb/lcd2usb
PyPI: http://pypi.python.org/pypi/lcd2usb
Introduce
=========
The LCD2USB's Python Library is a Pure-python wrapper for LCD2USB_ which
provide a simple way to control your LCD2USB display device. LCD2USB_ is a
open source/open hardware project to connect HD44780 based text LCD displays
to various PCs via USB.
Usage
=====
Connect a lcd2usb device is easy::
>>> from lcd2usb import LCD
>>> lcd = LCD()
>>> lcd.info()
Found LCD2USB device on bus 004 device 004.
Get lcd2usb firmware version::
>>> lcd.version
(1, 9)
Write something on the screen::
>>> lcd.write('Hello, LCD2USB!')
Clean screen and wirte some on the 2nd row::
>>> lcd.clear()
>>> lcd.goto(0, 1)
>>> lcd.write('Flying with PYTHON')
Or simpler::
>>> lcd.write('Flying with PYTHON', 0, 1)
Define a custom smile symbol and display it on the center of first row
(on a 4x20 display)::
>>> from lcd2usb import SMILE_SYMBOL
>>> lcd.define_char(0, SMILE_SYMBOL)
>>> lcd.write('\0', 9, 0)
That it!
If you need a quickly running test for your device, use this::
python -m lcd2usb
Requirements
============
- Python_ 3 required
- ctypes_ (included in Python)
- libusb-1.0_
- python-libusb1_
Installation
============
Installation is done just as for any other Python library. Using the ``pip`` or ``easy_install`` command from setuptools is the easiest::
pip install lcd2usb
Or::
easy_install install lcd2usb
.. _LCD2USB: http://www.harbaum.org/till/lcd2usb
.. _Python: http://www.python.org/
.. _ctypes: http://python.net/crew/theller/ctypes/
.. _libusb-1.0: http://www.libusb.org/wiki/libusb-1.0
.. _python-libusb1: http://github.com/vpelletier/python-libusb1
Raw data
{
"_id": null,
"home_page": "http://github.com/xyb/lib2usb",
"name": "lcd2usb",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "usb lcd lcd2usb",
"author": "Xie Yanbo",
"author_email": "xieyanbo@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2e/26/6dfe7daf2349fe190cd0a7d999531fca249cb0e25700f1fafeef4f552df1/lcd2usb-1.4.tar.gz",
"platform": "any",
"description": ".. contents::\n\nLCD2USB's Python Library\n\nhome: http://github.com/xyb/lcd2usb\n\nPyPI: http://pypi.python.org/pypi/lcd2usb\n\nIntroduce\n=========\n\nThe LCD2USB's Python Library is a Pure-python wrapper for LCD2USB_ which\nprovide a simple way to control your LCD2USB display device. LCD2USB_ is a\nopen source/open hardware project to connect HD44780 based text LCD displays\nto various PCs via USB.\n\nUsage\n=====\n\nConnect a lcd2usb device is easy::\n\n >>> from lcd2usb import LCD\n >>> lcd = LCD()\n >>> lcd.info()\n Found LCD2USB device on bus 004 device 004.\n\nGet lcd2usb firmware version::\n\n >>> lcd.version\n (1, 9)\n\nWrite something on the screen::\n\n >>> lcd.write('Hello, LCD2USB!')\n\nClean screen and wirte some on the 2nd row::\n\n >>> lcd.clear()\n >>> lcd.goto(0, 1)\n >>> lcd.write('Flying with PYTHON')\n\nOr simpler::\n\n >>> lcd.write('Flying with PYTHON', 0, 1)\n\nDefine a custom smile symbol and display it on the center of first row\n(on a 4x20 display)::\n\n >>> from lcd2usb import SMILE_SYMBOL\n >>> lcd.define_char(0, SMILE_SYMBOL)\n >>> lcd.write('\\0', 9, 0)\n\nThat it!\n\nIf you need a quickly running test for your device, use this::\n\n python -m lcd2usb\n\nRequirements\n============\n\n- Python_ 3 required\n\n- ctypes_ (included in Python)\n\n- libusb-1.0_\n\n- python-libusb1_\n\nInstallation\n============\n\nInstallation is done just as for any other Python library. Using the ``pip`` or ``easy_install`` command from setuptools is the easiest::\n\n pip install lcd2usb\n\nOr::\n\n easy_install install lcd2usb\n\n\n.. _LCD2USB: http://www.harbaum.org/till/lcd2usb\n\n.. _Python: http://www.python.org/\n\n.. _ctypes: http://python.net/crew/theller/ctypes/\n\n.. _libusb-1.0: http://www.libusb.org/wiki/libusb-1.0\n\n.. _python-libusb1: http://github.com/vpelletier/python-libusb1\n",
"bugtrack_url": null,
"license": "New BSD",
"summary": "LCD2USB's Python Library",
"version": "1.4",
"project_urls": {
"Homepage": "http://github.com/xyb/lib2usb"
},
"split_keywords": [
"usb",
"lcd",
"lcd2usb"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f75874ae22b64ee901a09258c0054488b6c9f55d9c723d09382fac547b7df35a",
"md5": "e30f44b18e5ab80971786993b82735a2",
"sha256": "2fdb2700758ce5683b0e021f4cdc4c7a7dd02fa172ec89fcf4de0f28d2b1fbab"
},
"downloads": -1,
"filename": "lcd2usb-1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e30f44b18e5ab80971786993b82735a2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5322,
"upload_time": "2025-01-07T09:38:03",
"upload_time_iso_8601": "2025-01-07T09:38:03.153485Z",
"url": "https://files.pythonhosted.org/packages/f7/58/74ae22b64ee901a09258c0054488b6c9f55d9c723d09382fac547b7df35a/lcd2usb-1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2e266dfe7daf2349fe190cd0a7d999531fca249cb0e25700f1fafeef4f552df1",
"md5": "06ec6a01d472a468a369cc31a25689f0",
"sha256": "c9774b32d6e88989cf621bb7be6a934c73a75b38610863b08519c5ab14e3bf2b"
},
"downloads": -1,
"filename": "lcd2usb-1.4.tar.gz",
"has_sig": false,
"md5_digest": "06ec6a01d472a468a369cc31a25689f0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7715,
"upload_time": "2025-01-07T09:38:04",
"upload_time_iso_8601": "2025-01-07T09:38:04.462331Z",
"url": "https://files.pythonhosted.org/packages/2e/26/6dfe7daf2349fe190cd0a7d999531fca249cb0e25700f1fafeef4f552df1/lcd2usb-1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-07 09:38:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xyb",
"github_project": "lib2usb",
"github_not_found": true,
"lcname": "lcd2usb"
}
JSON
