calcinai/phpi

Event driven bindings for the Raspberry Pi GPIO

Sunday, May 6, 2018
by calcinai
Repository
10 Watchers
72 Stars
336 Installations

PHP
3 Dependents
0 Suggesters
6 Forks
7 Open issues
17 Versions
10 % Grown

The README.md

PHPi

, _(*1)

Event driven bindings for the Raspberry Pi GPIO. Supports A, A+, B, Brev2, B+, 2B, 3B, Compute Module and Pi Zero., _(*2)

This library interacts (almost) directly with the peripheral registers for maximum functionality and speed. See note on mmap/dma, _(*3)

As there is no ability to mmap in PHP, by default, this has been delegated to a python subprocess. The python has been kept to an absolute minimum in terms of complexity to allow flexibility at PHP level., _(*4)

This means that you MUST have python installed alongside PHP for it to function. …sortof, _(*5)

There is also a native PHP extension that is a drop-in replacement for the python subprocess which greatly improves performance. I'd strongly recommend using it, especially with less powerful Pis., _(*6)

This library will function without any kernel drivers/sysfs etc enabled., _(*7)

Setup

Using composer:, _(*8)

composer require calcinai/phpi

Although it is possible to add this to your own autoloader, it's not recommended as you'll have no control of the dependencies. If you haven't used composer before, I strongly recommend you check it out at https://getcomposer.org, _(*9)

Usage

All of this code is designed to be run in cli mode, as root to permit the memory access. It is not recommended to try and run this in a synchronous nature (namely under apache/nginx) as this would introduce stability and security issues. See below for more information about webservices., _(*10)

You can test your install and get a visual display of the pin states by running ./bin/phpi info from the install directory., _(*11)

The board factory:, _(*12)

$board = \Calcinai\PHPi\Factory::create();

Minimal example of reading and setting a pin, _(*13)

use Calcinai\PHPi\Pin\PinFunction;
use Calcinai\PHPi\Pin;

$pin = $board->getPin(17) //BCM pin number
             ->setFunction(PinFunction::INPUT)
             ->setPull(Pin::PULL_UP);

//Will be === to Pin::LEVEL_HIGH or Pin::LEVEL_LOW
var_dump($pin->getLevel());

$pin->setFunction(PinFunction::OUTPUT);
$pin->high();
$pin->low();

Higher level devices and events, _(*14)

$button = new Button($board->getPin(17));
$led = new LED($board->getPin(18));

$button->on('press', [$led, 'on']);
$button->on('release', [$led, 'off']);

$board->getLoop()->run();

GPIO

GPIO (input) is the default mode of the pin objects. Alternate functions can be accessed by using the ->setFunction(PinFunction::x) method. It is recommended to use the function names as opposed to ALT0..5 unless you know exactly what you're doing, as quite a lot are reserved. A few useful classes are also included for digital interaction. With the default python-mmap, you can expect a raw transition speed of ~20kHz, with the native extension, it's more like 80kHz on a Pi 3., _(*15)

PWM

Hardware PWM is supported by this library, and to an extent, so is soft PWM. As this code runs in the react event loop, it's not practical to interact with the ports more than a few hundred times/sec., _(*16)

SPI

SPI is supported along with some device protocols (MPC300x etc). With the default python-mmap, it is limited to about 3kB/s before there is no CPU left! With the native extension, you can reach speeds of over 30kB/s., _(*17)

The event loop

One of the original reasons for basing this project on the react event loop was for the other components that can be leveraged. A good example is the websocket server; it will run seamlessly inline with this library to provide real time, bidirectional, non-polling interaction with the Pi from any modern browser., _(*18)

See phpi-websocket for more on this., _(*19)

External Devices

There are included helper classes for interfacing with common devices, with more added regulary., _(*20)

Generic Inputs/Outputs
Buttons
LEDs
Relays
ADC (MCP 3xxx series)
H Bridge Motors
2 and 4 Phase stepper motors

The Versions

06/05 2018

dev-master

9999999-dev

Event driven bindings for the Raspberry Pi GPIO

library phpi

Event driven bindings for the Raspberry Pi GPIO

calcinai/phpi

The README.md

PHPi

Setup

Usage

GPIO

PWM

SPI

The event loop

External Devices

The Versions

dev-master

The Requires

The Development Requires

by Michael Calcinai

v0.3.3

The Requires

The Development Requires

by Michael Calcinai

v0.3.2

The Requires

The Development Requires

by Michael Calcinai

v0.3.1

The Requires

The Development Requires

by Michael Calcinai

v0.3.0

The Requires

The Development Requires

by Michael Calcinai

0.3.0

The Requires

The Development Requires

by Michael Calcinai

v0.2.3

The Requires

The Development Requires

by Michael Calcinai

v0.2.2

The Requires

The Development Requires

by Michael Calcinai

v0.2.1

The Requires

The Development Requires

by Michael Calcinai

0.2.0

The Requires

by Michael Calcinai

v0.1.6

The Requires

by Michael Calcinai

v0.1.5

The Requires

by Michael Calcinai

v0.1.4

The Requires

by Michael Calcinai

v0.1.3

The Requires

by Michael Calcinai

v0.1.2

The Requires

by Michael Calcinai

v0.1.1

The Requires

by Michael Calcinai

v0.1.0

The Requires

by Michael Calcinai