معرفی شرکت ها
PyDMX-0.1.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A Python module for sending DMX512 data.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | PyDMX-0.1.0 |
| نام | PyDMX |
| نسخه کتابخانه | 0.1.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | - |
| ایمیل نویسنده | Jacob Allen <jacob@polyomino.xyz> |
| آدرس صفحه اصلی | - |
| آدرس اینترنتی | https://pypi.org/project/PyDMX/ |
| مجوز | BSD 3-Clause License Copyright (c) 2019-2022, Jacob Allen All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
# PyDMX
## Introduction
PyDMX is a package capable of sending DMX512 data via a driver. It was created to allow demonstrations on open days of DMX-based projects created at the University of York Department of Computer Science (UoY CS).
The project consists of a core package and a series of optional driver packages for particular hardware and devices.
## DMX512 Protocol
```
Idle | Break |MAB| Slot 0 | Slot 1 |
------\ /---\ /-\ /--------\
| | | | | | |
| | | | | | |
\-------------------/ \--------/ \-/ \--- - - - - - -
```
_Diagram of the start of a DMX packet._
DMX512 (or commonly just DMX) is a relatively simple protocol. The DMX bus is in an Idle high state between packets. A packet starts with a break of 100 μs, followed by a Mark After Break (MAB) of 12 μs, this signifies the start of the frame and the start of the "slots".
```
S 0 1 2 3 4 5 6 7 E E
\ /-\ /---\ /--
| | | | | |
| | | | | |
\-/ \---/ \------/
```
_Diagram of a slot with value 0b10011000 or 152._
Each slot consists of 1 low start bit, 8 data bits, and 2 high stop bits. Each bit of a slot is 4 μs long. This corresponds to a baudrate of 250000 or 250 kbit/s (though due to breaks this is not entirely accurate). There are 512 usable slots (channels) per frame and 513 slots overall. Slot 0 is special as it signifies the type of frame being sent. 0x00 is the normal frame type and corresponds to "standard" lighting data.
A frame can contain any number of slots (beyond the type slot) up to the limit of 513 slots (including type slot). Typically the 512 usable slots are referred to as channels.
The idle period between packets must be at least 92 μs and the MAB must be at least 12 μs. Further a packet must not be longer than 1 second. There are no other requirements on timing, even on inter-slot breaks.
A light will typically take an "address" which is the channel index (starting at 1) which it will listen on. Some lights will use this as a start address and listen on some number of channels above it also if they require more than 8 bits of data.
For example a light might be set to address eight, but listen on channels 8 9, and 10. It could then use each channel as a component of an RGB colour value.
Importantly for writing software relating to DMX, the standard does not specify how to encode different types of data in slots. Therefore, each light manufacturer, or even light, does it differently. There is nothing stopping a manufacturer allowing you to select noncontiguous addresses for each 8 bit value, or any number of more convoluted solutions.
## Core
The core of PyDMX has the following classes:
- DMXUniverse: represents a DMX universe
- DMXInterface: allows simple control of a DMX driver
- DMXLight: abstract base for lights
- DMXLight3Slot: represents a 3 slot RGB light
- DMXLight7Slot: represents a 7 slot RGB moving light
- DMXDriver: represents a DMX output driver
- Drivers are subclasses of this class
- Colour: represents a 24-bit RGB colour value
### Dependencies
The core modules do not depend on any other python modules or external dependencies.
## Drivers
### FTDI
_This project is not affiliated with FTDI._
This driver package can be found at [PyDMX-Drivers-FTDI](https://pypi.org/project/pydmx-drivers-ftdi/).
### Arduino
_This project is not affiliated with Arduino._
This driver package can be found at [PyDMX-Drivers-Arduino](https://pypi.org/project/pydmx-drivers-arduino/).
### Built-in Drivers
#### Debug
The debug interface is designed to output to the terminal the data that would be sent to a interface hardware/drivers. It is also capable of estimating the refresh rate of signals being sent out, though this is effected by platform due to the massively slow terminal output of Windows compared to other platforms.
#### Dummy
The dummy interface does nothing. It's there simply as a placeholder for testing or any other use which does not require an actual interface.
## Usage
Below is a basic example of sending an update to turn a light purple:
```python
from dmx import Colour, DMXInterface, DMXLight3Slot, DMXUniverse
PURPLE = Colour(255, 0, 255)
# Open an interface
with DMXInterface("FT232R") as interface:
# Create a universe
universe = DMXUniverse()
# Define a light
light = DMXLight3Slot(address=8)
# Add the light to a universe
universe.add_light(light)
# Update the interface's frame to be the universe's current state
interface.set_frame(universe.serialise())
# Send an update to the DMX network
interface.send_update()
# Set light to purple
light.set_colour(PURPLE)
# Update the interface's frame to be the universe's current state
interface.set_frame(universe.serialise())
# Send an update to the DMX network
interface.send_update()
```
To run the above example you would need to install the core package `PyDMX` and the FTDI driver package `PyDMX-Drivers-FTDI`.
A further example program is available in the `examples/simple.py` file in the repository root.
## License
This project is licensed under the BSD 3-Clause License. See the LICENSE file for more details.
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7 | Python |
نحوه نصب
نصب پکیج whl PyDMX-0.1.0:
pip install PyDMX-0.1.0.whl
نصب پکیج tar.gz PyDMX-0.1.0:
pip install PyDMX-0.1.0.tar.gz