raspberry-gpio-emulator

RPi.GPIO emulator (tested by macOS 10.12)

Docker image

https://hub.docker.com/r/nosix/raspberry-gpio-emulator/

Require

• Python 3.5

Install

$ pip install git+https://github.com/nosix/raspberry-gpio-emulator/

API

import RPi.GPIO as GPIO

GPIO:

• setmode(mode)
  • mode : GPIO.BOARD or GPIO.BCP
• setwarnings(flag)
  • flag : bool
• setup(channel, state, initial, pull_up_down)
  • channel : int or Sequence[int]
  • state : GPIO.OUT or GPIO.IN
  • initial (option) : GPIO.LOW or GPIO.HIGH
  • pull_up_down (option) : GPIO.PUD_OFF, GPIO.PUD_DOWN or GPIO.PUD_UP
• output(channel, outmode)
  • channel : int or Sequence[int]
  • outmode : GPIO.LOW, GPIO.HIGH or Sequence[GPIO.LOW or GPIO.HIGH]
• input(channel) : bool
  • channel : int
• cleanup(channel)
  • channel (option) : int or Sequence[int]
• wait_for_edge(channel, event, timeout) : int or None
  • channel : int
  • event : GPIO.RISING, GPIO.FALLING or GPIO.BOTH
  • timeout (option) : int [millisecond]
• add_event_detect(channel, event, callback, bouncetime)
  • channel : int
  • event : GPIO.RISING, GPIO.FALLING or GPIO.BOTH
  • callback (option) : function(channel)
    • channel : int
  • bouncetime (option) : int [millisecond]
• add_event_callback(channel, callback, bouncetime)
  • channel : int
  • callback : function(channel)
    • channel : int
  • bouncetime (option) : int [millisecond]
• remove_event_detect(channel)
  • channel : int
• event_detected(channel) : bool
  • channel : int
• gpio_function(channel) : GPIO.OUT, GPIO.IN, GPIO.SERIAL, GPIO.SPI, GPIO.I2C or GPIO.HARD_PWM
  • channel : int
• PWM(channel, frequency) : GPIO.PWM
  • channel : int
  • frequency : float [Hz]

GPIO.PWM:

• start(duty_cycle)
  • duty_cycle : float [0.0..100.0]
• stop()
• ChangeFrequency(frequency)
  • frequency : float [Hz]
• ChangeDutyCycle(duty_cycle)
  • duty_cycle : float [0.0..100.0]

Usage

Documentation of raspberry-gpio-python:

• RPi.GPIO module basics
• Outputs
• Inputs
• Check function
• PWM

Sample code:

• sample_board.py
• sample_bcm.py
• sample_input.py
• sample_gpio_function.py
• sample_pwm.py

Custom UI

You can use custom user interface which you wrote. --ui option enable custom user interface. --ui option require user interface module which has create_ui() function.

$ python sample_custom_ui_launcher.py --ui sample_custom_ui

Sample code:

• sample_custom_ui_launcher.py
• sample_custom_ui.py

Plugin

You can use plugins which you wrote. List plugin modules which have create_plugin() function. Plugin observe change event.

$ python sample_plugin.py sample_plugin_a sample_plugin_b

Sample code:

• sample_plugin_launcher.py
• sample_plugin_a.py
• sample_plugin_b.py

Credit

This project based on Pi GPIO Emulator.

• Roderick Vella
• 2016
• Pi GPIO Emulator
• This project uses base design as reference, but it changes usage and implementation.